Zeta Components - high quality PHP components

This class scans the specified image file and leaves the information available through the public property ezcImageAnalyzer::$data. The information available depends on the handlers used by the ezcImageAnalyzer and the type of image you select. In case the ezcImageAnalyzer does not find a suitable handler to analyze an image, it will throw a ezcImageAnalyzerFileNotProcessableException.

In this package the following handlers are available (in their priority order):

• ezcImageAnalyzerImagemagickHandler, which uses the ImageMagick binary "identify" to collect information about an image.
• ezcImageAnalyzerPhpHandler, which relies on the GD extension and is capable of using the exif extension to determine additional data.

A simple example.

1.  // Analyzation of the MIME type is done during creation.
2.  $image = new ezcImageAnalyzer( dirname( __FILE__ ).'/toby.jpg' );
3.  
4.  if ( $image->mime == 'image/tiff' || $image->mime == 'image/jpeg' )
5.  {
6.       // Analyzation of further image data is done during access of the data
7.       echo 'Photo taken on '.date( 'Y/m/d, H:i', $image->data->date ).".\n";
8.  }
9.  elseif ( $mime !== false )
10.  {
11.       echo "Format was detected as {$mime}.\n";
12.  }
13.  else
14.  {
15.       echo "Unknown photo format.\n";
16.  }

If you want to manipulate the handlers used by ezcImageAnalyzer, you can do this globally like this:

1.  // Retreive the predefined handler classes
2.  $originalHandlers = ezcImageAnalyzer::getHandlerClasses();
3.  foreach ( $handlerClasses as $id => $handlerClass )
4.  {
5.       // Unset the ezcImageAnalyzerPhpHandler (do not use that anymore!)
6.       if ( $handlerClass === 'ezcImageAnalyzerPhpHandler' )
7.       {
8.           unset( $handlerClasses[$id] );
9.       }
10.  }
11.  // Set the new collection of handler classes.
12.  ezcImageAnalyzer::setHandlerClasses( $handlerClasses );
13.  
14.  // Somewhere else in the code... This now tries to use your handler in the
15.  // first place
16.  $image = new ezcImageAnalyzer( '/var/cache/images/toby.jpg' );

Or you can define your own handler classes to be used (beware, those must either be already loaded or load automatically on access).

1.  // Define your onw handler class to be used in the first place and fall back on
2.  // ImageMagick, if necessary.
3.  $handlerClasses = array( 'MyOwnHandlerClass', 'ezcImageAnalyzerImagemagickHandler' );
4.  ezcImageAnalyzer::setHandlerClasses( $handlerClasses );
5.  
6.  // Somewehre else in the code... This now tries to use your handler in the
7.  // first place
8.  $image = new ezcImageAnalyzer( '/var/cache/images/toby.jpg' );

This method returns an array of available handler classes. The array is indexed by the handler names, which are assigned to an array of options set for this handler.

Sets the available handlers. The array submitted must be indexed by the handler classes names (attention: handler classes must extend ezcImageAnalyzerHandler), assigned to an array of options for this handler. Most handlers don't have any options. Which options a handler may accept depends on the handler implementation.

This method triggers a handler to analyze the given image file for more data.

This method triggers a handler to analyze the MIME type of the given image file.

This method checks all registered handler classes for if the they are available (using ezcImageAnalyzerHandler::isAvailable()).