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 = $this->getCommonMetaArray( $image );
56 if ( count( $meta ) === 0 ) {
60 return $this->formatMetadataHelper( $meta );
64 * Get a file type independent array of metadata.
67 * @return array The metadata array
69 public function getCommonMetaArray( File
$image ) {
70 $meta = $image->getMetadata();
75 $meta = unserialize( $meta );
76 if ( !isset( $meta['metadata'] ) ) {
79 unset( $meta['metadata']['_MW_PNG_VERSION'] );
80 return $meta['metadata'];
87 function isAnimatedImage( $image ) {
88 $ser = $image->getMetadata();
90 $metadata = unserialize( $ser );
91 if ( $metadata['frameCount'] > 1 ) {
98 * We do not support making APNG thumbnails, so always false
102 function canAnimateThumbnail( $image ) {
106 function getMetadataType( $image ) {
110 function isMetadataValid( $image, $metadata ) {
112 if ( $metadata === self
::BROKEN_FILE
) {
113 // Do not repetitivly regenerate metadata on broken file.
114 return self
::METADATA_GOOD
;
117 wfSuppressWarnings();
118 $data = unserialize( $metadata );
121 if ( !$data ||
!is_array( $data ) ) {
122 wfDebug( __METHOD__
. " invalid png metadata\n" );
123 return self
::METADATA_BAD
;
126 if ( !isset( $data['metadata']['_MW_PNG_VERSION'] )
127 ||
$data['metadata']['_MW_PNG_VERSION'] != PNGMetadataExtractor
::VERSION
) {
128 wfDebug( __METHOD__
. " old but compatible png metadata\n" );
129 return self
::METADATA_COMPATIBLE
;
131 return self
::METADATA_GOOD
;
138 function getLongDesc( $image ) {
140 $original = parent
::getLongDesc( $image );
142 wfSuppressWarnings();
143 $metadata = unserialize( $image->getMetadata() );
146 if ( !$metadata ||
$metadata['frameCount'] <= 0 ) {
153 if ( $metadata['loopCount'] == 0 ) {
154 $info[] = wfMessage( 'file-info-png-looped' )->parse();
155 } elseif ( $metadata['loopCount'] > 1 ) {
156 $info[] = wfMessage( 'file-info-png-repeat' )->numParams( $metadata['loopCount'] )->parse();
159 if ( $metadata['frameCount'] > 0 ) {
160 $info[] = wfMessage( 'file-info-png-frames' )->numParams( $metadata['frameCount'] )->parse();
163 if ( $metadata['duration'] ) {
164 $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
167 return $wgLang->commaList( $info );