includes/media/PNG.php

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