includes/media/PNG.php

   1 <?php
   2 /**
   3  * Handler for PNG images.
   4  *
   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.
   9  *
  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.
  14  *
  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
  19  *
  20  * @file
  21  * @ingroup Media
  22  */
  23
  24 /**
  25  * Handler for PNG images.
  26  *
  27  * @ingroup Media
  28  */
  29 class PNGHandler extends BitmapHandler {
  30
  31         const BROKEN_FILE = '0';
  32
  33         /**
  34          * @param File $image
  35          * @param string $filename
  36          * @return string
  37          */
  38         function getMetadata( $image, $filename ) {
  39                 try {
  40                         $metadata = BitmapMetadataHandler::PNG( $filename );
  41                 } catch( Exception $e ) {
  42                         // Broken file?
  43                         wfDebug( __METHOD__ . ': ' . $e->getMessage() . "\n" );
  44                         return self::BROKEN_FILE;
  45                 }
  46
  47                 return serialize($metadata);
  48         }
  49
  50         /**
  51          * @param $image File
  52          * @return array|bool
  53          */
  54         function formatMetadata( $image ) {
  55                 $meta = $image->getMetadata();
  56
  57                 if ( !$meta ) {
  58                         return false;
  59                 }
  60                 $meta = unserialize( $meta );
  61                 if ( !isset( $meta['metadata'] ) || count( $meta['metadata'] ) <= 1 ) {
  62                         return false;
  63                 }
  64
  65                 if ( isset( $meta['metadata']['_MW_PNG_VERSION'] ) ) {
  66                         unset( $meta['metadata']['_MW_PNG_VERSION'] );
  67                 }
  68                 return $this->formatMetadataHelper( $meta['metadata'] );
  69         }
  70
  71         /**
  72          * @param $image File
  73          * @return bool
  74          */
  75         function isAnimatedImage( $image ) {
  76                 $ser = $image->getMetadata();
  77                 if ($ser) {
  78                         $metadata = unserialize($ser);
  79                         if( $metadata['frameCount'] > 1 ) return true;
  80                 }
  81                 return false;
  82         }
  83
  84         function getMetadataType( $image ) {
  85                 return 'parsed-png';
  86         }
  87
  88         function isMetadataValid( $image, $metadata ) {
  89
  90                 if ( $metadata === self::BROKEN_FILE ) {
  91                         // Do not repetitivly regenerate metadata on broken file.
  92                         return self::METADATA_GOOD;
  93                 }
  94
  95                 wfSuppressWarnings();
  96                 $data = unserialize( $metadata );
  97                 wfRestoreWarnings();
  98
  99                 if ( !$data || !is_array( $data ) ) {
 100                         wfDebug(__METHOD__ . ' invalid png metadata' );
 101                         return self::METADATA_BAD;
 102                 }
 103
 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;
 108                 }
 109                 return self::METADATA_GOOD;
 110         }
 111
 112         /**
 113          * @param $image File
 114          * @return string
 115          */
 116         function getLongDesc( $image ) {
 117                 global $wgLang;
 118                 $original = parent::getLongDesc( $image );
 119
 120                 wfSuppressWarnings();
 121                 $metadata = unserialize($image->getMetadata());
 122                 wfRestoreWarnings();
 123
 124                 if( !$metadata || $metadata['frameCount'] <= 0 )
 125                         return $original;
 126
 127                 $info = array();
 128                 $info[] = $original;
 129
 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'] );
 134                 }
 135
 136                 if ( $metadata['frameCount'] > 0 ) {
 137                         $info[] = wfMsgExt( 'file-info-png-frames', 'parseinline', $metadata['frameCount'] );
 138                 }
 139
 140                 if ( $metadata['duration'] ) {
 141                         $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
 142                 }
 143
 144                 return $wgLang->commaList( $info );
 145         }
 146
 147 }