Imagick::getImagePage

(PECL imagick 2.0.0)

Imagick::getImagePage — Returns the page geometry

Description

array Imagick::getImagePage ( void )

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

Return Values

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

Errors/Exceptions

Throws ImagickException on error.

Коментарии

May 29

Автор: holdoffhunger at gmail dot com


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: holdoffhunger@gmail.com

    

        // 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

)