3 * Handler for PNG images.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
25 * Handler for PNG images.
29 class PNGHandler
extends BitmapHandler
{
31 const BROKEN_FILE
= '0';
35 * @param string $filename
38 function getMetadata( $image, $filename ) {
40 $metadata = BitmapMetadataHandler
::PNG( $filename );
41 } catch( Exception
$e ) {
43 wfDebug( __METHOD__
. ': ' . $e->getMessage() . "\n" );
44 return self
::BROKEN_FILE
;
47 return serialize($metadata);
54 function formatMetadata( $image ) {
55 $meta = $image->getMetadata();
60 $meta = unserialize( $meta );
61 if ( !isset( $meta['metadata'] ) ||
count( $meta['metadata'] ) <= 1 ) {
65 if ( isset( $meta['metadata']['_MW_PNG_VERSION'] ) ) {
66 unset( $meta['metadata']['_MW_PNG_VERSION'] );
68 return $this->formatMetadataHelper( $meta['metadata'] );
75 function isAnimatedImage( $image ) {
76 $ser = $image->getMetadata();
78 $metadata = unserialize($ser);
79 if( $metadata['frameCount'] > 1 ) return true;
84 function getMetadataType( $image ) {
88 function isMetadataValid( $image, $metadata ) {
90 if ( $metadata === self
::BROKEN_FILE
) {
91 // Do not repetitivly regenerate metadata on broken file.
92 return self
::METADATA_GOOD
;
96 $data = unserialize( $metadata );
99 if ( !$data ||
!is_array( $data ) ) {
100 wfDebug(__METHOD__
. ' invalid png metadata' );
101 return self
::METADATA_BAD
;
104 if ( !isset( $data['metadata']['_MW_PNG_VERSION'] )
105 ||
$data['metadata']['_MW_PNG_VERSION'] != PNGMetadataExtractor
::VERSION
) {
106 wfDebug(__METHOD__
. ' old but compatible png metadata' );
107 return self
::METADATA_COMPATIBLE
;
109 return self
::METADATA_GOOD
;
116 function getLongDesc( $image ) {
118 $original = parent
::getLongDesc( $image );
120 wfSuppressWarnings();
121 $metadata = unserialize($image->getMetadata());
124 if( !$metadata ||
$metadata['frameCount'] <= 0 )
130 if ( $metadata['loopCount'] == 0 ) {
131 $info[] = wfMsgExt( 'file-info-png-looped', 'parseinline' );
132 } elseif ( $metadata['loopCount'] > 1 ) {
133 $info[] = wfMsgExt( 'file-info-png-repeat', 'parseinline', $metadata['loopCount'] );
136 if ( $metadata['frameCount'] > 0 ) {
137 $info[] = wfMsgExt( 'file-info-png-frames', 'parseinline', $metadata['frameCount'] );
140 if ( $metadata['duration'] ) {
141 $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
144 return $wgLang->commaList( $info );