includes/media/GIF.php

   1 <?php
   2 /**
   3  * Handler for GIF 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 GIF images.
  26  *
  27  * @ingroup Media
  28  */
  29 class GIFHandler extends BitmapHandler {
  30         const BROKEN_FILE = '0'; // value to store in img_metadata if error extracting metadata.
  31
  32         function getMetadata( $image, $filename ) {
  33                 try {
  34                         $parsedGIFMetadata = BitmapMetadataHandler::GIF( $filename );
  35                 } catch ( Exception $e ) {
  36                         // Broken file?
  37                         wfDebug( __METHOD__ . ': ' . $e->getMessage() . "\n" );
  38
  39                         return self::BROKEN_FILE;
  40                 }
  41
  42                 return serialize( $parsedGIFMetadata );
  43         }
  44
  45         /**
  46          * @param $image File
  47          * @return array|bool
  48          */
  49         function formatMetadata( $image ) {
  50                 $meta = $this->getCommonMetaArray( $image );
  51                 if ( count( $meta ) === 0 ) {
  52                         return false;
  53                 }
  54
  55                 return $this->formatMetadataHelper( $meta );
  56         }
  57
  58         /**
  59          * Return the standard metadata elements for #filemetadata parser func.
  60          * @param File $image
  61          * @return array|bool
  62          */
  63         public function getCommonMetaArray( File $image ) {
  64                 $meta = $image->getMetadata();
  65
  66                 if ( !$meta ) {
  67                         return array();
  68                 }
  69                 $meta = unserialize( $meta );
  70                 if ( !isset( $meta['metadata'] ) ) {
  71                         return array();
  72                 }
  73                 unset( $meta['metadata']['_MW_GIF_VERSION'] );
  74
  75                 return $meta['metadata'];
  76         }
  77
  78         /**
  79          * @param $image File
  80          * @todo unittests
  81          * @return bool
  82          */
  83         function getImageArea( $image ) {
  84                 $ser = $image->getMetadata();
  85                 if ( $ser ) {
  86                         $metadata = unserialize( $ser );
  87
  88                         return $image->getWidth() * $image->getHeight() * $metadata['frameCount'];
  89                 } else {
  90                         return $image->getWidth() * $image->getHeight();
  91                 }
  92         }
  93
  94         /**
  95          * @param $image File
  96          * @return bool
  97          */
  98         function isAnimatedImage( $image ) {
  99                 $ser = $image->getMetadata();
 100                 if ( $ser ) {
 101                         $metadata = unserialize( $ser );
 102                         if ( $metadata['frameCount'] > 1 ) {
 103                                 return true;
 104                         }
 105                 }
 106
 107                 return false;
 108         }
 109
 110         /**
 111          * We cannot animate thumbnails that are bigger than a particular size
 112          * @param File $file
 113          * @return bool
 114          */
 115         function canAnimateThumbnail( $file ) {
 116                 global $wgMaxAnimatedGifArea;
 117                 $answer = $this->getImageArea( $file ) <= $wgMaxAnimatedGifArea;
 118
 119                 return $answer;
 120         }
 121
 122         function getMetadataType( $image ) {
 123                 return 'parsed-gif';
 124         }
 125
 126         function isMetadataValid( $image, $metadata ) {
 127                 if ( $metadata === self::BROKEN_FILE ) {
 128                         // Do not repetitivly regenerate metadata on broken file.
 129                         return self::METADATA_GOOD;
 130                 }
 131
 132                 wfSuppressWarnings();
 133                 $data = unserialize( $metadata );
 134                 wfRestoreWarnings();
 135
 136                 if ( !$data || !is_array( $data ) ) {
 137                         wfDebug( __METHOD__ . " invalid GIF metadata\n" );
 138
 139                         return self::METADATA_BAD;
 140                 }
 141
 142                 if ( !isset( $data['metadata']['_MW_GIF_VERSION'] )
 143                         || $data['metadata']['_MW_GIF_VERSION'] != GIFMetadataExtractor::VERSION
 144                 ) {
 145                         wfDebug( __METHOD__ . " old but compatible GIF metadata\n" );
 146
 147                         return self::METADATA_COMPATIBLE;
 148                 }
 149
 150                 return self::METADATA_GOOD;
 151         }
 152
 153         /**
 154          * @param $image File
 155          * @return string
 156          */
 157         function getLongDesc( $image ) {
 158                 global $wgLang;
 159
 160                 $original = parent::getLongDesc( $image );
 161
 162                 wfSuppressWarnings();
 163                 $metadata = unserialize( $image->getMetadata() );
 164                 wfRestoreWarnings();
 165
 166                 if ( !$metadata || $metadata['frameCount'] <= 1 ) {
 167                         return $original;
 168                 }
 169
 170                 /* Preserve original image info string, but strip the last char ')' so we can add even more */
 171                 $info = array();
 172                 $info[] = $original;
 173
 174                 if ( $metadata['looped'] ) {
 175                         $info[] = wfMessage( 'file-info-gif-looped' )->parse();
 176                 }
 177
 178                 if ( $metadata['frameCount'] > 1 ) {
 179                         $info[] = wfMessage( 'file-info-gif-frames' )->numParams( $metadata['frameCount'] )->parse();
 180                 }
 181
 182                 if ( $metadata['duration'] ) {
 183                         $info[] = $wgLang->formatTimePeriod( $metadata['duration'] );
 184                 }
 185
 186                 return $wgLang->commaList( $info );
 187         }
 188 }