imageresolution

Get or set the resolution of the image

&reftitle.description; ``array``bool```imageresolution` `GdImage` `image` ``int``null```resolution_x`&null; ``int``null```resolution_y`&null;

`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.

&reftitle.parameters;
&gd.image.description;

`resolution_x`

- The horizontal resolution in DPI.

`resolution_y`

- The vertical resolution in DPI.

&reftitle.returnvalues;

When used as getter, it returns an indexed array of the horizontal and vertical resolution on success, &return.falseforfailure;. When used as setter, it returns &true; on success, &return.falseforfailure;.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `resolution_x` and `resolution_y` are now nullable.

&reftitle.examples;

### Setting and getting the resolution of an image

    <?php
    $im = imagecreatetruecolor(100, 100);
    imageresolution($im, 200);
    print_r(imageresolution($im));
    imageresolution($im, 300, 72);
    print_r(imageresolution($im));
    ?>

&example.outputs;

    Array
    (
        [0] => 200
        [1] => 200
    )
    Array
    (
        [0] => 300
        [1] => 72
    )