Get or set the resolution of the image

imageresolution

(PHP 7 >= 7.2.0, PHP 8)

imageresolutionGet or set the resolution of the image

說明

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

imageresolution() allows to set and get the resolution of an image in DPI (dots per inch). If the optional parameters are null, the current resolution is returned as an indexed array. If only resolution_x is not null, the horizontal and vertical resolution are set to this value. If none of the optional parameters are null, the horizontal and vertical resolution are set to these values, respectively.

The resolution is only used as meta information when images are read from and written to formats supporting this kind of information (curently PNG and JPEG). It does not affect any drawing operations. The default resolution for new images is 96 DPI.

參數

image

由圖像建立函式(例如imagecreatetruecolor())返回的 GdImage 對象。

resolution_x

The horizontal resolution in DPI.

resolution_y

The vertical resolution in DPI.

返回值

When used as getter, it returns an indexed array of the horizontal and vertical resolution on success, 或者在失敗時返回 false. When used as setter, it returns true on success, 或者在失敗時返回 false.

更新日誌

版本 說明
8.0.0 resolution_x and resolution_y are now nullable.

範例

示例 #1 Setting and getting the resolution of an image

<?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
)

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *