PHP | Gmagick setimageunits() Function

The Gmagick::setimageunits() function is an inbuilt function in PHP which is used to set the units of resolution of a particular image. This function has no visual impact on the image but just changes the units of resolution which can be one of Undefinedresolution, PixelsPerInchResolution, or PixelsPerCentimeterResolution.

Syntax:

Gmagick Gmagick::setimageunits( int $resolution )

Parameters: This function accepts a single parameter $resolution which holds an integer corresponding to one of the RESOLUTION constants.

List of all RESOLUTION constants are given below:

• Gmagick::RESOLUTION_UNDEFINED (0)
• Gmagick::RESOLUTION_PIXELSPERINCH (1)
• Gmagick::RESOLUTION_PIXELSPERCENTIMETER (2)

Return Value: This function returns a Gmagick object on success.

Exceptions: This function throws GmagickException on error.

Below given programs illustrate the Gmagick::setimageunits() function in PHP:

Used Image:

Program 1:

<?php

// Create a new Gmagick object
$gmagick = new Gmagick('geeksforgeeks.png');

// Set the image units
$gmagick->setImageUnits(Gmagick::RESOLUTION_PIXELSPERCENTIMETER);

// Get the image units
$units = $gmagick->getimageunits();
echo $units;
?>

Output:

2  // Which corresponds to Gmagick::RESOLUTION_PIXELSPERCENTIMETER

Program 2:

<?php

// Create a new Gmagick object
$gmagick = new Gmagick('geeksforgeeks.png');

// Set the image units
$gmagick->setImageUnits(Gmagick::RESOLUTION_PIXELSPERINCH);

// Display the image using new units
header("Content-Type: image/png");
echo $gmagick;
?>

Output:

Reference: https://www.php.net/manual/en/gmagick.setimageunits.php