3 * Handler for GIF images.
10 * Handler for GIF images.
14 class GIFHandler
extends BitmapHandler
{
16 const BROKEN_FILE
= '0'; // value to store in img_metadata if error extracting metadata.
18 function getMetadata( $image, $filename ) {
20 $parsedGIFMetadata = BitmapMetadataHandler
::GIF( $filename );
21 } catch( Exception
$e ) {
23 wfDebug( __METHOD__
. ': ' . $e->getMessage() . "\n" );
24 return self
::BROKEN_FILE
;
27 return serialize($parsedGIFMetadata);
34 function formatMetadata( $image ) {
35 $meta = $image->getMetadata();
40 $meta = unserialize( $meta );
41 if ( !isset( $meta['metadata'] ) ||
count( $meta['metadata'] ) <= 1 ) {
45 if ( isset( $meta['metadata']['_MW_GIF_VERSION'] ) ) {
46 unset( $meta['metadata']['_MW_GIF_VERSION'] );
48 return $this->formatMetadataHelper( $meta['metadata'] );
57 function getImageArea( $image, $width, $height ) {
58 $ser = $image->getMetadata();
60 $metadata = unserialize( $ser );
61 return $width * $height * $metadata['frameCount'];
63 return $width * $height;
71 function isAnimatedImage( $image ) {
72 $ser = $image->getMetadata();
74 $metadata = unserialize($ser);
75 if( $metadata['frameCount'] > 1 ) {
82 function getMetadataType( $image ) {
86 function isMetadataValid( $image, $metadata ) {
87 if ( $metadata === self
::BROKEN_FILE
) {
88 // Do not repetitivly regenerate metadata on broken file.
89 return self
::METADATA_GOOD
;
93 $data = unserialize( $metadata );
96 if ( !$data ||
!is_array( $data ) ) {
97 wfDebug(__METHOD__
. ' invalid GIF metadata' );
98 return self
::METADATA_BAD
;
101 if ( !isset( $data['metadata']['_MW_GIF_VERSION'] )
102 ||
$data['metadata']['_MW_GIF_VERSION'] != GIFMetadataExtractor
::VERSION
) {
103 wfDebug(__METHOD__
. ' old but compatible GIF metadata' );
104 return self
::METADATA_COMPATIBLE
;
106 return self
::METADATA_GOOD
;
113 function getLongDesc( $image ) {
116 $original = parent
::getLongDesc( $image );
118 wfSuppressWarnings();
119 $metadata = unserialize($image->getMetadata());
122 if (!$metadata ||
$metadata['frameCount'] <= 1) {
126 /* Preserve original image info string, but strip the last char ')' so we can add even more */
130 if ( $metadata['looped'] ) {
131 $info[] = wfMsgExt( 'file-info-gif-looped', 'parseinline' );
134 if ( $metadata['frameCount'] > 1 ) {
135 $info[] = wfMsgExt( 'file-info-gif-frames', 'parseinline', $metadata['frameCount'] );
138 if ( $metadata['duration'] ) {
139 $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
142 return $wgLang->commaList( $info );