imageresolution

(PHP 7 >= 7.2.0, PHP 8)

imageresolution画像の解像度を取得/設定する

説明

imageresolution(GdImage $image, ?int $resolution_x = null, ?int $resolution_y = null): array|bool

imageresolution() 関数は、 画像の解像度を DPI(dots per inch) 単位で取得/設定します。 オプションのパラメータが null だった場合は、 現在の解像度を配列で返します。 resolution_x だけが null でない場合、 垂直/水平方向の解像度がこの値に設定されます。 オプションのパラメータが両方指定されると、 垂直/水平方向の解像度がそれぞれ指定された値に設定されます。

この手の情報をサポートしている画像フォーマットを読み書きする場合(現状、PNG と JPEG)に、 解像度情報はメタ情報としてのみ使われます。画像を描画する操作には一切影響しません。 新しい画像の解像度は 96DPI です。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

resolution_x

水平方向の解像度をDPI単位で指定します。

resolution_y

垂直方向の解像度をDPI単位で指定します。

戻り値

getter として使う場合、 水平方向と垂直方向の解像度を成功時には返します。 失敗した場合に false を返します。 setter として使う場合、 成功時には true を返し、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.0.0 resolution_xresolution_y は、nullable になりました。

例1 画像の解像度を取得/設定する

<?php
$im 
imagecreatetruecolor(100100);
imageresolution($im200);
print_r(imageresolution($im));
imageresolution($im30072);
print_r(imageresolution($im));
?>

上の例の出力は以下となります。

Array
(
    [0] => 200
    [1] => 200
)
Array
(
    [0] => 300
    [1] => 72
)
関連キーワード:  解像度, 画像, 設定, 取得, 方向, DPI, 水平, 垂直, パラメータ, 単位