Imagick::getImagePage

(PECL imagick 2, PECL imagick 3)

Imagick::getImagePageReturns the page geometry

说明

public Imagick::getImagePage ( ) : array

Returns the page geometry associated with the image in an array with the keys "width", "height", "x", and "y".

参数

此函数没有参数。

返回值

Returns the page geometry associated with the image in an array with the keys "width", "height", "x", and "y".

错误/异常

错误时抛出 ImagickException。

User Contributed Notes

holdoffhunger at gmail dot com 28-May-2012 10:53
The PHP function 'getImagePage' will return values indicating the height and width of an image, just like the getHeight and getWidth, except these values are returned as an array.  There's also two other values returned in the array with the key values of 'x' and 'y'.  After running this function on animated .Gif's, super-compressed jpeg's, bmp's, png's, and every type of awkward file format you could think of, I kept getting back the result of '0' for both the 'x' and 'y' associated values in the returned array.  It's likely that these indicate the "start-positions" of the width and height, compared to the "end-values" you receive for accessing the values associated with the keys 'width' and 'height'.

Oddly enough, the PHP function 'getPage' will return an array with the same exact keys, except the values all default to '0', making it much less useful than the function 'getImagePage'.

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 Page
        // ---------------------------------------------
       
   
$image_page = $imagick_type->getImagePage();
   
       
// Print Iteration Value Interpreted
        // ---------------------------------------------

   
print_r($image_page);

?>

Expected Result :

Array
(
    [width] => 600
    [height] => 450
    [x] => 0
    [y] => 0
)