Mercurial > public > madeira

annotate photologue/utils/EXIF.py @ 163:7fc4123fef70

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Stop passing callable to queryset. This is now deprecated. The usage here was most likely a mistake that has worked all these years. This change was for upgrading to Django 1.7.
author Brian Neal <bgneal@gmail.com>
date Thu, 02 Apr 2015 19:17:47 -0500
parents e2868ad47a1e
children
rev   line source
bgneal@1 1 #!/usr/bin/env python
bgneal@1 2 # -*- coding: utf-8 -*-
bgneal@1 3 #
bgneal@1 4 # Library to extract EXIF information from digital camera image files
bgneal@1 5 # http://sourceforge.net/projects/exif-py/
bgneal@1 6 #
bgneal@1 7 # VERSION 1.0.7
bgneal@1 8 #
bgneal@1 9 # To use this library call with:
bgneal@1 10 # f = open(path_name, 'rb')
bgneal@1 11 # tags = EXIF.process_file(f)
bgneal@1 12 #
bgneal@1 13 # To ignore makerNote tags, pass the -q or --quick
bgneal@1 14 # command line arguments, or as
bgneal@1 15 # f = open(path_name, 'rb')
bgneal@1 16 # tags = EXIF.process_file(f, details=False)
bgneal@1 17 #
bgneal@1 18 # To stop processing after a certain tag is retrieved,
bgneal@1 19 # pass the -t TAG or --stop-tag TAG argument, or as
bgneal@1 20 # f = open(path_name, 'rb')
bgneal@1 21 # tags = EXIF.process_file(f, stop_tag='TAG')
bgneal@1 22 #
bgneal@1 23 # where TAG is a valid tag name, ex 'DateTimeOriginal'
bgneal@1 24 #
bgneal@1 25 # These are useful when you are retrieving a large list of images
bgneal@1 26 #
bgneal@1 27 # Returned tags will be a dictionary mapping names of EXIF tags to their
bgneal@1 28 # values in the file named by path_name. You can process the tags
bgneal@1 29 # as you wish. In particular, you can iterate through all the tags with:
bgneal@1 30 # for tag in tags.keys():
bgneal@1 31 # if tag not in ('JPEGThumbnail', 'TIFFThumbnail', 'Filename',
bgneal@1 32 # 'EXIF MakerNote'):
bgneal@1 33 # print "Key: %s, value %s" % (tag, tags[tag])
bgneal@1 34 # (This code uses the if statement to avoid printing out a few of the
bgneal@1 35 # tags that tend to be long or boring.)
bgneal@1 36 #
bgneal@1 37 # The tags dictionary will include keys for all of the usual EXIF
bgneal@1 38 # tags, and will also include keys for Makernotes used by some
bgneal@1 39 # cameras, for which we have a good specification.
bgneal@1 40 #
bgneal@1 41 # Note that the dictionary keys are the IFD name followed by the
bgneal@1 42 # tag name. For example:
bgneal@1 43 # 'EXIF DateTimeOriginal', 'Image Orientation', 'MakerNote FocusMode'
bgneal@1 44 #
bgneal@1 45 # Copyright (c) 2002-2007 Gene Cash All rights reserved
bgneal@1 46 # Copyright (c) 2007 Ianaré Sévi All rights reserved
bgneal@1 47 #
bgneal@1 48 # Redistribution and use in source and binary forms, with or without
bgneal@1 49 # modification, are permitted provided that the following conditions
bgneal@1 50 # are met:
bgneal@1 51 #
bgneal@1 52 # 1. Redistributions of source code must retain the above copyright
bgneal@1 53 # notice, this list of conditions and the following disclaimer.
bgneal@1 54 #
bgneal@1 55 # 2. Redistributions in binary form must reproduce the above
bgneal@1 56 # copyright notice, this list of conditions and the following
bgneal@1 57 # disclaimer in the documentation and/or other materials provided
bgneal@1 58 # with the distribution.
bgneal@1 59 #
bgneal@1 60 # 3. Neither the name of the authors nor the names of its contributors
bgneal@1 61 # may be used to endorse or promote products derived from this
bgneal@1 62 # software without specific prior written permission.
bgneal@1 63 #
bgneal@1 64 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
bgneal@1 65 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
bgneal@1 66 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
bgneal@1 67 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
bgneal@1 68 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
bgneal@1 69 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
bgneal@1 70 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
bgneal@1 71 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
bgneal@1 72 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
bgneal@1 73 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bgneal@1 74 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bgneal@1 75 #
bgneal@1 76 #
bgneal@1 77 # ----- See 'changes.txt' file for all contributors and changes ----- #
bgneal@1 78 #
bgneal@1 79
bgneal@1 80
bgneal@1 81 # Don't throw an exception when given an out of range character.
bgneal@1 82 def make_string(seq):
bgneal@1 83 str = ""
bgneal@1 84 for c in seq:
bgneal@1 85 # Screen out non-printing characters
bgneal@1 86 if 32 <= c and c < 256:
bgneal@1 87 str += chr(c)
bgneal@1 88 # If no printing chars
bgneal@1 89 if not str:
bgneal@1 90 return seq
bgneal@1 91 return str
bgneal@1 92
bgneal@1 93 # Special version to deal with the code in the first 8 bytes of a user comment.
bgneal@1 94 def make_string_uc(seq):
bgneal@1 95 code = seq[0:8]
bgneal@1 96 seq = seq[8:]
bgneal@1 97 # Of course, this is only correct if ASCII, and the standard explicitly
bgneal@1 98 # allows JIS and Unicode.
bgneal@1 99 return make_string(seq)
bgneal@1 100
bgneal@1 101 # field type descriptions as (length, abbreviation, full name) tuples
bgneal@1 102 FIELD_TYPES = (
bgneal@1 103 (0, 'X', 'Proprietary'), # no such type
bgneal@1 104 (1, 'B', 'Byte'),
bgneal@1 105 (1, 'A', 'ASCII'),
bgneal@1 106 (2, 'S', 'Short'),
bgneal@1 107 (4, 'L', 'Long'),
bgneal@1 108 (8, 'R', 'Ratio'),
bgneal@1 109 (1, 'SB', 'Signed Byte'),
bgneal@1 110 (1, 'U', 'Undefined'),
bgneal@1 111 (2, 'SS', 'Signed Short'),
bgneal@1 112 (4, 'SL', 'Signed Long'),
bgneal@1 113 (8, 'SR', 'Signed Ratio'),
bgneal@1 114 )
bgneal@1 115
bgneal@1 116 # dictionary of main EXIF tag names
bgneal@1 117 # first element of tuple is tag name, optional second element is
bgneal@1 118 # another dictionary giving names to values
bgneal@1 119 EXIF_TAGS = {
bgneal@1 120 0x0100: ('ImageWidth', ),
bgneal@1 121 0x0101: ('ImageLength', ),
bgneal@1 122 0x0102: ('BitsPerSample', ),
bgneal@1 123 0x0103: ('Compression',
bgneal@1 124 {1: 'Uncompressed TIFF',
bgneal@1 125 6: 'JPEG Compressed'}),
bgneal@1 126 0x0106: ('PhotometricInterpretation', ),
bgneal@1 127 0x010A: ('FillOrder', ),
bgneal@1 128 0x010D: ('DocumentName', ),
bgneal@1 129 0x010E: ('ImageDescription', ),
bgneal@1 130 0x010F: ('Make', ),
bgneal@1 131 0x0110: ('Model', ),
bgneal@1 132 0x0111: ('StripOffsets', ),
bgneal@1 133 0x0112: ('Orientation',
bgneal@1 134 {1: 'Horizontal (normal)',
bgneal@1 135 2: 'Mirrored horizontal',
bgneal@1 136 3: 'Rotated 180',
bgneal@1 137 4: 'Mirrored vertical',
bgneal@1 138 5: 'Mirrored horizontal then rotated 90 CCW',
bgneal@1 139 6: 'Rotated 90 CW',
bgneal@1 140 7: 'Mirrored horizontal then rotated 90 CW',
bgneal@1 141 8: 'Rotated 90 CCW'}),
bgneal@1 142 0x0115: ('SamplesPerPixel', ),
bgneal@1 143 0x0116: ('RowsPerStrip', ),
bgneal@1 144 0x0117: ('StripByteCounts', ),
bgneal@1 145 0x011A: ('XResolution', ),
bgneal@1 146 0x011B: ('YResolution', ),
bgneal@1 147 0x011C: ('PlanarConfiguration', ),
bgneal@1 148 0x0128: ('ResolutionUnit',
bgneal@1 149 {1: 'Not Absolute',
bgneal@1 150 2: 'Pixels/Inch',
bgneal@1 151 3: 'Pixels/Centimeter'}),
bgneal@1 152 0x012D: ('TransferFunction', ),
bgneal@1 153 0x0131: ('Software', ),
bgneal@1 154 0x0132: ('DateTime', ),
bgneal@1 155 0x013B: ('Artist', ),
bgneal@1 156 0x013E: ('WhitePoint', ),
bgneal@1 157 0x013F: ('PrimaryChromaticities', ),
bgneal@1 158 0x0156: ('TransferRange', ),
bgneal@1 159 0x0200: ('JPEGProc', ),
bgneal@1 160 0x0201: ('JPEGInterchangeFormat', ),
bgneal@1 161 0x0202: ('JPEGInterchangeFormatLength', ),
bgneal@1 162 0x0211: ('YCbCrCoefficients', ),
bgneal@1 163 0x0212: ('YCbCrSubSampling', ),
bgneal@1 164 0x0213: ('YCbCrPositioning', ),
bgneal@1 165 0x0214: ('ReferenceBlackWhite', ),
bgneal@1 166 0x828D: ('CFARepeatPatternDim', ),
bgneal@1 167 0x828E: ('CFAPattern', ),
bgneal@1 168 0x828F: ('BatteryLevel', ),
bgneal@1 169 0x8298: ('Copyright', ),
bgneal@1 170 0x829A: ('ExposureTime', ),
bgneal@1 171 0x829D: ('FNumber', ),
bgneal@1 172 0x83BB: ('IPTC/NAA', ),
bgneal@1 173 0x8769: ('ExifOffset', ),
bgneal@1 174 0x8773: ('InterColorProfile', ),
bgneal@1 175 0x8822: ('ExposureProgram',
bgneal@1 176 {0: 'Unidentified',
bgneal@1 177 1: 'Manual',
bgneal@1 178 2: 'Program Normal',
bgneal@1 179 3: 'Aperture Priority',
bgneal@1 180 4: 'Shutter Priority',
bgneal@1 181 5: 'Program Creative',
bgneal@1 182 6: 'Program Action',
bgneal@1 183 7: 'Portrait Mode',
bgneal@1 184 8: 'Landscape Mode'}),
bgneal@1 185 0x8824: ('SpectralSensitivity', ),
bgneal@1 186 0x8825: ('GPSInfo', ),
bgneal@1 187 0x8827: ('ISOSpeedRatings', ),
bgneal@1 188 0x8828: ('OECF', ),
bgneal@1 189 # print as string
bgneal@1 190 0x9000: ('ExifVersion', make_string),
bgneal@1 191 0x9003: ('DateTimeOriginal', ),
bgneal@1 192 0x9004: ('DateTimeDigitized', ),
bgneal@1 193 0x9101: ('ComponentsConfiguration',
bgneal@1 194 {0: '',
bgneal@1 195 1: 'Y',
bgneal@1 196 2: 'Cb',
bgneal@1 197 3: 'Cr',
bgneal@1 198 4: 'Red',
bgneal@1 199 5: 'Green',
bgneal@1 200 6: 'Blue'}),
bgneal@1 201 0x9102: ('CompressedBitsPerPixel', ),
bgneal@1 202 0x9201: ('ShutterSpeedValue', ),
bgneal@1 203 0x9202: ('ApertureValue', ),
bgneal@1 204 0x9203: ('BrightnessValue', ),
bgneal@1 205 0x9204: ('ExposureBiasValue', ),
bgneal@1 206 0x9205: ('MaxApertureValue', ),
bgneal@1 207 0x9206: ('SubjectDistance', ),
bgneal@1 208 0x9207: ('MeteringMode',
bgneal@1 209 {0: 'Unidentified',
bgneal@1 210 1: 'Average',
bgneal@1 211 2: 'CenterWeightedAverage',
bgneal@1 212 3: 'Spot',
bgneal@1 213 4: 'MultiSpot'}),
bgneal@1 214 0x9208: ('LightSource',
bgneal@1 215 {0: 'Unknown',
bgneal@1 216 1: 'Daylight',
bgneal@1 217 2: 'Fluorescent',
bgneal@1 218 3: 'Tungsten',
bgneal@1 219 10: 'Flash',
bgneal@1 220 17: 'Standard Light A',
bgneal@1 221 18: 'Standard Light B',
bgneal@1 222 19: 'Standard Light C',
bgneal@1 223 20: 'D55',
bgneal@1 224 21: 'D65',
bgneal@1 225 22: 'D75',
bgneal@1 226 255: 'Other'}),
bgneal@1 227 0x9209: ('Flash', {0: 'No',
bgneal@1 228 1: 'Fired',
bgneal@1 229 5: 'Fired (?)', # no return sensed
bgneal@1 230 7: 'Fired (!)', # return sensed
bgneal@1 231 9: 'Fill Fired',
bgneal@1 232 13: 'Fill Fired (?)',
bgneal@1 233 15: 'Fill Fired (!)',
bgneal@1 234 16: 'Off',
bgneal@1 235 24: 'Auto Off',
bgneal@1 236 25: 'Auto Fired',
bgneal@1 237 29: 'Auto Fired (?)',
bgneal@1 238 31: 'Auto Fired (!)',
bgneal@1 239 32: 'Not Available'}),
bgneal@1 240 0x920A: ('FocalLength', ),
bgneal@1 241 0x9214: ('SubjectArea', ),
bgneal@1 242 0x927C: ('MakerNote', ),
bgneal@1 243 # print as string
bgneal@1 244 0x9286: ('UserComment', make_string_uc), # First 8 bytes gives coding system e.g. ASCII vs. JIS vs Unicode
bgneal@1 245 0x9290: ('SubSecTime', ),
bgneal@1 246 0x9291: ('SubSecTimeOriginal', ),
bgneal@1 247 0x9292: ('SubSecTimeDigitized', ),
bgneal@1 248 # print as string
bgneal@1 249 0xA000: ('FlashPixVersion', make_string),
bgneal@1 250 0xA001: ('ColorSpace', ),
bgneal@1 251 0xA002: ('ExifImageWidth', ),
bgneal@1 252 0xA003: ('ExifImageLength', ),
bgneal@1 253 0xA005: ('InteroperabilityOffset', ),
bgneal@1 254 0xA20B: ('FlashEnergy', ), # 0x920B in TIFF/EP
bgneal@1 255 0xA20C: ('SpatialFrequencyResponse', ), # 0x920C - -
bgneal@1 256 0xA20E: ('FocalPlaneXResolution', ), # 0x920E - -
bgneal@1 257 0xA20F: ('FocalPlaneYResolution', ), # 0x920F - -
bgneal@1 258 0xA210: ('FocalPlaneResolutionUnit', ), # 0x9210 - -
bgneal@1 259 0xA214: ('SubjectLocation', ), # 0x9214 - -
bgneal@1 260 0xA215: ('ExposureIndex', ), # 0x9215 - -
bgneal@1 261 0xA217: ('SensingMethod', ), # 0x9217 - -
bgneal@1 262 0xA300: ('FileSource',
bgneal@1 263 {3: 'Digital Camera'}),
bgneal@1 264 0xA301: ('SceneType',
bgneal@1 265 {1: 'Directly Photographed'}),
bgneal@1 266 0xA302: ('CVAPattern', ),
bgneal@1 267 0xA401: ('CustomRendered', ),
bgneal@1 268 0xA402: ('ExposureMode',
bgneal@1 269 {0: 'Auto Exposure',
bgneal@1 270 1: 'Manual Exposure',
bgneal@1 271 2: 'Auto Bracket'}),
bgneal@1 272 0xA403: ('WhiteBalance',
bgneal@1 273 {0: 'Auto',
bgneal@1 274 1: 'Manual'}),
bgneal@1 275 0xA404: ('DigitalZoomRatio', ),
bgneal@1 276 0xA405: ('FocalLengthIn35mm', ),
bgneal@1 277 0xA406: ('SceneCaptureType', ),
bgneal@1 278 0xA407: ('GainControl', ),
bgneal@1 279 0xA408: ('Contrast', ),
bgneal@1 280 0xA409: ('Saturation', ),
bgneal@1 281 0xA40A: ('Sharpness', ),
bgneal@1 282 0xA40C: ('SubjectDistanceRange', ),
bgneal@1 283 }
bgneal@1 284
bgneal@1 285 # interoperability tags
bgneal@1 286 INTR_TAGS = {
bgneal@1 287 0x0001: ('InteroperabilityIndex', ),
bgneal@1 288 0x0002: ('InteroperabilityVersion', ),
bgneal@1 289 0x1000: ('RelatedImageFileFormat', ),
bgneal@1 290 0x1001: ('RelatedImageWidth', ),
bgneal@1 291 0x1002: ('RelatedImageLength', ),
bgneal@1 292 }
bgneal@1 293
bgneal@1 294 # GPS tags (not used yet, haven't seen camera with GPS)
bgneal@1 295 GPS_TAGS = {
bgneal@1 296 0x0000: ('GPSVersionID', ),
bgneal@1 297 0x0001: ('GPSLatitudeRef', ),
bgneal@1 298 0x0002: ('GPSLatitude', ),
bgneal@1 299 0x0003: ('GPSLongitudeRef', ),
bgneal@1 300 0x0004: ('GPSLongitude', ),
bgneal@1 301 0x0005: ('GPSAltitudeRef', ),
bgneal@1 302 0x0006: ('GPSAltitude', ),
bgneal@1 303 0x0007: ('GPSTimeStamp', ),
bgneal@1 304 0x0008: ('GPSSatellites', ),
bgneal@1 305 0x0009: ('GPSStatus', ),
bgneal@1 306 0x000A: ('GPSMeasureMode', ),
bgneal@1 307 0x000B: ('GPSDOP', ),
bgneal@1 308 0x000C: ('GPSSpeedRef', ),
bgneal@1 309 0x000D: ('GPSSpeed', ),
bgneal@1 310 0x000E: ('GPSTrackRef', ),
bgneal@1 311 0x000F: ('GPSTrack', ),
bgneal@1 312 0x0010: ('GPSImgDirectionRef', ),
bgneal@1 313 0x0011: ('GPSImgDirection', ),
bgneal@1 314 0x0012: ('GPSMapDatum', ),
bgneal@1 315 0x0013: ('GPSDestLatitudeRef', ),
bgneal@1 316 0x0014: ('GPSDestLatitude', ),
bgneal@1 317 0x0015: ('GPSDestLongitudeRef', ),
bgneal@1 318 0x0016: ('GPSDestLongitude', ),
bgneal@1 319 0x0017: ('GPSDestBearingRef', ),
bgneal@1 320 0x0018: ('GPSDestBearing', ),
bgneal@1 321 0x0019: ('GPSDestDistanceRef', ),
bgneal@1 322 0x001A: ('GPSDestDistance', ),
bgneal@1 323 }
bgneal@1 324
bgneal@1 325 # Ignore these tags when quick processing
bgneal@1 326 # 0x927C is MakerNote Tags
bgneal@1 327 # 0x9286 is user comment
bgneal@1 328 IGNORE_TAGS=(0x9286, 0x927C)
bgneal@1 329
bgneal@1 330 # http://tomtia.plala.jp/DigitalCamera/MakerNote/index.asp
bgneal@1 331 def nikon_ev_bias(seq):
bgneal@1 332 # First digit seems to be in steps of 1/6 EV.
bgneal@1 333 # Does the third value mean the step size? It is usually 6,
bgneal@1 334 # but it is 12 for the ExposureDifference.
bgneal@1 335 #
bgneal@1 336 if seq == [252, 1, 6, 0]:
bgneal@1 337 return "-2/3 EV"
bgneal@1 338 if seq == [253, 1, 6, 0]:
bgneal@1 339 return "-1/2 EV"
bgneal@1 340 if seq == [254, 1, 6, 0]:
bgneal@1 341 return "-1/3 EV"
bgneal@1 342 if seq == [0, 1, 6, 0]:
bgneal@1 343 return "0 EV"
bgneal@1 344 if seq == [2, 1, 6, 0]:
bgneal@1 345 return "+1/3 EV"
bgneal@1 346 if seq == [3, 1, 6, 0]:
bgneal@1 347 return "+1/2 EV"
bgneal@1 348 if seq == [4, 1, 6, 0]:
bgneal@1 349 return "+2/3 EV"
bgneal@1 350 # Handle combinations not in the table.
bgneal@1 351 a = seq[0]
bgneal@1 352 # Causes headaches for the +/- logic, so special case it.
bgneal@1 353 if a == 0:
bgneal@1 354 return "0 EV"
bgneal@1 355 if a > 127:
bgneal@1 356 a = 256 - a
bgneal@1 357 ret_str = "-"
bgneal@1 358 else:
bgneal@1 359 ret_str = "+"
bgneal@1 360 b = seq[2] # Assume third value means the step size
bgneal@1 361 whole = a / b
bgneal@1 362 a = a % b
bgneal@1 363 if whole != 0:
bgneal@1 364 ret_str = ret_str + str(whole) + " "
bgneal@1 365 if a == 0:
bgneal@1 366 ret_str = ret_str + "EV"
bgneal@1 367 else:
bgneal@1 368 r = Ratio(a, b)
bgneal@1 369 ret_str = ret_str + r.__repr__() + " EV"
bgneal@1 370 return ret_str
bgneal@1 371
bgneal@1 372 # Nikon E99x MakerNote Tags
bgneal@1 373 MAKERNOTE_NIKON_NEWER_TAGS={
bgneal@1 374 0x0001: ('MakernoteVersion', make_string), # Sometimes binary
bgneal@1 375 0x0002: ('ISOSetting', ),
bgneal@1 376 0x0003: ('ColorMode', ),
bgneal@1 377 0x0004: ('Quality', ),
bgneal@1 378 0x0005: ('Whitebalance', ),
bgneal@1 379 0x0006: ('ImageSharpening', ),
bgneal@1 380 0x0007: ('FocusMode', ),
bgneal@1 381 0x0008: ('FlashSetting', ),
bgneal@1 382 0x0009: ('AutoFlashMode', ),
bgneal@1 383 0x000B: ('WhiteBalanceBias', ),
bgneal@1 384 0x000C: ('WhiteBalanceRBCoeff', ),
bgneal@1 385 0x000D: ('ProgramShift', nikon_ev_bias),
bgneal@1 386 # Nearly the same as the other EV vals, but step size is 1/12 EV (?)
bgneal@1 387 0x000E: ('ExposureDifference', nikon_ev_bias),
bgneal@1 388 0x000F: ('ISOSelection', ),
bgneal@1 389 0x0011: ('NikonPreview', ),
bgneal@1 390 0x0012: ('FlashCompensation', nikon_ev_bias),
bgneal@1 391 0x0013: ('ISOSpeedRequested', ),
bgneal@1 392 0x0016: ('PhotoCornerCoordinates', ),
bgneal@1 393 # 0x0017: Unknown, but most likely an EV value
bgneal@1 394 0x0018: ('FlashBracketCompensationApplied', nikon_ev_bias),
bgneal@1 395 0x0019: ('AEBracketCompensationApplied', ),
bgneal@1 396 0x001A: ('ImageProcessing', ),
bgneal@1 397 0x0080: ('ImageAdjustment', ),
bgneal@1 398 0x0081: ('ToneCompensation', ),
bgneal@1 399 0x0082: ('AuxiliaryLens', ),
bgneal@1 400 0x0083: ('LensType', ),
bgneal@1 401 0x0084: ('LensMinMaxFocalMaxAperture', ),
bgneal@1 402 0x0085: ('ManualFocusDistance', ),
bgneal@1 403 0x0086: ('DigitalZoomFactor', ),
bgneal@1 404 0x0087: ('FlashMode',
bgneal@1 405 {0x00: 'Did Not Fire',
bgneal@1 406 0x01: 'Fired, Manual',
bgneal@1 407 0x07: 'Fired, External',
bgneal@1 408 0x08: 'Fired, Commander Mode ',
bgneal@1 409 0x09: 'Fired, TTL Mode'}),
bgneal@1 410 0x0088: ('AFFocusPosition',
bgneal@1 411 {0x0000: 'Center',
bgneal@1 412 0x0100: 'Top',
bgneal@1 413 0x0200: 'Bottom',
bgneal@1 414 0x0300: 'Left',
bgneal@1 415 0x0400: 'Right'}),
bgneal@1 416 0x0089: ('BracketingMode',
bgneal@1 417 {0x00: 'Single frame, no bracketing',
bgneal@1 418 0x01: 'Continuous, no bracketing',
bgneal@1 419 0x02: 'Timer, no bracketing',
bgneal@1 420 0x10: 'Single frame, exposure bracketing',
bgneal@1 421 0x11: 'Continuous, exposure bracketing',
bgneal@1 422 0x12: 'Timer, exposure bracketing',
bgneal@1 423 0x40: 'Single frame, white balance bracketing',
bgneal@1 424 0x41: 'Continuous, white balance bracketing',
bgneal@1 425 0x42: 'Timer, white balance bracketing'}),
bgneal@1 426 0x008A: ('AutoBracketRelease', ),
bgneal@1 427 0x008B: ('LensFStops', ),
bgneal@1 428 0x008C: ('NEFCurve2', ),
bgneal@1 429 0x008D: ('ColorMode', ),
bgneal@1 430 0x008F: ('SceneMode', ),
bgneal@1 431 0x0090: ('LightingType', ),
bgneal@1 432 0x0091: ('ShotInfo', ), # First 4 bytes are probably a version number in ASCII
bgneal@1 433 0x0092: ('HueAdjustment', ),
bgneal@1 434 # 0x0093: ('SaturationAdjustment', ),
bgneal@1 435 0x0094: ('Saturation', # Name conflict with 0x00AA !!
bgneal@1 436 {-3: 'B&W',
bgneal@1 437 -2: '-2',
bgneal@1 438 -1: '-1',
bgneal@1 439 0: '0',
bgneal@1 440 1: '1',
bgneal@1 441 2: '2'}),
bgneal@1 442 0x0095: ('NoiseReduction', ),
bgneal@1 443 0x0096: ('NEFCurve2', ),
bgneal@1 444 0x0097: ('ColorBalance', ),
bgneal@1 445 0x0098: ('LensData', ), # First 4 bytes are a version number in ASCII
bgneal@1 446 0x0099: ('RawImageCenter', ),
bgneal@1 447 0x009A: ('SensorPixelSize', ),
bgneal@1 448 0x009C: ('Scene Assist', ),
bgneal@1 449 0x00A0: ('SerialNumber', ),
bgneal@1 450 0x00A2: ('ImageDataSize', ),
bgneal@1 451 # A4: In NEF, looks like a 4 byte ASCII version number
bgneal@1 452 0x00A5: ('ImageCount', ),
bgneal@1 453 0x00A6: ('DeletedImageCount', ),
bgneal@1 454 0x00A7: ('TotalShutterReleases', ),
bgneal@1 455 # A8: ExposureMode? JPG: First 4 bytes are probably a version number in ASCII
bgneal@1 456 # But in a sample NEF, its 8 zeros, then the string "NORMAL"
bgneal@1 457 0x00A9: ('ImageOptimization', ),
bgneal@1 458 0x00AA: ('Saturation', ),
bgneal@1 459 0x00AB: ('DigitalVariProgram', ),
bgneal@1 460 0x00AC: ('ImageStabilization', ),
bgneal@1 461 0x00AD: ('Responsive AF', ), # 'AFResponse'
bgneal@1 462 0x0010: ('DataDump', ),
bgneal@1 463 }
bgneal@1 464
bgneal@1 465 MAKERNOTE_NIKON_OLDER_TAGS = {
bgneal@1 466 0x0003: ('Quality',
bgneal@1 467 {1: 'VGA Basic',
bgneal@1 468 2: 'VGA Normal',
bgneal@1 469 3: 'VGA Fine',
bgneal@1 470 4: 'SXGA Basic',
bgneal@1 471 5: 'SXGA Normal',
bgneal@1 472 6: 'SXGA Fine'}),
bgneal@1 473 0x0004: ('ColorMode',
bgneal@1 474 {1: 'Color',
bgneal@1 475 2: 'Monochrome'}),
bgneal@1 476 0x0005: ('ImageAdjustment',
bgneal@1 477 {0: 'Normal',
bgneal@1 478 1: 'Bright+',
bgneal@1 479 2: 'Bright-',
bgneal@1 480 3: 'Contrast+',
bgneal@1 481 4: 'Contrast-'}),
bgneal@1 482 0x0006: ('CCDSpeed',
bgneal@1 483 {0: 'ISO 80',
bgneal@1 484 2: 'ISO 160',
bgneal@1 485 4: 'ISO 320',
bgneal@1 486 5: 'ISO 100'}),
bgneal@1 487 0x0007: ('WhiteBalance',
bgneal@1 488 {0: 'Auto',
bgneal@1 489 1: 'Preset',
bgneal@1 490 2: 'Daylight',
bgneal@1 491 3: 'Incandescent',
bgneal@1 492 4: 'Fluorescent',
bgneal@1 493 5: 'Cloudy',
bgneal@1 494 6: 'Speed Light'}),
bgneal@1 495 }
bgneal@1 496
bgneal@1 497 # decode Olympus SpecialMode tag in MakerNote
bgneal@1 498 def olympus_special_mode(v):
bgneal@1 499 a={
bgneal@1 500 0: 'Normal',
bgneal@1 501 1: 'Unknown',
bgneal@1 502 2: 'Fast',
bgneal@1 503 3: 'Panorama'}
bgneal@1 504 b={
bgneal@1 505 0: 'Non-panoramic',
bgneal@1 506 1: 'Left to right',
bgneal@1 507 2: 'Right to left',
bgneal@1 508 3: 'Bottom to top',
bgneal@1 509 4: 'Top to bottom'}
bgneal@1 510 if v[0] not in a or v[2] not in b:
bgneal@1 511 return v
bgneal@1 512 return '%s - sequence %d - %s' % (a[v[0]], v[1], b[v[2]])
bgneal@1 513
bgneal@1 514 MAKERNOTE_OLYMPUS_TAGS={
bgneal@1 515 # ah HAH! those sneeeeeaky bastids! this is how they get past the fact
bgneal@1 516 # that a JPEG thumbnail is not allowed in an uncompressed TIFF file
bgneal@1 517 0x0100: ('JPEGThumbnail', ),
bgneal@1 518 0x0200: ('SpecialMode', olympus_special_mode),
bgneal@1 519 0x0201: ('JPEGQual',
bgneal@1 520 {1: 'SQ',
bgneal@1 521 2: 'HQ',
bgneal@1 522 3: 'SHQ'}),
bgneal@1 523 0x0202: ('Macro',
bgneal@1 524 {0: 'Normal',
bgneal@1 525 1: 'Macro',
bgneal@1 526 2: 'SuperMacro'}),
bgneal@1 527 0x0203: ('BWMode',
bgneal@1 528 {0: 'Off',
bgneal@1 529 1: 'On'}),
bgneal@1 530 0x0204: ('DigitalZoom', ),
bgneal@1 531 0x0205: ('FocalPlaneDiagonal', ),
bgneal@1 532 0x0206: ('LensDistortionParams', ),
bgneal@1 533 0x0207: ('SoftwareRelease', ),
bgneal@1 534 0x0208: ('PictureInfo', ),
bgneal@1 535 0x0209: ('CameraID', make_string), # print as string
bgneal@1 536 0x0F00: ('DataDump', ),
bgneal@1 537 0x0300: ('PreCaptureFrames', ),
bgneal@1 538 0x0404: ('SerialNumber', ),
bgneal@1 539 0x1000: ('ShutterSpeedValue', ),
bgneal@1 540 0x1001: ('ISOValue', ),
bgneal@1 541 0x1002: ('ApertureValue', ),
bgneal@1 542 0x1003: ('BrightnessValue', ),
bgneal@1 543 0x1004: ('FlashMode', ),
bgneal@1 544 0x1004: ('FlashMode',
bgneal@1 545 {2: 'On',
bgneal@1 546 3: 'Off'}),
bgneal@1 547 0x1005: ('FlashDevice',
bgneal@1 548 {0: 'None',
bgneal@1 549 1: 'Internal',
bgneal@1 550 4: 'External',
bgneal@1 551 5: 'Internal + External'}),
bgneal@1 552 0x1006: ('ExposureCompensation', ),
bgneal@1 553 0x1007: ('SensorTemperature', ),
bgneal@1 554 0x1008: ('LensTemperature', ),
bgneal@1 555 0x100b: ('FocusMode',
bgneal@1 556 {0: 'Auto',
bgneal@1 557 1: 'Manual'}),
bgneal@1 558 0x1017: ('RedBalance', ),
bgneal@1 559 0x1018: ('BlueBalance', ),
bgneal@1 560 0x101a: ('SerialNumber', ),
bgneal@1 561 0x1023: ('FlashExposureComp', ),
bgneal@1 562 0x1026: ('ExternalFlashBounce',
bgneal@1 563 {0: 'No',
bgneal@1 564 1: 'Yes'}),
bgneal@1 565 0x1027: ('ExternalFlashZoom', ),
bgneal@1 566 0x1028: ('ExternalFlashMode', ),
bgneal@1 567 0x1029: ('Contrast int16u',
bgneal@1 568 {0: 'High',
bgneal@1 569 1: 'Normal',
bgneal@1 570 2: 'Low'}),
bgneal@1 571 0x102a: ('SharpnessFactor', ),
bgneal@1 572 0x102b: ('ColorControl', ),
bgneal@1 573 0x102c: ('ValidBits', ),
bgneal@1 574 0x102d: ('CoringFilter', ),
bgneal@1 575 0x102e: ('OlympusImageWidth', ),
bgneal@1 576 0x102f: ('OlympusImageHeight', ),
bgneal@1 577 0x1034: ('CompressionRatio', ),
bgneal@1 578 0x1035: ('PreviewImageValid',
bgneal@1 579 {0: 'No',
bgneal@1 580 1: 'Yes'}),
bgneal@1 581 0x1036: ('PreviewImageStart', ),
bgneal@1 582 0x1037: ('PreviewImageLength', ),
bgneal@1 583 0x1039: ('CCDScanMode',
bgneal@1 584 {0: 'Interlaced',
bgneal@1 585 1: 'Progressive'}),
bgneal@1 586 0x103a: ('NoiseReduction',
bgneal@1 587 {0: 'Off',
bgneal@1 588 1: 'On'}),
bgneal@1 589 0x103b: ('InfinityLensStep', ),
bgneal@1 590 0x103c: ('NearLensStep', ),
bgneal@1 591
bgneal@1 592 # TODO - these need extra definitions
bgneal@1 593 # http://search.cpan.org/src/EXIFTOOL/Image-ExifTool-6.90/html/TagNames/Olympus.html
bgneal@1 594 0x2010: ('Equipment', ),
bgneal@1 595 0x2020: ('CameraSettings', ),
bgneal@1 596 0x2030: ('RawDevelopment', ),
bgneal@1 597 0x2040: ('ImageProcessing', ),
bgneal@1 598 0x2050: ('FocusInfo', ),
bgneal@1 599 0x3000: ('RawInfo ', ),
bgneal@1 600 }
bgneal@1 601
bgneal@1 602 # 0x2020 CameraSettings
bgneal@1 603 MAKERNOTE_OLYMPUS_TAG_0x2020={
bgneal@1 604 0x0100: ('PreviewImageValid',
bgneal@1 605 {0: 'No',
bgneal@1 606 1: 'Yes'}),
bgneal@1 607 0x0101: ('PreviewImageStart', ),
bgneal@1 608 0x0102: ('PreviewImageLength', ),
bgneal@1 609 0x0200: ('ExposureMode', {
bgneal@1 610 1: 'Manual',
bgneal@1 611 2: 'Program',
bgneal@1 612 3: 'Aperture-priority AE',
bgneal@1 613 4: 'Shutter speed priority AE',
bgneal@1 614 5: 'Program-shift'}),
bgneal@1 615 0x0201: ('AELock',
bgneal@1 616 {0: 'Off',
bgneal@1 617 1: 'On'}),
bgneal@1 618 0x0202: ('MeteringMode',
bgneal@1 619 {2: 'Center Weighted',
bgneal@1 620 3: 'Spot',
bgneal@1 621 5: 'ESP',
bgneal@1 622 261: 'Pattern+AF',
bgneal@1 623 515: 'Spot+Highlight control',
bgneal@1 624 1027: 'Spot+Shadow control'}),
bgneal@1 625 0x0300: ('MacroMode',
bgneal@1 626 {0: 'Off',
bgneal@1 627 1: 'On'}),
bgneal@1 628 0x0301: ('FocusMode',
bgneal@1 629 {0: 'Single AF',
bgneal@1 630 1: 'Sequential shooting AF',
bgneal@1 631 2: 'Continuous AF',
bgneal@1 632 3: 'Multi AF',
bgneal@1 633 10: 'MF'}),
bgneal@1 634 0x0302: ('FocusProcess',
bgneal@1 635 {0: 'AF Not Used',
bgneal@1 636 1: 'AF Used'}),
bgneal@1 637 0x0303: ('AFSearch',
bgneal@1 638 {0: 'Not Ready',
bgneal@1 639 1: 'Ready'}),
bgneal@1 640 0x0304: ('AFAreas', ),
bgneal@1 641 0x0401: ('FlashExposureCompensation', ),
bgneal@1 642 0x0500: ('WhiteBalance2',
bgneal@1 643 {0: 'Auto',
bgneal@1 644 16: '7500K (Fine Weather with Shade)',
bgneal@1 645 17: '6000K (Cloudy)',
bgneal@1 646 18: '5300K (Fine Weather)',
bgneal@1 647 20: '3000K (Tungsten light)',
bgneal@1 648 21: '3600K (Tungsten light-like)',
bgneal@1 649 33: '6600K (Daylight fluorescent)',
bgneal@1 650 34: '4500K (Neutral white fluorescent)',
bgneal@1 651 35: '4000K (Cool white fluorescent)',
bgneal@1 652 48: '3600K (Tungsten light-like)',
bgneal@1 653 256: 'Custom WB 1',
bgneal@1 654 257: 'Custom WB 2',
bgneal@1 655 258: 'Custom WB 3',
bgneal@1 656 259: 'Custom WB 4',
bgneal@1 657 512: 'Custom WB 5400K',
bgneal@1 658 513: 'Custom WB 2900K',
bgneal@1 659 514: 'Custom WB 8000K', }),
bgneal@1 660 0x0501: ('WhiteBalanceTemperature', ),
bgneal@1 661 0x0502: ('WhiteBalanceBracket', ),
bgneal@1 662 0x0503: ('CustomSaturation', ), # (3 numbers: 1. CS Value, 2. Min, 3. Max)
bgneal@1 663 0x0504: ('ModifiedSaturation',
bgneal@1 664 {0: 'Off',
bgneal@1 665 1: 'CM1 (Red Enhance)',
bgneal@1 666 2: 'CM2 (Green Enhance)',
bgneal@1 667 3: 'CM3 (Blue Enhance)',
bgneal@1 668 4: 'CM4 (Skin Tones)'}),
bgneal@1 669 0x0505: ('ContrastSetting', ), # (3 numbers: 1. Contrast, 2. Min, 3. Max)
bgneal@1 670 0x0506: ('SharpnessSetting', ), # (3 numbers: 1. Sharpness, 2. Min, 3. Max)
bgneal@1 671 0x0507: ('ColorSpace',
bgneal@1 672 {0: 'sRGB',
bgneal@1 673 1: 'Adobe RGB',
bgneal@1 674 2: 'Pro Photo RGB'}),
bgneal@1 675 0x0509: ('SceneMode',
bgneal@1 676 {0: 'Standard',
bgneal@1 677 6: 'Auto',
bgneal@1 678 7: 'Sport',
bgneal@1 679 8: 'Portrait',
bgneal@1 680 9: 'Landscape+Portrait',
bgneal@1 681 10: 'Landscape',
bgneal@1 682 11: 'Night scene',
bgneal@1 683 13: 'Panorama',
bgneal@1 684 16: 'Landscape+Portrait',
bgneal@1 685 17: 'Night+Portrait',
bgneal@1 686 19: 'Fireworks',
bgneal@1 687 20: 'Sunset',
bgneal@1 688 22: 'Macro',
bgneal@1 689 25: 'Documents',
bgneal@1 690 26: 'Museum',
bgneal@1 691 28: 'Beach&Snow',
bgneal@1 692 30: 'Candle',
bgneal@1 693 35: 'Underwater Wide1',
bgneal@1 694 36: 'Underwater Macro',
bgneal@1 695 39: 'High Key',
bgneal@1 696 40: 'Digital Image Stabilization',
bgneal@1 697 44: 'Underwater Wide2',
bgneal@1 698 45: 'Low Key',
bgneal@1 699 46: 'Children',
bgneal@1 700 48: 'Nature Macro'}),
bgneal@1 701 0x050a: ('NoiseReduction',
bgneal@1 702 {0: 'Off',
bgneal@1 703 1: 'Noise Reduction',
bgneal@1 704 2: 'Noise Filter',
bgneal@1 705 3: 'Noise Reduction + Noise Filter',
bgneal@1 706 4: 'Noise Filter (ISO Boost)',
bgneal@1 707 5: 'Noise Reduction + Noise Filter (ISO Boost)'}),
bgneal@1 708 0x050b: ('DistortionCorrection',
bgneal@1 709 {0: 'Off',
bgneal@1 710 1: 'On'}),
bgneal@1 711 0x050c: ('ShadingCompensation',
bgneal@1 712 {0: 'Off',
bgneal@1 713 1: 'On'}),
bgneal@1 714 0x050d: ('CompressionFactor', ),
bgneal@1 715 0x050f: ('Gradation',
bgneal@1 716 {'-1 -1 1': 'Low Key',
bgneal@1 717 '0 -1 1': 'Normal',
bgneal@1 718 '1 -1 1': 'High Key'}),
bgneal@1 719 0x0520: ('PictureMode',
bgneal@1 720 {1: 'Vivid',
bgneal@1 721 2: 'Natural',
bgneal@1 722 3: 'Muted',
bgneal@1 723 256: 'Monotone',
bgneal@1 724 512: 'Sepia'}),
bgneal@1 725 0x0521: ('PictureModeSaturation', ),
bgneal@1 726 0x0522: ('PictureModeHue?', ),
bgneal@1 727 0x0523: ('PictureModeContrast', ),
bgneal@1 728 0x0524: ('PictureModeSharpness', ),
bgneal@1 729 0x0525: ('PictureModeBWFilter',
bgneal@1 730 {0: 'n/a',
bgneal@1 731 1: 'Neutral',
bgneal@1 732 2: 'Yellow',
bgneal@1 733 3: 'Orange',
bgneal@1 734 4: 'Red',
bgneal@1 735 5: 'Green'}),
bgneal@1 736 0x0526: ('PictureModeTone',
bgneal@1 737 {0: 'n/a',
bgneal@1 738 1: 'Neutral',
bgneal@1 739 2: 'Sepia',
bgneal@1 740 3: 'Blue',
bgneal@1 741 4: 'Purple',
bgneal@1 742 5: 'Green'}),
bgneal@1 743 0x0600: ('Sequence', ), # 2 or 3 numbers: 1. Mode, 2. Shot number, 3. Mode bits
bgneal@1 744 0x0601: ('PanoramaMode', ), # (2 numbers: 1. Mode, 2. Shot number)
bgneal@1 745 0x0603: ('ImageQuality2',
bgneal@1 746 {1: 'SQ',
bgneal@1 747 2: 'HQ',
bgneal@1 748 3: 'SHQ',
bgneal@1 749 4: 'RAW'}),
bgneal@1 750 0x0901: ('ManometerReading', ),
bgneal@1 751 }
bgneal@1 752
bgneal@1 753
bgneal@1 754 MAKERNOTE_CASIO_TAGS={
bgneal@1 755 0x0001: ('RecordingMode',
bgneal@1 756 {1: 'Single Shutter',
bgneal@1 757 2: 'Panorama',
bgneal@1 758 3: 'Night Scene',
bgneal@1 759 4: 'Portrait',
bgneal@1 760 5: 'Landscape'}),
bgneal@1 761 0x0002: ('Quality',
bgneal@1 762 {1: 'Economy',
bgneal@1 763 2: 'Normal',
bgneal@1 764 3: 'Fine'}),
bgneal@1 765 0x0003: ('FocusingMode',
bgneal@1 766 {2: 'Macro',
bgneal@1 767 3: 'Auto Focus',
bgneal@1 768 4: 'Manual Focus',
bgneal@1 769 5: 'Infinity'}),
bgneal@1 770 0x0004: ('FlashMode',
bgneal@1 771 {1: 'Auto',
bgneal@1 772 2: 'On',
bgneal@1 773 3: 'Off',
bgneal@1 774 4: 'Red Eye Reduction'}),
bgneal@1 775 0x0005: ('FlashIntensity',
bgneal@1 776 {11: 'Weak',
bgneal@1 777 13: 'Normal',
bgneal@1 778 15: 'Strong'}),
bgneal@1 779 0x0006: ('Object Distance', ),
bgneal@1 780 0x0007: ('WhiteBalance',
bgneal@1 781 {1: 'Auto',
bgneal@1 782 2: 'Tungsten',
bgneal@1 783 3: 'Daylight',
bgneal@1 784 4: 'Fluorescent',
bgneal@1 785 5: 'Shade',
bgneal@1 786 129: 'Manual'}),
bgneal@1 787 0x000B: ('Sharpness',
bgneal@1 788 {0: 'Normal',
bgneal@1 789 1: 'Soft',
bgneal@1 790 2: 'Hard'}),
bgneal@1 791 0x000C: ('Contrast',
bgneal@1 792 {0: 'Normal',
bgneal@1 793 1: 'Low',
bgneal@1 794 2: 'High'}),
bgneal@1 795 0x000D: ('Saturation',
bgneal@1 796 {0: 'Normal',
bgneal@1 797 1: 'Low',
bgneal@1 798 2: 'High'}),
bgneal@1 799 0x0014: ('CCDSpeed',
bgneal@1 800 {64: 'Normal',
bgneal@1 801 80: 'Normal',
bgneal@1 802 100: 'High',
bgneal@1 803 125: '+1.0',
bgneal@1 804 244: '+3.0',
bgneal@1 805 250: '+2.0'}),
bgneal@1 806 }
bgneal@1 807
bgneal@1 808 MAKERNOTE_FUJIFILM_TAGS={
bgneal@1 809 0x0000: ('NoteVersion', make_string),
bgneal@1 810 0x1000: ('Quality', ),
bgneal@1 811 0x1001: ('Sharpness',
bgneal@1 812 {1: 'Soft',
bgneal@1 813 2: 'Soft',
bgneal@1 814 3: 'Normal',
bgneal@1 815 4: 'Hard',
bgneal@1 816 5: 'Hard'}),
bgneal@1 817 0x1002: ('WhiteBalance',
bgneal@1 818 {0: 'Auto',
bgneal@1 819 256: 'Daylight',
bgneal@1 820 512: 'Cloudy',
bgneal@1 821 768: 'DaylightColor-Fluorescent',
bgneal@1 822 769: 'DaywhiteColor-Fluorescent',
bgneal@1 823 770: 'White-Fluorescent',
bgneal@1 824 1024: 'Incandescent',
bgneal@1 825 3840: 'Custom'}),
bgneal@1 826 0x1003: ('Color',
bgneal@1 827 {0: 'Normal',
bgneal@1 828 256: 'High',
bgneal@1 829 512: 'Low'}),
bgneal@1 830 0x1004: ('Tone',
bgneal@1 831 {0: 'Normal',
bgneal@1 832 256: 'High',
bgneal@1 833 512: 'Low'}),
bgneal@1 834 0x1010: ('FlashMode',
bgneal@1 835 {0: 'Auto',
bgneal@1 836 1: 'On',
bgneal@1 837 2: 'Off',
bgneal@1 838 3: 'Red Eye Reduction'}),
bgneal@1 839 0x1011: ('FlashStrength', ),
bgneal@1 840 0x1020: ('Macro',
bgneal@1 841 {0: 'Off',
bgneal@1 842 1: 'On'}),
bgneal@1 843 0x1021: ('FocusMode',
bgneal@1 844 {0: 'Auto',
bgneal@1 845 1: 'Manual'}),
bgneal@1 846 0x1030: ('SlowSync',
bgneal@1 847 {0: 'Off',
bgneal@1 848 1: 'On'}),
bgneal@1 849 0x1031: ('PictureMode',
bgneal@1 850 {0: 'Auto',
bgneal@1 851 1: 'Portrait',
bgneal@1 852 2: 'Landscape',
bgneal@1 853 4: 'Sports',
bgneal@1 854 5: 'Night',
bgneal@1 855 6: 'Program AE',
bgneal@1 856 256: 'Aperture Priority AE',
bgneal@1 857 512: 'Shutter Priority AE',
bgneal@1 858 768: 'Manual Exposure'}),
bgneal@1 859 0x1100: ('MotorOrBracket',
bgneal@1 860 {0: 'Off',
bgneal@1 861 1: 'On'}),
bgneal@1 862 0x1300: ('BlurWarning',
bgneal@1 863 {0: 'Off',
bgneal@1 864 1: 'On'}),
bgneal@1 865 0x1301: ('FocusWarning',
bgneal@1 866 {0: 'Off',
bgneal@1 867 1: 'On'}),
bgneal@1 868 0x1302: ('AEWarning',
bgneal@1 869 {0: 'Off',
bgneal@1 870 1: 'On'}),
bgneal@1 871 }
bgneal@1 872
bgneal@1 873 MAKERNOTE_CANON_TAGS = {
bgneal@1 874 0x0006: ('ImageType', ),
bgneal@1 875 0x0007: ('FirmwareVersion', ),
bgneal@1 876 0x0008: ('ImageNumber', ),
bgneal@1 877 0x0009: ('OwnerName', ),
bgneal@1 878 }
bgneal@1 879
bgneal@1 880 # this is in element offset, name, optional value dictionary format
bgneal@1 881 MAKERNOTE_CANON_TAG_0x001 = {
bgneal@1 882 1: ('Macromode',
bgneal@1 883 {1: 'Macro',
bgneal@1 884 2: 'Normal'}),
bgneal@1 885 2: ('SelfTimer', ),
bgneal@1 886 3: ('Quality',
bgneal@1 887 {2: 'Normal',
bgneal@1 888 3: 'Fine',
bgneal@1 889 5: 'Superfine'}),
bgneal@1 890 4: ('FlashMode',
bgneal@1 891 {0: 'Flash Not Fired',
bgneal@1 892 1: 'Auto',
bgneal@1 893 2: 'On',
bgneal@1 894 3: 'Red-Eye Reduction',
bgneal@1 895 4: 'Slow Synchro',
bgneal@1 896 5: 'Auto + Red-Eye Reduction',
bgneal@1 897 6: 'On + Red-Eye Reduction',
bgneal@1 898 16: 'external flash'}),
bgneal@1 899 5: ('ContinuousDriveMode',
bgneal@1 900 {0: 'Single Or Timer',
bgneal@1 901 1: 'Continuous'}),
bgneal@1 902 7: ('FocusMode',
bgneal@1 903 {0: 'One-Shot',
bgneal@1 904 1: 'AI Servo',
bgneal@1 905 2: 'AI Focus',
bgneal@1 906 3: 'MF',
bgneal@1 907 4: 'Single',
bgneal@1 908 5: 'Continuous',
bgneal@1 909 6: 'MF'}),
bgneal@1 910 10: ('ImageSize',
bgneal@1 911 {0: 'Large',
bgneal@1 912 1: 'Medium',
bgneal@1 913 2: 'Small'}),
bgneal@1 914 11: ('EasyShootingMode',
bgneal@1 915 {0: 'Full Auto',
bgneal@1 916 1: 'Manual',
bgneal@1 917 2: 'Landscape',
bgneal@1 918 3: 'Fast Shutter',
bgneal@1 919 4: 'Slow Shutter',
bgneal@1 920 5: 'Night',
bgneal@1 921 6: 'B&W',
bgneal@1 922 7: 'Sepia',
bgneal@1 923 8: 'Portrait',
bgneal@1 924 9: 'Sports',
bgneal@1 925 10: 'Macro/Close-Up',
bgneal@1 926 11: 'Pan Focus'}),
bgneal@1 927 12: ('DigitalZoom',
bgneal@1 928 {0: 'None',
bgneal@1 929 1: '2x',
bgneal@1 930 2: '4x'}),
bgneal@1 931 13: ('Contrast',
bgneal@1 932 {0xFFFF: 'Low',
bgneal@1 933 0: 'Normal',
bgneal@1 934 1: 'High'}),
bgneal@1 935 14: ('Saturation',
bgneal@1 936 {0xFFFF: 'Low',
bgneal@1 937 0: 'Normal',
bgneal@1 938 1: 'High'}),
bgneal@1 939 15: ('Sharpness',
bgneal@1 940 {0xFFFF: 'Low',
bgneal@1 941 0: 'Normal',
bgneal@1 942 1: 'High'}),
bgneal@1 943 16: ('ISO',
bgneal@1 944 {0: 'See ISOSpeedRatings Tag',
bgneal@1 945 15: 'Auto',
bgneal@1 946 16: '50',
bgneal@1 947 17: '100',
bgneal@1 948 18: '200',
bgneal@1 949 19: '400'}),
bgneal@1 950 17: ('MeteringMode',
bgneal@1 951 {3: 'Evaluative',
bgneal@1 952 4: 'Partial',
bgneal@1 953 5: 'Center-weighted'}),
bgneal@1 954 18: ('FocusType',
bgneal@1 955 {0: 'Manual',
bgneal@1 956 1: 'Auto',
bgneal@1 957 3: 'Close-Up (Macro)',
bgneal@1 958 8: 'Locked (Pan Mode)'}),
bgneal@1 959 19: ('AFPointSelected',
bgneal@1 960 {0x3000: 'None (MF)',
bgneal@1 961 0x3001: 'Auto-Selected',
bgneal@1 962 0x3002: 'Right',
bgneal@1 963 0x3003: 'Center',
bgneal@1 964 0x3004: 'Left'}),
bgneal@1 965 20: ('ExposureMode',
bgneal@1 966 {0: 'Easy Shooting',
bgneal@1 967 1: 'Program',
bgneal@1 968 2: 'Tv-priority',
bgneal@1 969 3: 'Av-priority',
bgneal@1 970 4: 'Manual',
bgneal@1 971 5: 'A-DEP'}),
bgneal@1 972 23: ('LongFocalLengthOfLensInFocalUnits', ),
bgneal@1 973 24: ('ShortFocalLengthOfLensInFocalUnits', ),
bgneal@1 974 25: ('FocalUnitsPerMM', ),
bgneal@1 975 28: ('FlashActivity',
bgneal@1 976 {0: 'Did Not Fire',
bgneal@1 977 1: 'Fired'}),
bgneal@1 978 29: ('FlashDetails',
bgneal@1 979 {14: 'External E-TTL',
bgneal@1 980 13: 'Internal Flash',
bgneal@1 981 11: 'FP Sync Used',
bgneal@1 982 7: '2nd("Rear")-Curtain Sync Used',
bgneal@1 983 4: 'FP Sync Enabled'}),
bgneal@1 984 32: ('FocusMode',
bgneal@1 985 {0: 'Single',
bgneal@1 986 1: 'Continuous'}),
bgneal@1 987 }
bgneal@1 988
bgneal@1 989 MAKERNOTE_CANON_TAG_0x004 = {
bgneal@1 990 7: ('WhiteBalance',
bgneal@1 991 {0: 'Auto',
bgneal@1 992 1: 'Sunny',
bgneal@1 993 2: 'Cloudy',
bgneal@1 994 3: 'Tungsten',
bgneal@1 995 4: 'Fluorescent',
bgneal@1 996 5: 'Flash',
bgneal@1 997 6: 'Custom'}),
bgneal@1 998 9: ('SequenceNumber', ),
bgneal@1 999 14: ('AFPointUsed', ),
bgneal@1 1000 15: ('FlashBias',
bgneal@1 1001 {0XFFC0: '-2 EV',
bgneal@1 1002 0XFFCC: '-1.67 EV',
bgneal@1 1003 0XFFD0: '-1.50 EV',
bgneal@1 1004 0XFFD4: '-1.33 EV',
bgneal@1 1005 0XFFE0: '-1 EV',
bgneal@1 1006 0XFFEC: '-0.67 EV',
bgneal@1 1007 0XFFF0: '-0.50 EV',
bgneal@1 1008 0XFFF4: '-0.33 EV',
bgneal@1 1009 0X0000: '0 EV',
bgneal@1 1010 0X000C: '0.33 EV',
bgneal@1 1011 0X0010: '0.50 EV',
bgneal@1 1012 0X0014: '0.67 EV',
bgneal@1 1013 0X0020: '1 EV',
bgneal@1 1014 0X002C: '1.33 EV',
bgneal@1 1015 0X0030: '1.50 EV',
bgneal@1 1016 0X0034: '1.67 EV',
bgneal@1 1017 0X0040: '2 EV'}),
bgneal@1 1018 19: ('SubjectDistance', ),
bgneal@1 1019 }
bgneal@1 1020
bgneal@1 1021 # extract multibyte integer in Motorola format (little endian)
bgneal@1 1022 def s2n_motorola(str):
bgneal@1 1023 x = 0
bgneal@1 1024 for c in str:
bgneal@1 1025 x = (x << 8) | ord(c)
bgneal@1 1026 return x
bgneal@1 1027
bgneal@1 1028 # extract multibyte integer in Intel format (big endian)
bgneal@1 1029 def s2n_intel(str):
bgneal@1 1030 x = 0
bgneal@1 1031 y = 0L
bgneal@1 1032 for c in str:
bgneal@1 1033 x = x | (ord(c) << y)
bgneal@1 1034 y = y + 8
bgneal@1 1035 return x
bgneal@1 1036
bgneal@1 1037 # ratio object that eventually will be able to reduce itself to lowest
bgneal@1 1038 # common denominator for printing
bgneal@1 1039 def gcd(a, b):
bgneal@1 1040 if b == 0:
bgneal@1 1041 return a
bgneal@1 1042 else:
bgneal@1 1043 return gcd(b, a % b)
bgneal@1 1044
bgneal@1 1045 class Ratio:
bgneal@1 1046 def __init__(self, num, den):
bgneal@1 1047 self.num = num
bgneal@1 1048 self.den = den
bgneal@1 1049
bgneal@1 1050 def __repr__(self):
bgneal@1 1051 self.reduce()
bgneal@1 1052 if self.den == 1:
bgneal@1 1053 return str(self.num)
bgneal@1 1054 return '%d/%d' % (self.num, self.den)
bgneal@1 1055
bgneal@1 1056 def reduce(self):
bgneal@1 1057 div = gcd(self.num, self.den)
bgneal@1 1058 if div > 1:
bgneal@1 1059 self.num = self.num / div
bgneal@1 1060 self.den = self.den / div
bgneal@1 1061
bgneal@1 1062 # for ease of dealing with tags
bgneal@1 1063 class IFD_Tag:
bgneal@1 1064 def __init__(self, printable, tag, field_type, values, field_offset,
bgneal@1 1065 field_length):
bgneal@1 1066 # printable version of data
bgneal@1 1067 self.printable = printable
bgneal@1 1068 # tag ID number
bgneal@1 1069 self.tag = tag
bgneal@1 1070 # field type as index into FIELD_TYPES
bgneal@1 1071 self.field_type = field_type
bgneal@1 1072 # offset of start of field in bytes from beginning of IFD
bgneal@1 1073 self.field_offset = field_offset
bgneal@1 1074 # length of data field in bytes
bgneal@1 1075 self.field_length = field_length
bgneal@1 1076 # either a string or array of data items
bgneal@1 1077 self.values = values
bgneal@1 1078
bgneal@1 1079 def __str__(self):
bgneal@1 1080 return self.printable
bgneal@1 1081
bgneal@1 1082 def __repr__(self):
bgneal@1 1083 return '(0x%04X) %s=%s @ %d' % (self.tag,
bgneal@1 1084 FIELD_TYPES[self.field_type][2],
bgneal@1 1085 self.printable,
bgneal@1 1086 self.field_offset)
bgneal@1 1087
bgneal@1 1088 # class that handles an EXIF header
bgneal@1 1089 class EXIF_header:
bgneal@1 1090 def __init__(self, file, endian, offset, fake_exif, debug=0):
bgneal@1 1091 self.file = file
bgneal@1 1092 self.endian = endian
bgneal@1 1093 self.offset = offset
bgneal@1 1094 self.fake_exif = fake_exif
bgneal@1 1095 self.debug = debug
bgneal@1 1096 self.tags = {}
bgneal@1 1097
bgneal@1 1098 # convert slice to integer, based on sign and endian flags
bgneal@1 1099 # usually this offset is assumed to be relative to the beginning of the
bgneal@1 1100 # start of the EXIF information. For some cameras that use relative tags,
bgneal@1 1101 # this offset may be relative to some other starting point.
bgneal@1 1102 def s2n(self, offset, length, signed=0):
bgneal@1 1103 self.file.seek(self.offset+offset)
bgneal@1 1104 slice=self.file.read(length)
bgneal@1 1105 if self.endian == 'I':
bgneal@1 1106 val=s2n_intel(slice)
bgneal@1 1107 else:
bgneal@1 1108 val=s2n_motorola(slice)
bgneal@1 1109 # Sign extension ?
bgneal@1 1110 if signed:
bgneal@1 1111 msb=1L << (8*length-1)
bgneal@1 1112 if val & msb:
bgneal@1 1113 val=val-(msb << 1)
bgneal@1 1114 return val
bgneal@1 1115
bgneal@1 1116 # convert offset to string
bgneal@1 1117 def n2s(self, offset, length):
bgneal@1 1118 s = ''
bgneal@1 1119 for dummy in range(length):
bgneal@1 1120 if self.endian == 'I':
bgneal@1 1121 s = s + chr(offset & 0xFF)
bgneal@1 1122 else:
bgneal@1 1123 s = chr(offset & 0xFF) + s
bgneal@1 1124 offset = offset >> 8
bgneal@1 1125 return s
bgneal@1 1126
bgneal@1 1127 # return first IFD
bgneal@1 1128 def first_IFD(self):
bgneal@1 1129 return self.s2n(4, 4)
bgneal@1 1130
bgneal@1 1131 # return pointer to next IFD
bgneal@1 1132 def next_IFD(self, ifd):
bgneal@1 1133 entries=self.s2n(ifd, 2)
bgneal@1 1134 return self.s2n(ifd+2+12*entries, 4)
bgneal@1 1135
bgneal@1 1136 # return list of IFDs in header
bgneal@1 1137 def list_IFDs(self):
bgneal@1 1138 i=self.first_IFD()
bgneal@1 1139 a=[]
bgneal@1 1140 while i:
bgneal@1 1141 a.append(i)
bgneal@1 1142 i=self.next_IFD(i)
bgneal@1 1143 return a
bgneal@1 1144
bgneal@1 1145 # return list of entries in this IFD
bgneal@1 1146 def dump_IFD(self, ifd, ifd_name, dict=EXIF_TAGS, relative=0, stop_tag='UNDEF'):
bgneal@1 1147 entries=self.s2n(ifd, 2)
bgneal@1 1148 for i in range(entries):
bgneal@1 1149 # entry is index of start of this IFD in the file
bgneal@1 1150 entry = ifd + 2 + 12 * i
bgneal@1 1151 tag = self.s2n(entry, 2)
bgneal@1 1152
bgneal@1 1153 # get tag name early to avoid errors, help debug
bgneal@1 1154 tag_entry = dict.get(tag)
bgneal@1 1155 if tag_entry:
bgneal@1 1156 tag_name = tag_entry[0]
bgneal@1 1157 else:
bgneal@1 1158 tag_name = 'Tag 0x%04X' % tag
bgneal@1 1159
bgneal@1 1160 # ignore certain tags for faster processing
bgneal@1 1161 if not (not detailed and tag in IGNORE_TAGS):
bgneal@1 1162 field_type = self.s2n(entry + 2, 2)
bgneal@1 1163 if not 0 < field_type < len(FIELD_TYPES):
bgneal@1 1164 # unknown field type
bgneal@1 1165 raise ValueError('unknown type %d in tag 0x%04X' % (field_type, tag))
bgneal@1 1166 typelen = FIELD_TYPES[field_type][0]
bgneal@1 1167 count = self.s2n(entry + 4, 4)
bgneal@1 1168 offset = entry + 8
bgneal@1 1169 if count * typelen > 4:
bgneal@1 1170 # offset is not the value; it's a pointer to the value
bgneal@1 1171 # if relative we set things up so s2n will seek to the right
bgneal@1 1172 # place when it adds self.offset. Note that this 'relative'
bgneal@1 1173 # is for the Nikon type 3 makernote. Other cameras may use
bgneal@1 1174 # other relative offsets, which would have to be computed here
bgneal@1 1175 # slightly differently.
bgneal@1 1176 if relative:
bgneal@1 1177 tmp_offset = self.s2n(offset, 4)
bgneal@1 1178 offset = tmp_offset + ifd - self.offset + 4
bgneal@1 1179 if self.fake_exif:
bgneal@1 1180 offset = offset + 18
bgneal@1 1181 else:
bgneal@1 1182 offset = self.s2n(offset, 4)
bgneal@1 1183 field_offset = offset
bgneal@1 1184 if field_type == 2:
bgneal@1 1185 # special case: null-terminated ASCII string
bgneal@1 1186 if count != 0:
bgneal@1 1187 self.file.seek(self.offset + offset)
bgneal@1 1188 values = self.file.read(count)
bgneal@1 1189 values = values.strip().replace('\x00', '')
bgneal@1 1190 else:
bgneal@1 1191 values = ''
bgneal@1 1192 else:
bgneal@1 1193 values = []
bgneal@1 1194 signed = (field_type in [6, 8, 9, 10])
bgneal@1 1195 for dummy in range(count):
bgneal@1 1196 if field_type in (5, 10):
bgneal@1 1197 # a ratio
bgneal@1 1198 value = Ratio(self.s2n(offset, 4, signed),
bgneal@1 1199 self.s2n(offset + 4, 4, signed))
bgneal@1 1200 else:
bgneal@1 1201 value = self.s2n(offset, typelen, signed)
bgneal@1 1202 values.append(value)
bgneal@1 1203 offset = offset + typelen
bgneal@1 1204 # now "values" is either a string or an array
bgneal@1 1205 if count == 1 and field_type != 2:
bgneal@1 1206 printable=str(values[0])
bgneal@1 1207 else:
bgneal@1 1208 printable=str(values)
bgneal@1 1209 # compute printable version of values
bgneal@1 1210 if tag_entry:
bgneal@1 1211 if len(tag_entry) != 1:
bgneal@1 1212 # optional 2nd tag element is present
bgneal@1 1213 if callable(tag_entry[1]):
bgneal@1 1214 # call mapping function
bgneal@1 1215 printable = tag_entry[1](values)
bgneal@1 1216 else:
bgneal@1 1217 printable = ''
bgneal@1 1218 for i in values:
bgneal@1 1219 # use lookup table for this tag
bgneal@1 1220 printable += tag_entry[1].get(i, repr(i))
bgneal@1 1221
bgneal@1 1222 self.tags[ifd_name + ' ' + tag_name] = IFD_Tag(printable, tag,
bgneal@1 1223 field_type,
bgneal@1 1224 values, field_offset,
bgneal@1 1225 count * typelen)
bgneal@1 1226 if self.debug:
bgneal@1 1227 print ' debug: %s: %s' % (tag_name,
bgneal@1 1228 repr(self.tags[ifd_name + ' ' + tag_name]))
bgneal@1 1229
bgneal@1 1230 if tag_name == stop_tag:
bgneal@1 1231 break
bgneal@1 1232
bgneal@1 1233 # extract uncompressed TIFF thumbnail (like pulling teeth)
bgneal@1 1234 # we take advantage of the pre-existing layout in the thumbnail IFD as
bgneal@1 1235 # much as possible
bgneal@1 1236 def extract_TIFF_thumbnail(self, thumb_ifd):
bgneal@1 1237 entries = self.s2n(thumb_ifd, 2)
bgneal@1 1238 # this is header plus offset to IFD ...
bgneal@1 1239 if self.endian == 'M':
bgneal@1 1240 tiff = 'MM\x00*\x00\x00\x00\x08'
bgneal@1 1241 else:
bgneal@1 1242 tiff = 'II*\x00\x08\x00\x00\x00'
bgneal@1 1243 # ... plus thumbnail IFD data plus a null "next IFD" pointer
bgneal@1 1244 self.file.seek(self.offset+thumb_ifd)
bgneal@1 1245 tiff += self.file.read(entries*12+2)+'\x00\x00\x00\x00'
bgneal@1 1246
bgneal@1 1247 # fix up large value offset pointers into data area
bgneal@1 1248 for i in range(entries):
bgneal@1 1249 entry = thumb_ifd + 2 + 12 * i
bgneal@1 1250 tag = self.s2n(entry, 2)
bgneal@1 1251 field_type = self.s2n(entry+2, 2)
bgneal@1 1252 typelen = FIELD_TYPES[field_type][0]
bgneal@1 1253 count = self.s2n(entry+4, 4)
bgneal@1 1254 oldoff = self.s2n(entry+8, 4)
bgneal@1 1255 # start of the 4-byte pointer area in entry
bgneal@1 1256 ptr = i * 12 + 18
bgneal@1 1257 # remember strip offsets location
bgneal@1 1258 if tag == 0x0111:
bgneal@1 1259 strip_off = ptr
bgneal@1 1260 strip_len = count * typelen
bgneal@1 1261 # is it in the data area?
bgneal@1 1262 if count * typelen > 4:
bgneal@1 1263 # update offset pointer (nasty "strings are immutable" crap)
bgneal@1 1264 # should be able to say "tiff[ptr:ptr+4]=newoff"
bgneal@1 1265 newoff = len(tiff)
bgneal@1 1266 tiff = tiff[:ptr] + self.n2s(newoff, 4) + tiff[ptr+4:]
bgneal@1 1267 # remember strip offsets location
bgneal@1 1268 if tag == 0x0111:
bgneal@1 1269 strip_off = newoff
bgneal@1 1270 strip_len = 4
bgneal@1 1271 # get original data and store it
bgneal@1 1272 self.file.seek(self.offset + oldoff)
bgneal@1 1273 tiff += self.file.read(count * typelen)
bgneal@1 1274
bgneal@1 1275 # add pixel strips and update strip offset info
bgneal@1 1276 old_offsets = self.tags['Thumbnail StripOffsets'].values
bgneal@1 1277 old_counts = self.tags['Thumbnail StripByteCounts'].values
bgneal@1 1278 for i in range(len(old_offsets)):
bgneal@1 1279 # update offset pointer (more nasty "strings are immutable" crap)
bgneal@1 1280 offset = self.n2s(len(tiff), strip_len)
bgneal@1 1281 tiff = tiff[:strip_off] + offset + tiff[strip_off + strip_len:]
bgneal@1 1282 strip_off += strip_len
bgneal@1 1283 # add pixel strip to end
bgneal@1 1284 self.file.seek(self.offset + old_offsets[i])
bgneal@1 1285 tiff += self.file.read(old_counts[i])
bgneal@1 1286
bgneal@1 1287 self.tags['TIFFThumbnail'] = tiff
bgneal@1 1288
bgneal@1 1289 # decode all the camera-specific MakerNote formats
bgneal@1 1290
bgneal@1 1291 # Note is the data that comprises this MakerNote. The MakerNote will
bgneal@1 1292 # likely have pointers in it that point to other parts of the file. We'll
bgneal@1 1293 # use self.offset as the starting point for most of those pointers, since
bgneal@1 1294 # they are relative to the beginning of the file.
bgneal@1 1295 #
bgneal@1 1296 # If the MakerNote is in a newer format, it may use relative addressing
bgneal@1 1297 # within the MakerNote. In that case we'll use relative addresses for the
bgneal@1 1298 # pointers.
bgneal@1 1299 #
bgneal@1 1300 # As an aside: it's not just to be annoying that the manufacturers use
bgneal@1 1301 # relative offsets. It's so that if the makernote has to be moved by the
bgneal@1 1302 # picture software all of the offsets don't have to be adjusted. Overall,
bgneal@1 1303 # this is probably the right strategy for makernotes, though the spec is
bgneal@1 1304 # ambiguous. (The spec does not appear to imagine that makernotes would
bgneal@1 1305 # follow EXIF format internally. Once they did, it's ambiguous whether
bgneal@1 1306 # the offsets should be from the header at the start of all the EXIF info,
bgneal@1 1307 # or from the header at the start of the makernote.)
bgneal@1 1308 def decode_maker_note(self):
bgneal@1 1309 note = self.tags['EXIF MakerNote']
bgneal@1 1310 make = self.tags['Image Make'].printable
bgneal@1 1311 # model = self.tags['Image Model'].printable # unused
bgneal@1 1312
bgneal@1 1313 # Nikon
bgneal@1 1314 # The maker note usually starts with the word Nikon, followed by the
bgneal@1 1315 # type of the makernote (1 or 2, as a short). If the word Nikon is
bgneal@1 1316 # not at the start of the makernote, it's probably type 2, since some
bgneal@1 1317 # cameras work that way.
bgneal@1 1318 if make in ('NIKON', 'NIKON CORPORATION'):
bgneal@1 1319 if note.values[0:7] == [78, 105, 107, 111, 110, 0, 1]:
bgneal@1 1320 if self.debug:
bgneal@1 1321 print "Looks like a type 1 Nikon MakerNote."
bgneal@1 1322 self.dump_IFD(note.field_offset+8, 'MakerNote',
bgneal@1 1323 dict=MAKERNOTE_NIKON_OLDER_TAGS)
bgneal@1 1324 elif note.values[0:7] == [78, 105, 107, 111, 110, 0, 2]:
bgneal@1 1325 if self.debug:
bgneal@1 1326 print "Looks like a labeled type 2 Nikon MakerNote"
bgneal@1 1327 if note.values[12:14] != [0, 42] and note.values[12:14] != [42L, 0L]:
bgneal@1 1328 raise ValueError("Missing marker tag '42' in MakerNote.")
bgneal@1 1329 # skip the Makernote label and the TIFF header
bgneal@1 1330 self.dump_IFD(note.field_offset+10+8, 'MakerNote',
bgneal@1 1331 dict=MAKERNOTE_NIKON_NEWER_TAGS, relative=1)
bgneal@1 1332 else:
bgneal@1 1333 # E99x or D1
bgneal@1 1334 if self.debug:
bgneal@1 1335 print "Looks like an unlabeled type 2 Nikon MakerNote"
bgneal@1 1336 self.dump_IFD(note.field_offset, 'MakerNote',
bgneal@1 1337 dict=MAKERNOTE_NIKON_NEWER_TAGS)
bgneal@1 1338 return
bgneal@1 1339
bgneal@1 1340 # Olympus
bgneal@1 1341 if make.startswith('OLYMPUS'):
bgneal@1 1342 self.dump_IFD(note.field_offset+8, 'MakerNote',
bgneal@1 1343 dict=MAKERNOTE_OLYMPUS_TAGS)
bgneal@1 1344 # TODO
bgneal@1 1345 #for i in (('MakerNote Tag 0x2020', MAKERNOTE_OLYMPUS_TAG_0x2020),):
bgneal@1 1346 # self.decode_olympus_tag(self.tags[i[0]].values, i[1])
bgneal@1 1347 #return
bgneal@1 1348
bgneal@1 1349 # Casio
bgneal@1 1350 if make == 'Casio':
bgneal@1 1351 self.dump_IFD(note.field_offset, 'MakerNote',
bgneal@1 1352 dict=MAKERNOTE_CASIO_TAGS)
bgneal@1 1353 return
bgneal@1 1354
bgneal@1 1355 # Fujifilm
bgneal@1 1356 if make == 'FUJIFILM':
bgneal@1 1357 # bug: everything else is "Motorola" endian, but the MakerNote
bgneal@1 1358 # is "Intel" endian
bgneal@1 1359 endian = self.endian
bgneal@1 1360 self.endian = 'I'
bgneal@1 1361 # bug: IFD offsets are from beginning of MakerNote, not
bgneal@1 1362 # beginning of file header
bgneal@1 1363 offset = self.offset
bgneal@1 1364 self.offset += note.field_offset
bgneal@1 1365 # process note with bogus values (note is actually at offset 12)
bgneal@1 1366 self.dump_IFD(12, 'MakerNote', dict=MAKERNOTE_FUJIFILM_TAGS)
bgneal@1 1367 # reset to correct values
bgneal@1 1368 self.endian = endian
bgneal@1 1369 self.offset = offset
bgneal@1 1370 return
bgneal@1 1371
bgneal@1 1372 # Canon
bgneal@1 1373 if make == 'Canon':
bgneal@1 1374 self.dump_IFD(note.field_offset, 'MakerNote',
bgneal@1 1375 dict=MAKERNOTE_CANON_TAGS)
bgneal@1 1376 for i in (('MakerNote Tag 0x0001', MAKERNOTE_CANON_TAG_0x001),
bgneal@1 1377 ('MakerNote Tag 0x0004', MAKERNOTE_CANON_TAG_0x004)):
bgneal@1 1378 self.canon_decode_tag(self.tags[i[0]].values, i[1])
bgneal@1 1379 return
bgneal@1 1380
bgneal@1 1381 # decode Olympus MakerNote tag based on offset within tag
bgneal@1 1382 def olympus_decode_tag(self, value, dict):
bgneal@1 1383 pass
bgneal@1 1384
bgneal@1 1385 # decode Canon MakerNote tag based on offset within tag
bgneal@1 1386 # see http://www.burren.cx/david/canon.html by David Burren
bgneal@1 1387 def canon_decode_tag(self, value, dict):
bgneal@1 1388 for i in range(1, len(value)):
bgneal@1 1389 x=dict.get(i, ('Unknown', ))
bgneal@1 1390 if self.debug:
bgneal@1 1391 print i, x
bgneal@1 1392 name=x[0]
bgneal@1 1393 if len(x) > 1:
bgneal@1 1394 val=x[1].get(value[i], 'Unknown')
bgneal@1 1395 else:
bgneal@1 1396 val=value[i]
bgneal@1 1397 # it's not a real IFD Tag but we fake one to make everybody
bgneal@1 1398 # happy. this will have a "proprietary" type
bgneal@1 1399 self.tags['MakerNote '+name]=IFD_Tag(str(val), None, 0, None,
bgneal@1 1400 None, None)
bgneal@1 1401
bgneal@1 1402 # process an image file (expects an open file object)
bgneal@1 1403 # this is the function that has to deal with all the arbitrary nasty bits
bgneal@1 1404 # of the EXIF standard
bgneal@1 1405 def process_file(f, stop_tag='UNDEF', details=True, debug=False):
bgneal@1 1406 # yah it's cheesy...
bgneal@1 1407 global detailed
bgneal@1 1408 detailed = details
bgneal@1 1409
bgneal@1 1410 # by default do not fake an EXIF beginning
bgneal@1 1411 fake_exif = 0
bgneal@1 1412
bgneal@1 1413 # determine whether it's a JPEG or TIFF
bgneal@1 1414 data = f.read(12)
bgneal@1 1415 if data[0:4] in ['II*\x00', 'MM\x00*']:
bgneal@1 1416 # it's a TIFF file
bgneal@1 1417 f.seek(0)
bgneal@1 1418 endian = f.read(1)
bgneal@1 1419 f.read(1)
bgneal@1 1420 offset = 0
bgneal@1 1421 elif data[0:2] == '\xFF\xD8':
bgneal@1 1422 # it's a JPEG file
bgneal@1 1423 while data[2] == '\xFF' and data[6:10] in ('JFIF', 'JFXX', 'OLYM', 'Phot'):
bgneal@1 1424 length = ord(data[4])*256+ord(data[5])
bgneal@1 1425 f.read(length-8)
bgneal@1 1426 # fake an EXIF beginning of file
bgneal@1 1427 data = '\xFF\x00'+f.read(10)
bgneal@1 1428 fake_exif = 1
bgneal@1 1429 if data[2] == '\xFF' and data[6:10] == 'Exif':
bgneal@1 1430 # detected EXIF header
bgneal@1 1431 offset = f.tell()
bgneal@1 1432 endian = f.read(1)
bgneal@1 1433 else:
bgneal@1 1434 # no EXIF information
bgneal@1 1435 return {}
bgneal@1 1436 else:
bgneal@1 1437 # file format not recognized
bgneal@1 1438 return {}
bgneal@1 1439
bgneal@1 1440 # deal with the EXIF info we found
bgneal@1 1441 if debug:
bgneal@1 1442 print {'I': 'Intel', 'M': 'Motorola'}[endian], 'format'
bgneal@1 1443 hdr = EXIF_header(f, endian, offset, fake_exif, debug)
bgneal@1 1444 ifd_list = hdr.list_IFDs()
bgneal@1 1445 ctr = 0
bgneal@1 1446 for i in ifd_list:
bgneal@1 1447 if ctr == 0:
bgneal@1 1448 IFD_name = 'Image'
bgneal@1 1449 elif ctr == 1:
bgneal@1 1450 IFD_name = 'Thumbnail'
bgneal@1 1451 thumb_ifd = i
bgneal@1 1452 else:
bgneal@1 1453 IFD_name = 'IFD %d' % ctr
bgneal@1 1454 if debug:
bgneal@1 1455 print ' IFD %d (%s) at offset %d:' % (ctr, IFD_name, i)
bgneal@1 1456 hdr.dump_IFD(i, IFD_name, stop_tag=stop_tag)
bgneal@1 1457 # EXIF IFD
bgneal@1 1458 exif_off = hdr.tags.get(IFD_name+' ExifOffset')
bgneal@1 1459 if exif_off:
bgneal@1 1460 if debug:
bgneal@1 1461 print ' EXIF SubIFD at offset %d:' % exif_off.values[0]
bgneal@1 1462 hdr.dump_IFD(exif_off.values[0], 'EXIF', stop_tag=stop_tag)
bgneal@1 1463 # Interoperability IFD contained in EXIF IFD
bgneal@1 1464 intr_off = hdr.tags.get('EXIF SubIFD InteroperabilityOffset')
bgneal@1 1465 if intr_off:
bgneal@1 1466 if debug:
bgneal@1 1467 print ' EXIF Interoperability SubSubIFD at offset %d:' \
bgneal@1 1468 % intr_off.values[0]
bgneal@1 1469 hdr.dump_IFD(intr_off.values[0], 'EXIF Interoperability',
bgneal@1 1470 dict=INTR_TAGS, stop_tag=stop_tag)
bgneal@1 1471 # GPS IFD
bgneal@1 1472 gps_off = hdr.tags.get(IFD_name+' GPSInfo')
bgneal@1 1473 if gps_off:
bgneal@1 1474 if debug:
bgneal@1 1475 print ' GPS SubIFD at offset %d:' % gps_off.values[0]
bgneal@1 1476 hdr.dump_IFD(gps_off.values[0], 'GPS', dict=GPS_TAGS, stop_tag=stop_tag)
bgneal@1 1477 ctr += 1
bgneal@1 1478
bgneal@1 1479 # extract uncompressed TIFF thumbnail
bgneal@1 1480 thumb = hdr.tags.get('Thumbnail Compression')
bgneal@1 1481 if thumb and thumb.printable == 'Uncompressed TIFF':
bgneal@1 1482 hdr.extract_TIFF_thumbnail(thumb_ifd)
bgneal@1 1483
bgneal@1 1484 # JPEG thumbnail (thankfully the JPEG data is stored as a unit)
bgneal@1 1485 thumb_off = hdr.tags.get('Thumbnail JPEGInterchangeFormat')
bgneal@1 1486 if thumb_off:
bgneal@1 1487 f.seek(offset+thumb_off.values[0])
bgneal@1 1488 size = hdr.tags['Thumbnail JPEGInterchangeFormatLength'].values[0]
bgneal@1 1489 hdr.tags['JPEGThumbnail'] = f.read(size)
bgneal@1 1490
bgneal@1 1491 # deal with MakerNote contained in EXIF IFD
bgneal@1 1492 if 'EXIF MakerNote' in hdr.tags and detailed:
bgneal@1 1493 hdr.decode_maker_note()
bgneal@1 1494
bgneal@1 1495 # Sometimes in a TIFF file, a JPEG thumbnail is hidden in the MakerNote
bgneal@1 1496 # since it's not allowed in a uncompressed TIFF IFD
bgneal@1 1497 if 'JPEGThumbnail' not in hdr.tags:
bgneal@1 1498 thumb_off=hdr.tags.get('MakerNote JPEGThumbnail')
bgneal@1 1499 if thumb_off:
bgneal@1 1500 f.seek(offset+thumb_off.values[0])
bgneal@1 1501 hdr.tags['JPEGThumbnail']=file.read(thumb_off.field_length)
bgneal@1 1502
bgneal@1 1503 return hdr.tags
bgneal@1 1504
bgneal@1 1505
bgneal@1 1506 # show command line usage
bgneal@1 1507 def usage(exit_status):
bgneal@1 1508 msg = 'Usage: EXIF.py [OPTIONS] file1 [file2 ...]\n'
bgneal@1 1509 msg += 'Extract EXIF information from digital camera image files.\n\nOptions:\n'
bgneal@1 1510 msg += '-q --quick Do not process MakerNotes.\n'
bgneal@1 1511 msg += '-t TAG --stop-tag TAG Stop processing when this tag is retrieved.\n'
bgneal@1 1512 msg += '-d --debug Run in debug mode.\n'
bgneal@1 1513 print msg
bgneal@1 1514 sys.exit(exit_status)
bgneal@1 1515
bgneal@1 1516 # library test/debug function (dump given files)
bgneal@1 1517 if __name__ == '__main__':
bgneal@1 1518 import sys
bgneal@1 1519 import getopt
bgneal@1 1520
bgneal@1 1521 # parse command line options/arguments
bgneal@1 1522 try:
bgneal@1 1523 opts, args = getopt.getopt(sys.argv[1:], "hqdt:v", ["help", "quick", "debug", "stop-tag="])
bgneal@1 1524 except getopt.GetoptError:
bgneal@1 1525 usage(2)
bgneal@1 1526 if args == []:
bgneal@1 1527 usage(2)
bgneal@1 1528 detailed = True
bgneal@1 1529 stop_tag = 'UNDEF'
bgneal@1 1530 debug = False
bgneal@1 1531 for o, a in opts:
bgneal@1 1532 if o in ("-h", "--help"):
bgneal@1 1533 usage(0)
bgneal@1 1534 if o in ("-q", "--quick"):
bgneal@1 1535 detailed = False
bgneal@1 1536 if o in ("-t", "--stop-tag"):
bgneal@1 1537 stop_tag = a
bgneal@1 1538 if o in ("-d", "--debug"):
bgneal@1 1539 debug = True
bgneal@1 1540
bgneal@1 1541 # output info for each file
bgneal@1 1542 for filename in args:
bgneal@1 1543 try:
bgneal@1 1544 file=open(filename, 'rb')
bgneal@1 1545 except:
bgneal@1 1546 print "'%s' is unreadable\n"%filename
bgneal@1 1547 continue
bgneal@1 1548 print filename + ':'
bgneal@1 1549 # get the tags
bgneal@1 1550 data = process_file(file, stop_tag=stop_tag, details=detailed, debug=debug)
bgneal@1 1551 if not data:
bgneal@1 1552 print 'No EXIF information found'
bgneal@1 1553 continue
bgneal@1 1554
bgneal@1 1555 x=data.keys()
bgneal@1 1556 x.sort()
bgneal@1 1557 for i in x:
bgneal@1 1558 if i in ('JPEGThumbnail', 'TIFFThumbnail'):
bgneal@1 1559 continue
bgneal@1 1560 try:
bgneal@1 1561 print ' %s (%s): %s' % \
bgneal@1 1562 (i, FIELD_TYPES[data[i].field_type][2], data[i].printable)
bgneal@1 1563 except:
bgneal@1 1564 print 'error', i, '"', data[i], '"'
bgneal@1 1565 if 'JPEGThumbnail' in data:
bgneal@1 1566 print 'File has JPEG thumbnail'
bgneal@1 1567 print
bgneal@1 1568