Imagick::getImageUnits

(PECL imagick 2, PECL imagick 3)

Imagick::getImageUnits获取图像的分辨率单位

说明

Imagick::getImageUnits ( ) : int

获取图像的分辨率单位。

返回值

返回分辨率的单位

错误/异常

错误时抛出 ImagickException。

User Contributed Notes

Victor 25-Apr-2018 09:06
Here's an example of how to interpret and use ImageResolution and ImageUnits:

$i = new Imagick('some_image_file.png');

$r = $i->getImageResolution();
$u = $i->getImageUnits();
if ($u == Imagick::RESOLUTION_PIXELSPERCENTIMETER) {
   $r[x] = (int)round($r[x] * 2.54);
   $r[y] = (int)round($r[y] * 2.54);
   $i->setImageUnits(Imagick::RESOLUTION_PIXELSPERINCH);
   $i->setImageResolution($r[x], $r[y]);

  //note that the number type is double again
   $r = $i->getImageResolution();
}
holdoffhunger at gmail dot com 22-Jun-2012 02:15
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." http://www.imagemagick.org/RMagick/doc/rvgclip.html

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 :

<?php

           
// Author: [email protected]
   
        // 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
        // ---------------------------------------------

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

   
switch($image_units)
    {
        case
imagick::PATHUNITS_UNDEFINED:
           
$image_units_printable = "Undefined";
            break;
           
        case
imagick::PATHUNITS_USERSPACE:
           
$image_units_printable = "User Space";
            break;
           
        case
imagick::PATHUNITS_USERSPACEONUSE:
           
$image_units_printable = "User Space On Use";
            break;
           
        case
imagick::PATHUNITS_OBJECTBOUNDINGBOX:
           
$image_units_printable = "Object Bounding Box";
            break;
    }
   
       
// Print Units Value
        // ---------------------------------------------

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

?>