Imagick::getQuantumRange

(PECL imagick 2.0.0)

Imagick::getQuantumRangeReturns the Imagick quantum range

说明

array Imagick::getQuantumRange ( void )

Returns the quantum range for the Imagick instance.

返回值

Returns an associative array containing the quantum range as an integer ("quantumRangeLong") and as a string ("quantumRangeString").

错误/异常

错误时抛出 ImagickException。

User Contributed Notes

holdoffhunger at gmail dot com 03-May-2012 06:42
The getQuantumRange is a useful function, since many of the ImageMagick functions accept parameters from 0 to a maximum of the Quantum Range.  When getting a return value for this, it doesn't return a string.  It actually returns an array, with one type being a String ('quantumRangeLong') and the other type being a Long Int ('quantumRangeString').  Here's some sample code and the results, given a color, BMP file photograph that is 600x450 pixels...

<?php

           
// Author: holdoffhunger@gmail.com
   
        // Imagick Type
        // ---------------------------------------------

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

   
$imagick_type->readImageFile($file_handle_for_viewing_image_file);
   
       
// Get Quantum Range
        // ---------------------------------------------
       
   
$imagick_type_quantum_range = $imagick_type->getQuantumRange();
   
       
// Print Results
        // ---------------------------------------------

   
print("<pre>");
   
print_r($imagick_type_quantum_range);
    print(
"</pre>");

?>

Output:

Array
(
    [quantumRangeLong] => 65535
    [quantumRangeString] => 65535
)