CakeFest 2017 NYC, the Official CakePHP Conference


(PECL imagick 2.0.0)

Imagick::getImageUnitsGets the image units of resolution


int Imagick::getImageUnits ( void )

Gets the image units of resolution.

Valor Retornado

Returns the image units of resolution.


Lança ImagickException em caso de erro.

add a note add a note

User Contributed Notes 1 note

holdoffhunger at gmail dot com
4 years ago
By using the PHP function for getImageUnits, you get back an integer representing the evaluation of a predefined, PATHUNITS constant of the ImageMagick package.  You only have four values for this.  They look like "imagick::PATHUNITS_UNDEFINED", with _VALUE value's being: undefined, userspace, userspaceonuse, and objectboundingbox.  Undefined, if printed, is a 0, userspace is a 1, userspaceonuse is a 2, and objectboundingbox is a 3.

What's the use of knowing the Clipping Path Unit default for an image?  According to the Wikipedia article for "Clipping Path", a Clipping Path is "a closed vector path, or shape, used to cut out a 2D image in image editing software. Anything inside the path will be included after the clipping path is applied; anything outside the path will be omitted from the output."

The official ImageMagick documentation provides only two valid values coming into or out of the clipping path unit value, one being userSpaceOnUse and the other being ObjectBoundingBox.  The only definitions provided: "If userSpaceOnUse, the contents of the clipping path represent values in the current user coordinate system in place at the time when the clipping path is referenced. if objectBoundingBox, then the user coordinate system for the contents of the clipping path is established using the bounding box of the object to which the clipping path is applied. The default is userSpaceOnUse."

In personal experimentation, all JPEG and GIF files have provided '0' for "Undefined" on this function, and all BMP and PNG files have provided '2' for "UserSpaceOnUse" on this function.

And some sample code :


// Author:
        // Imagick Type
        // ---------------------------------------------

$imagick_type = new Imagick();
// Open File
        // ---------------------------------------------
$file_to_grab = "image_workshop_directory/test.gif";
$file_handle_for_viewing_image_file = fopen($file_to_grab, 'a+');
// Grab File
        // ---------------------------------------------

// Get Image Units
        // ---------------------------------------------
$image_page = $imagick_type->getImageUnits();
// Interpret Units Value
        // ---------------------------------------------

$image_units_printable = "Undefined";
$image_units_printable = "User Space";
$image_units_printable = "User Space On Use";
$image_units_printable = "Object Bounding Box";
// Print Units Value
        // ---------------------------------------------

print(" Image Units: # $image_units -- $image_units_printable .");

To Top