説明
array wp_constrain_dimensions( int $current_width, int $current_height [ , int $max_width = 0 [ , int $max_height = 0 ] ] )
縦横比を維持した縮小サイズを取得する。
パラメータ
- $current_width現在のイメージの幅を指定。
- $current_height現在のイメージの高さを指定。
- $max_width縮小時の最大幅を指定(省略時は0)。
- $max_height縮小時の最大高を指定(省略時は0)。
返り値
縮小した幅と高さを格納した配列を返す。注意
幅を基準に縮小する場合は$max_widthに基準となる幅を指定し、高さを基準に縮小する場合は$max_widthに0を、$max_heightに基準となる高さを指定する。なお縮小イメージを計算するのが目的のため、現在のイメージサイズよりも大きくなるような指定は無効になり、$current_widthと$current_heightの値を格納した配列が返る。
使用例
- 幅1024、高さ768を幅200に合わせて縮小したサイズを取得する。<?php $size = wp_constrain_dimensions( 1024, 768, 200 ); ?>
- 幅1024、高さ768を高さ200に合わせて縮小したサイズを取得する。<?php $size = wp_constrain_dimensions( 1024, 768, 0, 200 ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/media.php最終更新 : 2016年08月17日 15:31
関連
お勧め
パスとURL(2011年10月6日 更新)
テーマやプラグインで、WordPressシステム関連のディレクトリやURLを使う時があり、それらの多くは関数や定数として定義されている。今回は、それらの関数や定数について整理していく。ブロックエディターの文字サイズ設定を変えてみる(2019年12月12日 更新)
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
5.5で非推奨になる関数名について(2020年8月12日 更新)
来月にリリースされるWordPress 5.5に向けてBeta 1、2と公開が続いている。「WordPress 5.5 Beta 2(以降Beta 2)」のソースコードを見ていくと、いくつかの関数が非推奨になるようだ。
KUSANAGIでマルチサイト(サブドメイン)を試した(2019年8月6日 更新)
本サイトはサブディレクトリタイプのマルチサイト機能を採用して構築しているが、これまでサブドメインタイプは利用した経験はない。マルチサイト機能のサブドメインタイプは以前から1度は試してみたいと思っており、今回実際にサイトを構築してみた。
LevelとCapability(2018年5月27日 更新)
プラグインやテーマの管理ページを作成する際など、ユーザのレベルと権限を確認することがある。ここでは、権限グループ別のレベルと権限の有無を整理してみた。