3 * Handler for PNG images.
10 * Handler for PNG images.
14 class PNGHandler
extends BitmapHandler
{
16 const BROKEN_FILE
= '0';
20 * @param string $filename
23 function getMetadata( $image, $filename ) {
25 $metadata = BitmapMetadataHandler
::PNG( $filename );
26 } catch( Exception
$e ) {
28 wfDebug( __METHOD__
. ': ' . $e->getMessage() . "\n" );
29 return self
::BROKEN_FILE
;
32 return serialize($metadata);
35 function formatMetadata( $image ) {
36 $meta = $image->getMetadata();
41 $meta = unserialize( $meta );
42 if ( !isset( $meta['metadata'] ) ||
count( $meta['metadata'] ) <= 1 ) {
46 if ( isset( $meta['metadata']['_MW_PNG_VERSION'] ) ) {
47 unset( $meta['metadata']['_MW_PNG_VERSION'] );
49 return $this->formatMetadataHelper( $meta['metadata'] );
56 function isAnimatedImage( $image ) {
57 $ser = $image->getMetadata();
59 $metadata = unserialize($ser);
60 if( $metadata['frameCount'] > 1 ) return true;
65 function getMetadataType( $image ) {
69 function isMetadataValid( $image, $metadata ) {
71 if ( $metadata === self
::BROKEN_FILE
) {
72 // Do not repetitivly regenerate metadata on broken file.
73 return self
::METADATA_GOOD
;
77 $data = unserialize( $metadata );
80 if ( !$data ||
!is_array( $data ) ) {
81 wfDebug(__METHOD__
. ' invalid png metadata' );
82 return self
::METADATA_BAD
;
85 if ( !isset( $data['metadata']['_MW_PNG_VERSION'] )
86 ||
$data['metadata']['_MW_PNG_VERSION'] != PNGMetadataExtractor
::VERSION
) {
87 wfDebug(__METHOD__
. ' old but compatible png metadata' );
88 return self
::METADATA_COMPATIBLE
;
90 return self
::METADATA_GOOD
;
97 function getLongDesc( $image ) {
99 $original = parent
::getLongDesc( $image );
101 wfSuppressWarnings();
102 $metadata = unserialize($image->getMetadata());
105 if( !$metadata ||
$metadata['frameCount'] <= 0 )
111 if ( $metadata['loopCount'] == 0 ) {
112 $info[] = wfMsgExt( 'file-info-png-looped', 'parseinline' );
113 } elseif ( $metadata['loopCount'] > 1 ) {
114 $info[] = wfMsgExt( 'file-info-png-repeat', 'parseinline', $metadata['loopCount'] );
117 if ( $metadata['frameCount'] > 0 ) {
118 $info[] = wfMsgExt( 'file-info-png-frames', 'parseinline', $metadata['frameCount'] );
121 if ( $metadata['duration'] ) {
122 $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
125 return $wgLang->commaList( $info );