includes/Exif.php

   1 <?php
   2 if (defined('MEDIAWIKI')) {
   3 /**
   4  * @package MediaWiki
   5  * @subpackage Metadata
   6  *
   7  * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
   8  * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
   9  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License along
  22  * with this program; if not, write to the Free Software Foundation, Inc.,
  23  * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  24  * http://www.gnu.org/copyleft/gpl.html
  25  *
  26  * @link http://exif.org/Exif2-2.PDF The Exif 2.2 specification
  27  * @bug 1555, 1947
  28  */
  29
  30 /**#@+
  31  * Exif tag type definition
  32  */
  33 define('MW_EXIF_BYTE', 1);              # An 8-bit unsigned integer.
  34 define('MW_EXIF_ASCII', 2);             # An 8-bit byte containing one 7-bit ASCII code. The final byte is terminated with NULL.
  35 define('MW_EXIF_SHORT', 3);             # A 16-bit (2-byte) unsigned integer.
  36 define('MW_EXIF_LONG', 4);              # A 32-bit (4-byte) unsigned integer.
  37 define('MW_EXIF_RATIONAL', 5);          # Two LONGs. The first LONG is the numerator and the second LONG expresses the denominator
  38 define('MW_EXIF_UNDEFINED', 7);         # An 8-bit byte that can take any value depending on the field definition
  39 define('MW_EXIF_SLONG', 9);             # A 32-bit (4-byte) signed integer (2's complement notation),
  40 define('MW_EXIF_SRATIONAL', 10);        # Two SLONGs. The first SLONG is the numerator and the second SLONG is the denominator.
  41 /**#@-*/
  42
  43
  44 /**
  45  * @package MediaWiki
  46  * @subpackage Metadata
  47  */
  48 class Exif {
  49         /**#@+
  50          * @var array
  51          */
  52
  53         /**
  54          * Exif tags grouped by category, the tagname itself is the key and the type
  55          * is the value, in the case of more than one possible value type they are
  56          * seperated by commas.
  57          *
  58          * @access private
  59          */
  60         var $mExif;
  61
  62         /**
  63          * A one dimentional array of all Exif tags
  64          */
  65         var $mFlatExif;
  66
  67         /**
  68          * A one dimentional array of all Exif tags that we'd want to save in
  69          * the database or present on a page.
  70          */
  71         var $mValidExif;
  72
  73         /**#@-*/
  74
  75         /**
  76          * Constructor
  77          */
  78         function Exif() {
  79                 /**
  80                  * Page numbers here refer to pages in the EXIF 2.2 standard
  81                  *
  82                  * @link http://exif.org/Exif2-2.PDF The Exif 2.2 specification
  83                  */
  84                 $this->mExif = array(
  85                         # TIFF Rev. 6.0 Attribute Information (p22)
  86                         'tiff' => array(
  87                                 # Tags relating to image structure
  88                                 'structure' => array(
  89                                         'ImageWidth' => MW_EXIF_SHORT.','.MW_EXIF_LONG,         # Image width
  90                                         'ImageLength' => MW_EXIF_SHORT.','.MW_EXIF_LONG,        # Image height
  91                                         'BitsPerSample' => MW_EXIF_SHORT,               # Number of bits per component
  92                                         # "When a primary image is JPEG compressed, this designation is not"
  93                                         # "necessary and is omitted." (p23)
  94                                         'Compression' => MW_EXIF_SHORT,                 # Compression scheme #p23
  95                                         'PhotometricInterpretation' => MW_EXIF_SHORT,   # Pixel composition #p23
  96                                         'Orientation' => MW_EXIF_SHORT,                 # Orientation of image #p24
  97                                         'SamplesPerPixel' => MW_EXIF_SHORT,             # Number of components
  98                                         'PlanarConfiguration' => MW_EXIF_SHORT,         # Image data arrangement #p24
  99                                         'YCbCrSubSampling' => MW_EXIF_SHORT,            # Subsampling ratio of Y to C #p24
 100                                         'YCbCrPositioning' => MW_EXIF_SHORT,            # Y and C positioning #p24-25
 101                                         'XResolution' => MW_EXIF_RATIONAL,              # Image resolution in width direction
 102                                         'YResolution' => MW_EXIF_RATIONAL,              # Image resolution in height direction
 103                                         'ResolutionUnit' => MW_EXIF_SHORT,              # Unit of X and Y resolution #(p26)
 104                                 ),
 105
 106                                 # Tags relating to recording offset
 107                                 'offset' => array(
 108                                         'StripOffsets' => MW_EXIF_SHORT.','.MW_EXIF_LONG,                       # Image data location
 109                                         'RowsPerStrip' => MW_EXIF_SHORT.','.MW_EXIF_LONG,                       # Number of rows per strip
 110                                         'StripByteCounts' => MW_EXIF_SHORT.','.MW_EXIF_LONG,                    # Bytes per compressed strip
 111                                         'JPEGInterchangeFormat' => MW_EXIF_SHORT.','.MW_EXIF_LONG,              # Offset to JPEG SOI
 112                                         'JPEGInterchangeFormatLength' => MW_EXIF_SHORT.','.MW_EXIF_LONG,        # Bytes of JPEG data
 113                                 ),
 114
 115                                 # Tags relating to image data characteristics
 116                                 'characteristics' => array(
 117                                         'TransferFunction' => MW_EXIF_SHORT,            # Transfer function
 118                                         'WhitePoint' => MW_EXIF_RATIONAL,               # White point chromaticity
 119                                         'PrimaryChromaticities' => MW_EXIF_RATIONAL,    # Chromaticities of primarities
 120                                         'YCbCrCoefficients' => MW_EXIF_RATIONAL,        # Color space transformation matrix coefficients #p27
 121                                         'ReferenceBlackWhite' => MW_EXIF_RATIONAL       # Pair of black and white reference values
 122                                 ),
 123
 124                                 # Other tags
 125                                 'other' => array(
 126                                         'DateTime' => MW_EXIF_ASCII,            # File change date and time
 127                                         'ImageDescription' => MW_EXIF_ASCII,    # Image title
 128                                         'Make' => MW_EXIF_ASCII,                # Image input equipment manufacturer
 129                                         'Model' => MW_EXIF_ASCII,               # Image input equipment model
 130                                         'Software' => MW_EXIF_ASCII,            # Software used
 131                                         'Artist' => MW_EXIF_ASCII,              # Person who created the image
 132                                         'Copyright' => MW_EXIF_ASCII,           # Copyright holder
 133                                 ),
 134                         ),
 135
 136                         # Exif IFD Attribute Information (p30-31)
 137                         'exif' => array(
 138                                 # Tags relating to version
 139                                 'version' => array(
 140                                         # TODO: NOTE: Nonexistence of this field is taken to mean nonconformance
 141                                         # to the EXIF 2.1 AND 2.2 standards
 142                                         'ExifVersion' => MW_EXIF_UNDEFINED,     # Exif version
 143                                         'FlashpixVersion' => MW_EXIF_UNDEFINED, # Supported Flashpix version #p32
 144                                 ),
 145
 146                                 # Tags relating to Image Data Characteristics
 147                                 'characteristics' => array(
 148                                         'ColorSpace' => MW_EXIF_SHORT,          # Color space information #p32
 149                                 ),
 150
 151                                 # Tags relating to image configuration
 152                                 'configuration' => array(
 153                                         'ComponentsConfiguration' => MW_EXIF_UNDEFINED,         # Meaning of each component #p33
 154                                         'CompressedBitsPerPixel' => MW_EXIF_RATIONAL,           # Image compression mode
 155                                         'PixelYDimension' => MW_EXIF_SHORT.','.MW_EXIF_LONG,            # Valid image width
 156                                         'PixelXDimension' => MW_EXIF_SHORT.','.MW_EXIF_LONG,            # Valind image height
 157                                 ),
 158
 159                                 # Tags relating to related user information
 160                                 'user' => array(
 161                                         'MakerNote' => MW_EXIF_UNDEFINED,                       # Manufacturer notes
 162                                         'UserComment' => MW_EXIF_UNDEFINED,                     # User comments #p34
 163                                 ),
 164
 165                                 # Tags relating to related file information
 166                                 'related' => array(
 167                                         'RelatedSoundFile' => MW_EXIF_ASCII,                    # Related audio file
 168                                 ),
 169
 170                                 # Tags relating to date and time
 171                                 'dateandtime' => array(
 172                                         'DateTimeOriginal' => MW_EXIF_ASCII,                    # Date and time of original data generation #p36
 173                                         'DateTimeDigitized' => MW_EXIF_ASCII,                   # Date and time of original data generation
 174                                         'SubSecTime' => MW_EXIF_ASCII,                          # DateTime subseconds
 175                                         'SubSecTimeOriginal' => MW_EXIF_ASCII,                  # DateTimeOriginal subseconds
 176                                         'SubSecTimeDigitized' => MW_EXIF_ASCII,                 # DateTimeDigitized subseconds
 177                                 ),
 178
 179                                 # Tags relating to picture-taking conditions (p31)
 180                                 'conditions' => array(
 181                                         'ExposureTime' => MW_EXIF_RATIONAL,                     # Exposure time
 182                                         'FNumber' => MW_EXIF_RATIONAL,                          # F Number
 183                                         'ExposureProgram' => MW_EXIF_SHORT,                     # Exposure Program #p38
 184                                         'SpectralSensitivity' => MW_EXIF_ASCII,                 # Spectral sensitivity
 185                                         'ISOSpeedRatings' => MW_EXIF_SHORT,                     # ISO speed rating
 186                                         'OECF' => MW_EXIF_UNDEFINED,                            # Optoelectronic conversion factor
 187                                         'ShutterSpeedValue' => MW_EXIF_SRATIONAL,               # Shutter speed
 188                                         'ApertureValue' => MW_EXIF_RATIONAL,                    # Aperture
 189                                         'BrightnessValue' => MW_EXIF_SRATIONAL,                 # Brightness
 190                                         'ExposureBiasValue' => MW_EXIF_SRATIONAL,               # Exposure bias
 191                                         'MaxApertureValue' => MW_EXIF_RATIONAL,                 # Maximum land aperture
 192                                         'SubjectDistance' => MW_EXIF_RATIONAL,                  # Subject distance
 193                                         'MeteringMode' => MW_EXIF_SHORT,                        # Metering mode #p40
 194                                         'LightSource' => MW_EXIF_SHORT,                         # Light source #p40-41
 195                                         'Flash' => MW_EXIF_SHORT,                               # Flash #p41-42
 196                                         'FocalLength' => MW_EXIF_RATIONAL,                      # Lens focal length
 197                                         'SubjectArea' => MW_EXIF_SHORT,                         # Subject area
 198                                         'FlashEnergy' => MW_EXIF_RATIONAL,                      # Flash energy
 199                                         'SpatialFrequencyResponse' => MW_EXIF_UNDEFINED,        # Spatial frequency response
 200                                         'FocalPlaneXResolution' => MW_EXIF_RATIONAL,            # Focal plane X resolution
 201                                         'FocalPlaneYResolution' => MW_EXIF_RATIONAL,            # Focal plane Y resolution
 202                                         'FocalPlaneResolutionUnit' => MW_EXIF_SHORT,            # Focal plane resolution unit
 203                                         'SubjectLocation' => MW_EXIF_SHORT,                     # Subject location
 204                                         'ExposureIndex' => MW_EXIF_RATIONAL,                    # Exposure index
 205                                         'SensingMethod' => MW_EXIF_SHORT,                       # Sensing method #p46
 206                                         'FileSource' => MW_EXIF_UNDEFINED,                      # File source #p47
 207                                         'SceneType' => MW_EXIF_UNDEFINED,                       # Scene type #p47
 208                                         'CFAPattern' => MW_EXIF_UNDEFINED,                      # CFA pattern
 209                                         'CustomRendered' => MW_EXIF_SHORT,                      # Custom image processing #p48
 210                                         'ExposureMode' => MW_EXIF_SHORT,                        # Exposure mode #p48
 211                                         'WhiteBalance' => MW_EXIF_SHORT,                        # White Balance #p49
 212                                         'DigitalZoomRatio' => MW_EXIF_RATIONAL,                 # Digital zoom ration
 213                                         'FocalLengthIn35mmFilm' => MW_EXIF_SHORT,               # Focal length in 35 mm film
 214                                         'SceneCaptureType' => MW_EXIF_SHORT,                    # Scene capture type #p49
 215                                         'GainControl' => MW_EXIF_RATIONAL,                      # Scene control #p49-50
 216                                         'Contrast' => MW_EXIF_SHORT,                            # Contrast #p50
 217                                         'Saturation' => MW_EXIF_SHORT,                          # Saturation #p50
 218                                         'Sharpness' => MW_EXIF_SHORT,                           # Sharpness #p50
 219                                         'DeviceSettingDescription' => MW_EXIF_UNDEFINED,        # Desice settings description
 220                                         'SubjectDistanceRange' => MW_EXIF_SHORT,                # Subject distance range #p51
 221                                 ),
 222
 223                                 'other' => array(
 224                                         'ImageUniqueID' => MW_EXIF_ASCII,       # Unique image ID
 225                                 ),
 226                         ),
 227
 228                         # GPS Attribute Information (p52)
 229                         'gps' => array(
 230                                 'GPSVersionID' => MW_EXIF_BYTE,                 # GPS tag version
 231                                 'GPSLatitudeRef' => MW_EXIF_ASCII,              # North or South Latitude #p52-53
 232                                 'GPSLatitude' => MW_EXIF_RATIONAL,              # Latitude
 233                                 'GPSLongitudeRef' => MW_EXIF_ASCII,             # East or West Longitude #p53
 234                                 'GPSLongitude' => MW_EXIF_RATIONAL,             # Longitude
 235                                 'GPSAltitudeRef' => MW_EXIF_BYTE,               # Altitude reference
 236                                 'GPSAltitude' => MW_EXIF_RATIONAL,              # Altitude
 237                                 'GPSTimeStamp' => MW_EXIF_RATIONAL,             # GPS time (atomic clock)
 238                                 'GPSSatellites' => MW_EXIF_ASCII,               # Satellites used for measurement
 239                                 'GPSStatus' => MW_EXIF_ASCII,                   # Receiver status #p54
 240                                 'GPSMeasureMode' => MW_EXIF_ASCII,              # Measurement mode #p54-55
 241                                 'GPSDOP' => MW_EXIF_RATIONAL,                   # Measurement precision
 242                                 'GPSSpeedRef' => MW_EXIF_ASCII,                 # Speed unit #p55
 243                                 'GPSSpeed' => MW_EXIF_RATIONAL,                 # Speed of GPS receiver
 244                                 'GPSTrackRef' => MW_EXIF_ASCII,                 # Reference for direction of movement #p55
 245                                 'GPSTrack' => MW_EXIF_RATIONAL,                 # Direction of movement
 246                                 'GPSImgDirectionRef' => MW_EXIF_ASCII,          # Reference for direction of image #p56
 247                                 'GPSImgDirection' => MW_EXIF_RATIONAL,          # Direction of image
 248                                 'GPSMapDatum' => MW_EXIF_ASCII,                 # Geodetic survey data used
 249                                 'GPSDestLatitudeRef' => MW_EXIF_ASCII,          # Reference for latitude of destination #p56
 250                                 'GPSDestLatitude' => MW_EXIF_RATIONAL,          # Latitude destination
 251                                 'GPSDestLongitudeRef' => MW_EXIF_ASCII,         # Reference for longitude of destination #p57
 252                                 'GPSDestLongitude' => MW_EXIF_RATIONAL,         # Longitude of destination
 253                                 'GPSDestBearingRef' => MW_EXIF_ASCII,           # Reference for bearing of destination #p57
 254                                 'GPSDestBearing' => MW_EXIF_RATIONAL,           # Bearing of destination
 255                                 'GPSDestDistanceRef' => MW_EXIF_ASCII,          # Reference for distance to destination #p57-58
 256                                 'GPSDestDistance' => MW_EXIF_RATIONAL,          # Distance to destination
 257                                 'GPSProcessingMethod' => MW_EXIF_UNDEFINED,     # Name of GPS processing method
 258                                 'GPSAreaInformation' => MW_EXIF_UNDEFINED,      # Name of GPS area
 259                                 'GPSDateStamp' => MW_EXIF_ASCII,                # GPS date
 260                                 'GPSDifferential' => MW_EXIF_SHORT,             # GPS differential correction
 261                         ),
 262                 );
 263
 264                 $this->makeFlatExifTags();
 265                 $this->makeValidExifTags();
 266         }
 267
 268         /**
 269          * Get the raw list of exiftags
 270          *
 271          * @access private
 272          * @return array
 273         */
 274         function getExif() {
 275                 return $this->mExif;
 276         }
 277
 278         /**
 279          * Generate a flat list of the exif tags
 280          */
 281         function makeFlatExifTags() {
 282                 $exif = $this->getExif();
 283                 $this->extractTags( $exif );
 284         }
 285
 286         /**
 287          * A recursing extractor function used by makeFlatExifTags()
 288          */
 289         function extractTags( $tagset ) {
 290                 foreach( $tagset as $key => $val ) {
 291                         if( is_array( $val ) ) {
 292                                 $this->extractTags( $val );
 293                         } else {
 294                                 $this->mFlatExif[$key] = $val;
 295                         }
 296                 }
 297         }
 298
 299         /**
 300          * Produce a list of all Exif tags appropriate for user output
 301          *
 302          * Produce a list of all tags that we want to show in output, in order not to
 303          * output binary gibberish such as raw thumbnails we strip all tags
 304          * with the datatype of UNDEFINED.
 305          *
 306          * @todo We might actually want to display some of the UNDEFINED
 307          *       stuff, but we strip it for now.
 308          */
 309         function makeValidExifTags() {
 310                 foreach( $this->mFlatExif as $key => $val ) {
 311                         if( strpos( $val, (string)MW_EXIF_UNDEFINED ) !== false ) {
 312                                 continue;
 313                         }
 314                         $this->mValidExif[] = $key;
 315                 }
 316         }
 317
 318          /**
 319           * The version of the output format
 320           *
 321           * Before the actual metadata information is saved in the database we
 322           * strip some of it since we don't want to save things like thumbnails
 323           * which usually accompany Exif data. This value gets saved in the
 324           * database along with the actual Exif data, and if the version in the
 325           * database doesn't equal the value returned by this function the Exif
 326           * data is regenerated.
 327           *
 328           * @return int
 329           */
 330         function version() {
 331                 return 1; // We don't need no bloddy constants!
 332         }
 333
 334         /**#@+
 335          * Validates if a tag value is of the type it should be according to the Exif spec
 336          *
 337          * @param mixed $in The input value to check
 338          * @return bool
 339          */
 340         function isByte( $in ) {
 341                 return is_numeric( $in ) && $in >= 0 && $in <= 255;
 342         }
 343
 344         function isASCII( $in ) {
 345                 return true; // TODO: FIXME
 346         }
 347
 348         function isShort( $in ) {
 349                 return is_numeric( $in ) && $in >= 0 && $in <= 65536;
 350         }
 351
 352         function isLong( $in ) {
 353                 return is_numeric( $in ) && $in >= 0 && $in <= 4294967296;
 354
 355         }
 356
 357         function isRational( $in ) {
 358                 $in = explode( '/', $in, 2 );
 359                 return $this->isLong( $in[0] ) && $this->isLong( $in[1] );
 360         }
 361
 362         function isUndefined( $in ) {
 363                 return true;
 364         }
 365
 366         function isSlong( $in ) {
 367                 return $this->isLong( abs( $in ) );
 368         }
 369
 370         function isSrational( $in ) {
 371                 $in = explode( '/', $in, 2 );
 372                 return $this->isSlong( $in[0] ) && $this->isSlong( $in[1] );
 373         }
 374         /**#@-*/
 375
 376         /**
 377          * Validates if a tag has a legal value according to the Exif spec, presumes
 378          * that the given tag is valid ( has been checked in advance with
 379          * $this->mValidExif )
 380          *
 381          * @param string $tag The tag to check
 382          * @param mixed  $val The value of the tag
 383          * @return bool
 384          */
 385         function validate( $tag, $val ) {
 386                 // Fucks up if not typecast
 387                 switch( (string)$this->mFlatExif[$tag] ) {
 388                         case (string)MW_EXIF_BYTE:
 389                                 return $this->isByte( $val );
 390                         case (string)MW_EXIF_ASCII:
 391                                 return $this->isASCII( $val );
 392                         case (string)MW_EXIF_SHORT:
 393                                 return $this->isShort( $val );
 394                         case (string)MW_EXIF_LONG:
 395                                 return $this->isLong( $val );
 396                         case (string)MW_EXIF_RATIONAL:
 397                                 return $this->isRational( $val );
 398                         case (string)MW_EXIF_UNDEFINED:
 399                                 return $this->isUndefined( $val );
 400                         case (string)MW_EXIF_SLONG:
 401                                 return $this->isSlong( $val );
 402                         case (string)MW_EXIF_SRATIONAL:
 403                                 return $this->isSrational( $val );
 404                         case (string)MW_EXIF_SHORT.','.MW_EXIF_LONG:
 405                                 return $this->isShort( $val ) || $this->isLong( $val );
 406                         default:
 407                                 wfDebug( "Exif: The tag \"$tag\" had an invalid value: \"$val\"\n" );
 408                                 return false;
 409                 }
 410         }
 411
 412         /**
 413          * Numbers given by Exif user agents are often magical, that is they
 414          * should be replaced by a detailed explanation depending on their
 415          * value which most of the time are plain integers. This function
 416          * formats Exif values into human readable form.
 417          *
 418          * @param string $tag The tag to be formatted
 419          * @param mixed  $val The value of the tag
 420          * @return string
 421          */
 422         function format( $tag, $val ) {
 423                 global $wgLang;
 424
 425                 switch( $tag ) {
 426                 case 'Compression':
 427                         switch( $val ) {
 428                         case 1: case 6:
 429                                 return $this->msg( $tag, $val );
 430                         }
 431
 432                 case 'PhotometricInterpretation':
 433                         switch( $val ) {
 434                         case 2: case 6:
 435                                 return $this->msg( $tag, $val );
 436                         }
 437
 438                 case 'Orientation':
 439                         switch( $val ) {
 440                         case 1: case 2: case 3: case 4: case 5: case 6: case 7: case 8:
 441                                 return $this->msg( $tag, $val );
 442                         }
 443
 444                 // TODO: If this field does not exist use 1
 445                 case 'PlanarConfiguration':
 446                         switch( $val ) {
 447                         case 1: case 2:
 448                                 return $this->msg( $tag, $val );
 449                         }
 450
 451                 // TODO: YCbCrSubSampling
 452                 // TODO: YCbCrPositioning
 453                 // TODO: If this field does not exists use 2
 454                 case 'ResolutionUnit': #p26
 455                         switch( $val ) {
 456                         case 2: case 3:
 457                                 return $this->msg( $tag, $val );
 458                         }
 459
 460                 // TODO: YCbCrCoefficients  #p27 (see annex E)
 461                 case 'ExifVersion': case 'FlashpixVersion':
 462                         return "$val"/100;
 463
 464                 case 'ColorSpace':
 465                         switch( $val ) {
 466                         case 1: case 'FFFF.H':
 467                                 return $this->msg( $tag, $val );
 468                         }
 469
 470                 case 'ComponentsConfiguration':
 471                         switch( $val ) {
 472                         case 0: case 1: case 2: case 3: case 4: case 5: case 6:
 473                                 return $this->msg( $tag, $val );
 474                         }
 475
 476                 case 'DateTime':
 477                 case 'DateTimeOriginal':
 478                 case 'DateTimeDigitized':
 479                         return $wgLang->timeanddate( wfTimestamp(TS_MW, $val) );
 480
 481                 case 'ExposureProgram':
 482                         switch( $val ) {
 483                         case 0: case 1: case 2: case 3: case 4: case 5: case 6: case 7: case 8:
 484                                 return $this->msg( $tag, $val );
 485                         }
 486                 case 'MeteringMode':
 487                         switch( $val ) {
 488                         case 0: case 1: case 2: case 3: case 4: case 5: case 6: case 7: case 255:
 489                                 return $this->msg( $tag, $val );
 490                         }
 491                 case 'LightSource':
 492                         switch( $val ) {
 493                         case 0: case 1: case 2: case 3: case 4: case 9: case 10: case 11:
 494                         case 12: case 13: case 14: case 15: case 17: case 18: case 19: case 20:
 495                         case 21: case 22: case 23: case 24: case 255:
 496                                 return $this->msg( $tag, $val );
 497                         }
 498                 // TODO: Flash
 499                 case 'SensingMethod':
 500                         switch( $val ) {
 501                         case 1: case 2: case 3: case 4: case 5: case 7: case 8:
 502                                 return $this->msg( $tag, $val );
 503                         }
 504                 case 'FileSource':
 505                         switch( $val ) {
 506                         case 3:
 507                                 return $this->msg( $tag, $val );
 508                         }
 509                 case 'SceneType':
 510                         switch( $val ) {
 511                         case 1:
 512                                 return $this->msg( $tag, $val );
 513                         }
 514                 case 'CustomRendered':
 515                         switch( $val ) {
 516                         case 0: case 1:
 517                                 return $this->msg( $tag, $val );
 518                         }
 519                 case 'ExposureMode':
 520                         switch( $val ) {
 521                         case 0: case 1: case 2:
 522                                 return $this->msg( $tag, $val );
 523                         }
 524                 case 'WhiteBalance':
 525                         switch( $val ) {
 526                         case 0: case 1:
 527                                 return $this->msg( $tag, $val );
 528                         }
 529                 case 'SceneCaptureType':
 530                         switch( $val ) {
 531                         case 0: case 1: case 2: case 3:
 532                                 return $this->msg( $tag, $val );
 533                         }
 534                 case 'GainControl':
 535                         switch( $val ) {
 536                         case 0: case 1: case 2: case 3: case 4:
 537                                 return $this->msg( $tag, $val );
 538                         }
 539                 case 'Contrast':
 540                         switch( $val ) {
 541                         case 0: case 1: case 2:
 542                                 return $this->msg( $tag, $val );
 543                         }
 544                 case 'Saturation':
 545                         switch( $val ) {
 546                         case 0: case 1: case 2:
 547                                 return $this->msg( $tag, $val );
 548                         }
 549                 case 'Sharpness':
 550                         switch( $val ) {
 551                         case 0: case 1: case 2:
 552                                 return $this->msg( $tag, $val );
 553                         }
 554                 case 'SubjectDistanceRange':
 555                         switch( $val ) {
 556                         case 0: case 1: case 2: case 3:
 557                                 return $this->msg( $tag, $val );
 558                         }
 559                 case 'GPSLatitudeRef':
 560                         switch( $val ) {
 561                         case 'N': case 'S':
 562                                 return $this->msg( $tag, $val );
 563                         }
 564                 case 'GPSLongitudeRef':
 565                         switch( $val ) {
 566                         case 'E': case 'W':
 567                                 return $this->msg( $tag, $val );
 568                         }
 569                 case 'GPSStatus':
 570                         switch( $val ) {
 571                         case 'A': case 'V':
 572                                 return $this->msg( $tag, $val );
 573                         }
 574                 case 'GPSMeasureMode':
 575                         switch( $val ) {
 576                         case 2: case 3:
 577                                 return $this->msg( $tag, $val );
 578                         }
 579                 case 'GPSSpeedRef':
 580                         switch( $val ) {
 581                         case 'K': case 'M': case 'N':
 582                                 return $this->msg( $tag, $val );
 583                         }
 584                 case 'GPSTrackRef':
 585                         switch( $val ) {
 586                         case 'T': case 'M':
 587                                 return $this->msg( $tag, $val );
 588                         }
 589                 case 'GPSImgDirectionRef':
 590                         switch( $val ) {
 591                         case 'T': case 'M':
 592                                 return $this->msg( $tag, $val );
 593                         }
 594                 case 'GPSDestLatitudeRef':
 595                         switch( $val ) {
 596                         case 'N': case 'S':
 597                                 return $this->msg( $tag, $val );
 598                         }
 599                 case 'GPSDestLongitudeRef':
 600                         switch( $val ) {
 601                         case 'E': case 'W':
 602                                 return $this->msg( $tag, $val );
 603                         }
 604                 case 'GPSDestBearingRef':
 605                         switch( $val ) {
 606                         case 'T': case 'M':
 607                                 return $this->msg( $tag, $val );
 608                         }
 609                 case 'GPSDateStamp':
 610                         return $wgLang->date( substr( $val, 0, 4 ) . substr( $val, 5, 2 ) . substr( $val, 8, 2 ) . '000000' );
 611
 612                 // This is not in the Exif standard, just a special
 613                 // case for our purposes which enables wikis to wikify
 614                 // the make and model to write articles about them.
 615                 case 'Make': case 'Model':
 616                         return wfMsg( strtolower( "exif-$tag-value" ), $val );
 617                 default:
 618                         return $val;
 619                 }
 620         }
 621
 622         /**
 623          * Conviniance function for format()
 624          *
 625          * @param string $tag The tag name to pass on
 626          * @param string $val The value of the tag
 627          * @return string A wfMsg of "exif-$tag-$val" in lower case
 628          */
 629         function msg( $tag, $val ) {
 630                 return wfMsg( strtolower("exif-$tag-$val") );
 631         }
 632 }
 633
 634 } // MEDIAWIKI