+++ /dev/null
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-#
-#
-# Library to extract EXIF information from digital camera image files.
-# https://github.com/ianare/exif-py
-#
-#
-# VERSION 1.1.0
-#
-# To use this library call with:
-# f = open(path_name, 'rb')
-# tags = EXIF.process_file(f)
-#
-# To ignore MakerNote tags, pass the -q or --quick
-# command line arguments, or as
-# tags = EXIF.process_file(f, details=False)
-#
-# To stop processing after a certain tag is retrieved,
-# pass the -t TAG or --stop-tag TAG argument, or as
-# tags = EXIF.process_file(f, stop_tag='TAG')
-#
-# where TAG is a valid tag name, ex 'DateTimeOriginal'
-#
-# These 2 are useful when you are retrieving a large list of images
-#
-# To return an error on invalid tags,
-# pass the -s or --strict argument, or as
-# tags = EXIF.process_file(f, strict=True)
-#
-# Otherwise these tags will be ignored
-#
-# Returned tags will be a dictionary mapping names of EXIF tags to their
-# values in the file named by path_name. You can process the tags
-# as you wish. In particular, you can iterate through all the tags with:
-# for tag in tags.keys():
-# if tag not in ('JPEGThumbnail', 'TIFFThumbnail', 'Filename',
-# 'EXIF MakerNote'):
-# print "Key: %s, value %s" % (tag, tags[tag])
-# (This code uses the if statement to avoid printing out a few of the
-# tags that tend to be long or boring.)
-#
-# The tags dictionary will include keys for all of the usual EXIF
-# tags, and will also include keys for Makernotes used by some
-# cameras, for which we have a good specification.
-#
-# Note that the dictionary keys are the IFD name followed by the
-# tag name. For example:
-# 'EXIF DateTimeOriginal', 'Image Orientation', 'MakerNote FocusMode'
-#
-# Copyright (c) 2002-2007 Gene Cash All rights reserved
-# Copyright (c) 2007-2012 Ianaré Sévi All rights reserved
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions
-# are met:
-#
-# 1. Redistributions of source code must retain the above copyright
-# notice, this list of conditions and the following disclaimer.
-#
-# 2. Redistributions in binary form must reproduce the above
-# copyright notice, this list of conditions and the following
-# disclaimer in the documentation and/or other materials provided
-# with the distribution.
-#
-# 3. Neither the name of the authors nor the names of its contributors
-# may be used to endorse or promote products derived from this
-# software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-#
-#
-# ----- See 'changes.txt' file for all contributors and changes ----- #
-#
-
-
-# Don't throw an exception when given an out of range character.
-def make_string(seq):
- str = ''
- for c in seq:
- # Screen out non-printing characters
- if 32 <= c and c < 256:
- str += chr(c)
- # If no printing chars
- if not str:
- return seq
- return str
-
-# Special version to deal with the code in the first 8 bytes of a user comment.
-# First 8 bytes gives coding system e.g. ASCII vs. JIS vs Unicode
-def make_string_uc(seq):
- code = seq[0:8]
- seq = seq[8:]
- # Of course, this is only correct if ASCII, and the standard explicitly
- # allows JIS and Unicode.
- return make_string( make_string(seq) )
-
-# field type descriptions as (length, abbreviation, full name) tuples
-FIELD_TYPES = (
- (0, 'X', 'Proprietary'), # no such type
- (1, 'B', 'Byte'),
- (1, 'A', 'ASCII'),
- (2, 'S', 'Short'),
- (4, 'L', 'Long'),
- (8, 'R', 'Ratio'),
- (1, 'SB', 'Signed Byte'),
- (1, 'U', 'Undefined'),
- (2, 'SS', 'Signed Short'),
- (4, 'SL', 'Signed Long'),
- (8, 'SR', 'Signed Ratio'),
- )
-
-# dictionary of main EXIF tag names
-# first element of tuple is tag name, optional second element is
-# another dictionary giving names to values
-EXIF_TAGS = {
- 0x0100: ('ImageWidth', ),
- 0x0101: ('ImageLength', ),
- 0x0102: ('BitsPerSample', ),
- 0x0103: ('Compression',
- {1: 'Uncompressed',
- 2: 'CCITT 1D',
- 3: 'T4/Group 3 Fax',
- 4: 'T6/Group 4 Fax',
- 5: 'LZW',
- 6: 'JPEG (old-style)',
- 7: 'JPEG',
- 8: 'Adobe Deflate',
- 9: 'JBIG B&W',
- 10: 'JBIG Color',
- 32766: 'Next',
- 32769: 'Epson ERF Compressed',
- 32771: 'CCIRLEW',
- 32773: 'PackBits',
- 32809: 'Thunderscan',
- 32895: 'IT8CTPAD',
- 32896: 'IT8LW',
- 32897: 'IT8MP',
- 32898: 'IT8BL',
- 32908: 'PixarFilm',
- 32909: 'PixarLog',
- 32946: 'Deflate',
- 32947: 'DCS',
- 34661: 'JBIG',
- 34676: 'SGILog',
- 34677: 'SGILog24',
- 34712: 'JPEG 2000',
- 34713: 'Nikon NEF Compressed',
- 65000: 'Kodak DCR Compressed',
- 65535: 'Pentax PEF Compressed'}),
- 0x0106: ('PhotometricInterpretation', ),
- 0x0107: ('Thresholding', ),
- 0x010A: ('FillOrder', ),
- 0x010D: ('DocumentName', ),
- 0x010E: ('ImageDescription', ),
- 0x010F: ('Make', ),
- 0x0110: ('Model', ),
- 0x0111: ('StripOffsets', ),
- 0x0112: ('Orientation',
- {1: 'Horizontal (normal)',
- 2: 'Mirrored horizontal',
- 3: 'Rotated 180',
- 4: 'Mirrored vertical',
- 5: 'Mirrored horizontal then rotated 90 CCW',
- 6: 'Rotated 90 CCW',
- 7: 'Mirrored horizontal then rotated 90 CW',
- 8: 'Rotated 90 CW'}),
- 0x0115: ('SamplesPerPixel', ),
- 0x0116: ('RowsPerStrip', ),
- 0x0117: ('StripByteCounts', ),
- 0x011A: ('XResolution', ),
- 0x011B: ('YResolution', ),
- 0x011C: ('PlanarConfiguration', ),
- 0x011D: ('PageName', make_string),
- 0x0128: ('ResolutionUnit',
- {1: 'Not Absolute',
- 2: 'Pixels/Inch',
- 3: 'Pixels/Centimeter'}),
- 0x012D: ('TransferFunction', ),
- 0x0131: ('Software', ),
- 0x0132: ('DateTime', ),
- 0x013B: ('Artist', ),
- 0x013E: ('WhitePoint', ),
- 0x013F: ('PrimaryChromaticities', ),
- 0x0156: ('TransferRange', ),
- 0x0200: ('JPEGProc', ),
- 0x0201: ('JPEGInterchangeFormat', ),
- 0x0202: ('JPEGInterchangeFormatLength', ),
- 0x0211: ('YCbCrCoefficients', ),
- 0x0212: ('YCbCrSubSampling', ),
- 0x0213: ('YCbCrPositioning',
- {1: 'Centered',
- 2: 'Co-sited'}),
- 0x0214: ('ReferenceBlackWhite', ),
-
- 0x4746: ('Rating', ),
-
- 0x828D: ('CFARepeatPatternDim', ),
- 0x828E: ('CFAPattern', ),
- 0x828F: ('BatteryLevel', ),
- 0x8298: ('Copyright', ),
- 0x829A: ('ExposureTime', ),
- 0x829D: ('FNumber', ),
- 0x83BB: ('IPTC/NAA', ),
- 0x8769: ('ExifOffset', ),
- 0x8773: ('InterColorProfile', ),
- 0x8822: ('ExposureProgram',
- {0: 'Unidentified',
- 1: 'Manual',
- 2: 'Program Normal',
- 3: 'Aperture Priority',
- 4: 'Shutter Priority',
- 5: 'Program Creative',
- 6: 'Program Action',
- 7: 'Portrait Mode',
- 8: 'Landscape Mode'}),
- 0x8824: ('SpectralSensitivity', ),
- 0x8825: ('GPSInfo', ),
- 0x8827: ('ISOSpeedRatings', ),
- 0x8828: ('OECF', ),
- 0x9000: ('ExifVersion', make_string),
- 0x9003: ('DateTimeOriginal', ),
- 0x9004: ('DateTimeDigitized', ),
- 0x9101: ('ComponentsConfiguration',
- {0: '',
- 1: 'Y',
- 2: 'Cb',
- 3: 'Cr',
- 4: 'Red',
- 5: 'Green',
- 6: 'Blue'}),
- 0x9102: ('CompressedBitsPerPixel', ),
- 0x9201: ('ShutterSpeedValue', ),
- 0x9202: ('ApertureValue', ),
- 0x9203: ('BrightnessValue', ),
- 0x9204: ('ExposureBiasValue', ),
- 0x9205: ('MaxApertureValue', ),
- 0x9206: ('SubjectDistance', ),
- 0x9207: ('MeteringMode',
- {0: 'Unidentified',
- 1: 'Average',
- 2: 'CenterWeightedAverage',
- 3: 'Spot',
- 4: 'MultiSpot',
- 5: 'Pattern',
- 6: 'Partial',
- 255: 'other'}),
- 0x9208: ('LightSource',
- {0: 'Unknown',
- 1: 'Daylight',
- 2: 'Fluorescent',
- 3: 'Tungsten (incandescent light)',
- 4: 'Flash',
- 9: 'Fine weather',
- 10: 'Cloudy weather',
- 11: 'Shade',
- 12: 'Daylight fluorescent (D 5700 - 7100K)',
- 13: 'Day white fluorescent (N 4600 - 5400K)',
- 14: 'Cool white fluorescent (W 3900 - 4500K)',
- 15: 'White fluorescent (WW 3200 - 3700K)',
- 17: 'Standard light A',
- 18: 'Standard light B',
- 19: 'Standard light C',
- 20: 'D55',
- 21: 'D65',
- 22: 'D75',
- 23: 'D50',
- 24: 'ISO studio tungsten',
- 255: 'other light source',}),
- 0x9209: ('Flash',
- {0: 'Flash did not fire',
- 1: 'Flash fired',
- 5: 'Strobe return light not detected',
- 7: 'Strobe return light detected',
- 9: 'Flash fired, compulsory flash mode',
- 13: 'Flash fired, compulsory flash mode, return light not detected',
- 15: 'Flash fired, compulsory flash mode, return light detected',
- 16: 'Flash did not fire, compulsory flash mode',
- 24: 'Flash did not fire, auto mode',
- 25: 'Flash fired, auto mode',
- 29: 'Flash fired, auto mode, return light not detected',
- 31: 'Flash fired, auto mode, return light detected',
- 32: 'No flash function',
- 65: 'Flash fired, red-eye reduction mode',
- 69: 'Flash fired, red-eye reduction mode, return light not detected',
- 71: 'Flash fired, red-eye reduction mode, return light detected',
- 73: 'Flash fired, compulsory flash mode, red-eye reduction mode',
- 77: 'Flash fired, compulsory flash mode, red-eye reduction mode, return light not detected',
- 79: 'Flash fired, compulsory flash mode, red-eye reduction mode, return light detected',
- 89: 'Flash fired, auto mode, red-eye reduction mode',
- 93: 'Flash fired, auto mode, return light not detected, red-eye reduction mode',
- 95: 'Flash fired, auto mode, return light detected, red-eye reduction mode'}),
- 0x920A: ('FocalLength', ),
- 0x9214: ('SubjectArea', ),
- 0x927C: ('MakerNote', ),
- 0x9286: ('UserComment', make_string_uc),
- 0x9290: ('SubSecTime', ),
- 0x9291: ('SubSecTimeOriginal', ),
- 0x9292: ('SubSecTimeDigitized', ),
-
- # used by Windows Explorer
- 0x9C9B: ('XPTitle', ),
- 0x9C9C: ('XPComment', ),
- 0x9C9D: ('XPAuthor', ), #(ignored by Windows Explorer if Artist exists)
- 0x9C9E: ('XPKeywords', ),
- 0x9C9F: ('XPSubject', ),
-
- 0xA000: ('FlashPixVersion', make_string),
- 0xA001: ('ColorSpace',
- {1: 'sRGB',
- 2: 'Adobe RGB',
- 65535: 'Uncalibrated'}),
- 0xA002: ('ExifImageWidth', ),
- 0xA003: ('ExifImageLength', ),
- 0xA005: ('InteroperabilityOffset', ),
- 0xA20B: ('FlashEnergy', ), # 0x920B in TIFF/EP
- 0xA20C: ('SpatialFrequencyResponse', ), # 0x920C
- 0xA20E: ('FocalPlaneXResolution', ), # 0x920E
- 0xA20F: ('FocalPlaneYResolution', ), # 0x920F
- 0xA210: ('FocalPlaneResolutionUnit', ), # 0x9210
- 0xA214: ('SubjectLocation', ), # 0x9214
- 0xA215: ('ExposureIndex', ), # 0x9215
- 0xA217: ('SensingMethod', # 0x9217
- {1: 'Not defined',
- 2: 'One-chip color area',
- 3: 'Two-chip color area',
- 4: 'Three-chip color area',
- 5: 'Color sequential area',
- 7: 'Trilinear',
- 8: 'Color sequential linear'}),
- 0xA300: ('FileSource',
- {1: 'Film Scanner',
- 2: 'Reflection Print Scanner',
- 3: 'Digital Camera'}),
- 0xA301: ('SceneType',
- {1: 'Directly Photographed'}),
- 0xA302: ('CVAPattern', ),
- 0xA401: ('CustomRendered',
- {0: 'Normal',
- 1: 'Custom'}),
- 0xA402: ('ExposureMode',
- {0: 'Auto Exposure',
- 1: 'Manual Exposure',
- 2: 'Auto Bracket'}),
- 0xA403: ('WhiteBalance',
- {0: 'Auto',
- 1: 'Manual'}),
- 0xA404: ('DigitalZoomRatio', ),
- 0xA405: ('FocalLengthIn35mmFilm', ),
- 0xA406: ('SceneCaptureType',
- {0: 'Standard',
- 1: 'Landscape',
- 2: 'Portrait',
- 3: 'Night)'}),
- 0xA407: ('GainControl',
- {0: 'None',
- 1: 'Low gain up',
- 2: 'High gain up',
- 3: 'Low gain down',
- 4: 'High gain down'}),
- 0xA408: ('Contrast',
- {0: 'Normal',
- 1: 'Soft',
- 2: 'Hard'}),
- 0xA409: ('Saturation',
- {0: 'Normal',
- 1: 'Soft',
- 2: 'Hard'}),
- 0xA40A: ('Sharpness',
- {0: 'Normal',
- 1: 'Soft',
- 2: 'Hard'}),
- 0xA40B: ('DeviceSettingDescription', ),
- 0xA40C: ('SubjectDistanceRange', ),
- 0xA500: ('Gamma', ),
- 0xC4A5: ('PrintIM', ),
- 0xEA1C: ('Padding', ),
- }
-
-# interoperability tags
-INTR_TAGS = {
- 0x0001: ('InteroperabilityIndex', ),
- 0x0002: ('InteroperabilityVersion', ),
- 0x1000: ('RelatedImageFileFormat', ),
- 0x1001: ('RelatedImageWidth', ),
- 0x1002: ('RelatedImageLength', ),
- }
-
-# GPS tags (not used yet, haven't seen camera with GPS)
-GPS_TAGS = {
- 0x0000: ('GPSVersionID', ),
- 0x0001: ('GPSLatitudeRef', ),
- 0x0002: ('GPSLatitude', ),
- 0x0003: ('GPSLongitudeRef', ),
- 0x0004: ('GPSLongitude', ),
- 0x0005: ('GPSAltitudeRef', ),
- 0x0006: ('GPSAltitude', ),
- 0x0007: ('GPSTimeStamp', ),
- 0x0008: ('GPSSatellites', ),
- 0x0009: ('GPSStatus', ),
- 0x000A: ('GPSMeasureMode', ),
- 0x000B: ('GPSDOP', ),
- 0x000C: ('GPSSpeedRef', ),
- 0x000D: ('GPSSpeed', ),
- 0x000E: ('GPSTrackRef', ),
- 0x000F: ('GPSTrack', ),
- 0x0010: ('GPSImgDirectionRef', ),
- 0x0011: ('GPSImgDirection', ),
- 0x0012: ('GPSMapDatum', ),
- 0x0013: ('GPSDestLatitudeRef', ),
- 0x0014: ('GPSDestLatitude', ),
- 0x0015: ('GPSDestLongitudeRef', ),
- 0x0016: ('GPSDestLongitude', ),
- 0x0017: ('GPSDestBearingRef', ),
- 0x0018: ('GPSDestBearing', ),
- 0x0019: ('GPSDestDistanceRef', ),
- 0x001A: ('GPSDestDistance', ),
- 0x001B: ('GPSProcessingMethod', ),
- 0x001C: ('GPSAreaInformation', ),
- 0x001D: ('GPSDate', ),
- 0x001E: ('GPSDifferential', ),
- }
-
-# Ignore these tags when quick processing
-# 0x927C is MakerNote Tags
-# 0x9286 is user comment
-IGNORE_TAGS=(0x9286, 0x927C)
-
-# http://tomtia.plala.jp/DigitalCamera/MakerNote/index.asp
-def nikon_ev_bias(seq):
- # First digit seems to be in steps of 1/6 EV.
- # Does the third value mean the step size? It is usually 6,
- # but it is 12 for the ExposureDifference.
- #
- # Check for an error condition that could cause a crash.
- # This only happens if something has gone really wrong in
- # reading the Nikon MakerNote.
- if len( seq ) < 4 : return ""
- #
- if seq == [252, 1, 6, 0]:
- return "-2/3 EV"
- if seq == [253, 1, 6, 0]:
- return "-1/2 EV"
- if seq == [254, 1, 6, 0]:
- return "-1/3 EV"
- if seq == [0, 1, 6, 0]:
- return "0 EV"
- if seq == [2, 1, 6, 0]:
- return "+1/3 EV"
- if seq == [3, 1, 6, 0]:
- return "+1/2 EV"
- if seq == [4, 1, 6, 0]:
- return "+2/3 EV"
- # Handle combinations not in the table.
- a = seq[0]
- # Causes headaches for the +/- logic, so special case it.
- if a == 0:
- return "0 EV"
- if a > 127:
- a = 256 - a
- ret_str = "-"
- else:
- ret_str = "+"
- b = seq[2] # Assume third value means the step size
- whole = a / b
- a = a % b
- if whole != 0:
- ret_str = ret_str + str(whole) + " "
- if a == 0:
- ret_str = ret_str + "EV"
- else:
- r = Ratio(a, b)
- ret_str = ret_str + r.__repr__() + " EV"
- return ret_str
-
-# Nikon E99x MakerNote Tags
-MAKERNOTE_NIKON_NEWER_TAGS={
- 0x0001: ('MakernoteVersion', make_string), # Sometimes binary
- 0x0002: ('ISOSetting', make_string),
- 0x0003: ('ColorMode', ),
- 0x0004: ('Quality', ),
- 0x0005: ('Whitebalance', ),
- 0x0006: ('ImageSharpening', ),
- 0x0007: ('FocusMode', ),
- 0x0008: ('FlashSetting', ),
- 0x0009: ('AutoFlashMode', ),
- 0x000B: ('WhiteBalanceBias', ),
- 0x000C: ('WhiteBalanceRBCoeff', ),
- 0x000D: ('ProgramShift', nikon_ev_bias),
- # Nearly the same as the other EV vals, but step size is 1/12 EV (?)
- 0x000E: ('ExposureDifference', nikon_ev_bias),
- 0x000F: ('ISOSelection', ),
- 0x0011: ('NikonPreview', ),
- 0x0012: ('FlashCompensation', nikon_ev_bias),
- 0x0013: ('ISOSpeedRequested', ),
- 0x0016: ('PhotoCornerCoordinates', ),
- # 0x0017: Unknown, but most likely an EV value
- 0x0018: ('FlashBracketCompensationApplied', nikon_ev_bias),
- 0x0019: ('AEBracketCompensationApplied', ),
- 0x001A: ('ImageProcessing', ),
- 0x001B: ('CropHiSpeed', ),
- 0x001D: ('SerialNumber', ), # Conflict with 0x00A0 ?
- 0x001E: ('ColorSpace', ),
- 0x001F: ('VRInfo', ),
- 0x0020: ('ImageAuthentication', ),
- 0x0022: ('ActiveDLighting', ),
- 0x0023: ('PictureControl', ),
- 0x0024: ('WorldTime', ),
- 0x0025: ('ISOInfo', ),
- 0x0080: ('ImageAdjustment', ),
- 0x0081: ('ToneCompensation', ),
- 0x0082: ('AuxiliaryLens', ),
- 0x0083: ('LensType', ),
- 0x0084: ('LensMinMaxFocalMaxAperture', ),
- 0x0085: ('ManualFocusDistance', ),
- 0x0086: ('DigitalZoomFactor', ),
- 0x0087: ('FlashMode',
- {0x00: 'Did Not Fire',
- 0x01: 'Fired, Manual',
- 0x07: 'Fired, External',
- 0x08: 'Fired, Commander Mode ',
- 0x09: 'Fired, TTL Mode'}),
- 0x0088: ('AFFocusPosition',
- {0x0000: 'Center',
- 0x0100: 'Top',
- 0x0200: 'Bottom',
- 0x0300: 'Left',
- 0x0400: 'Right'}),
- 0x0089: ('BracketingMode',
- {0x00: 'Single frame, no bracketing',
- 0x01: 'Continuous, no bracketing',
- 0x02: 'Timer, no bracketing',
- 0x10: 'Single frame, exposure bracketing',
- 0x11: 'Continuous, exposure bracketing',
- 0x12: 'Timer, exposure bracketing',
- 0x40: 'Single frame, white balance bracketing',
- 0x41: 'Continuous, white balance bracketing',
- 0x42: 'Timer, white balance bracketing'}),
- 0x008A: ('AutoBracketRelease', ),
- 0x008B: ('LensFStops', ),
- 0x008C: ('NEFCurve1', ), # ExifTool calls this 'ContrastCurve'
- 0x008D: ('ColorMode', ),
- 0x008F: ('SceneMode', ),
- 0x0090: ('LightingType', ),
- 0x0091: ('ShotInfo', ), # First 4 bytes are a version number in ASCII
- 0x0092: ('HueAdjustment', ),
- # ExifTool calls this 'NEFCompression', should be 1-4
- 0x0093: ('Compression', ),
- 0x0094: ('Saturation',
- {-3: 'B&W',
- -2: '-2',
- -1: '-1',
- 0: '0',
- 1: '1',
- 2: '2'}),
- 0x0095: ('NoiseReduction', ),
- 0x0096: ('NEFCurve2', ), # ExifTool calls this 'LinearizationTable'
- 0x0097: ('ColorBalance', ), # First 4 bytes are a version number in ASCII
- 0x0098: ('LensData', ), # First 4 bytes are a version number in ASCII
- 0x0099: ('RawImageCenter', ),
- 0x009A: ('SensorPixelSize', ),
- 0x009C: ('Scene Assist', ),
- 0x009E: ('RetouchHistory', ),
- 0x00A0: ('SerialNumber', ),
- 0x00A2: ('ImageDataSize', ),
- # 00A3: unknown - a single byte 0
- # 00A4: In NEF, looks like a 4 byte ASCII version number ('0200')
- 0x00A5: ('ImageCount', ),
- 0x00A6: ('DeletedImageCount', ),
- 0x00A7: ('TotalShutterReleases', ),
- # First 4 bytes are a version number in ASCII, with version specific
- # info to follow. Its hard to treat it as a string due to embedded nulls.
- 0x00A8: ('FlashInfo', ),
- 0x00A9: ('ImageOptimization', ),
- 0x00AA: ('Saturation', ),
- 0x00AB: ('DigitalVariProgram', ),
- 0x00AC: ('ImageStabilization', ),
- 0x00AD: ('Responsive AF', ), # 'AFResponse'
- 0x00B0: ('MultiExposure', ),
- 0x00B1: ('HighISONoiseReduction', ),
- 0x00B7: ('AFInfo', ),
- 0x00B8: ('FileInfo', ),
- # 00B9: unknown
- 0x0100: ('DigitalICE', ),
- 0x0103: ('PreviewCompression',
- {1: 'Uncompressed',
- 2: 'CCITT 1D',
- 3: 'T4/Group 3 Fax',
- 4: 'T6/Group 4 Fax',
- 5: 'LZW',
- 6: 'JPEG (old-style)',
- 7: 'JPEG',
- 8: 'Adobe Deflate',
- 9: 'JBIG B&W',
- 10: 'JBIG Color',
- 32766: 'Next',
- 32769: 'Epson ERF Compressed',
- 32771: 'CCIRLEW',
- 32773: 'PackBits',
- 32809: 'Thunderscan',
- 32895: 'IT8CTPAD',
- 32896: 'IT8LW',
- 32897: 'IT8MP',
- 32898: 'IT8BL',
- 32908: 'PixarFilm',
- 32909: 'PixarLog',
- 32946: 'Deflate',
- 32947: 'DCS',
- 34661: 'JBIG',
- 34676: 'SGILog',
- 34677: 'SGILog24',
- 34712: 'JPEG 2000',
- 34713: 'Nikon NEF Compressed',
- 65000: 'Kodak DCR Compressed',
- 65535: 'Pentax PEF Compressed',}),
- 0x0201: ('PreviewImageStart', ),
- 0x0202: ('PreviewImageLength', ),
- 0x0213: ('PreviewYCbCrPositioning',
- {1: 'Centered',
- 2: 'Co-sited'}),
- 0x0010: ('DataDump', ),
- }
-
-MAKERNOTE_NIKON_OLDER_TAGS = {
- 0x0003: ('Quality',
- {1: 'VGA Basic',
- 2: 'VGA Normal',
- 3: 'VGA Fine',
- 4: 'SXGA Basic',
- 5: 'SXGA Normal',
- 6: 'SXGA Fine'}),
- 0x0004: ('ColorMode',
- {1: 'Color',
- 2: 'Monochrome'}),
- 0x0005: ('ImageAdjustment',
- {0: 'Normal',
- 1: 'Bright+',
- 2: 'Bright-',
- 3: 'Contrast+',
- 4: 'Contrast-'}),
- 0x0006: ('CCDSpeed',
- {0: 'ISO 80',
- 2: 'ISO 160',
- 4: 'ISO 320',
- 5: 'ISO 100'}),
- 0x0007: ('WhiteBalance',
- {0: 'Auto',
- 1: 'Preset',
- 2: 'Daylight',
- 3: 'Incandescent',
- 4: 'Fluorescent',
- 5: 'Cloudy',
- 6: 'Speed Light'}),
- }
-
-# decode Olympus SpecialMode tag in MakerNote
-def olympus_special_mode(v):
- a={
- 0: 'Normal',
- 1: 'Unknown',
- 2: 'Fast',
- 3: 'Panorama'}
- b={
- 0: 'Non-panoramic',
- 1: 'Left to right',
- 2: 'Right to left',
- 3: 'Bottom to top',
- 4: 'Top to bottom'}
- if v[0] not in a or v[2] not in b:
- return v
- return '%s - sequence %d - %s' % (a[v[0]], v[1], b[v[2]])
-
-MAKERNOTE_OLYMPUS_TAGS={
- # ah HAH! those sneeeeeaky bastids! this is how they get past the fact
- # that a JPEG thumbnail is not allowed in an uncompressed TIFF file
- 0x0100: ('JPEGThumbnail', ),
- 0x0200: ('SpecialMode', olympus_special_mode),
- 0x0201: ('JPEGQual',
- {1: 'SQ',
- 2: 'HQ',
- 3: 'SHQ'}),
- 0x0202: ('Macro',
- {0: 'Normal',
- 1: 'Macro',
- 2: 'SuperMacro'}),
- 0x0203: ('BWMode',
- {0: 'Off',
- 1: 'On'}),
- 0x0204: ('DigitalZoom', ),
- 0x0205: ('FocalPlaneDiagonal', ),
- 0x0206: ('LensDistortionParams', ),
- 0x0207: ('SoftwareRelease', ),
- 0x0208: ('PictureInfo', ),
- 0x0209: ('CameraID', make_string), # print as string
- 0x0F00: ('DataDump', ),
- 0x0300: ('PreCaptureFrames', ),
- 0x0404: ('SerialNumber', ),
- 0x1000: ('ShutterSpeedValue', ),
- 0x1001: ('ISOValue', ),
- 0x1002: ('ApertureValue', ),
- 0x1003: ('BrightnessValue', ),
- 0x1004: ('FlashMode', ),
- 0x1004: ('FlashMode',
- {2: 'On',
- 3: 'Off'}),
- 0x1005: ('FlashDevice',
- {0: 'None',
- 1: 'Internal',
- 4: 'External',
- 5: 'Internal + External'}),
- 0x1006: ('ExposureCompensation', ),
- 0x1007: ('SensorTemperature', ),
- 0x1008: ('LensTemperature', ),
- 0x100b: ('FocusMode',
- {0: 'Auto',
- 1: 'Manual'}),
- 0x1017: ('RedBalance', ),
- 0x1018: ('BlueBalance', ),
- 0x101a: ('SerialNumber', ),
- 0x1023: ('FlashExposureComp', ),
- 0x1026: ('ExternalFlashBounce',
- {0: 'No',
- 1: 'Yes'}),
- 0x1027: ('ExternalFlashZoom', ),
- 0x1028: ('ExternalFlashMode', ),
- 0x1029: ('Contrast int16u',
- {0: 'High',
- 1: 'Normal',
- 2: 'Low'}),
- 0x102a: ('SharpnessFactor', ),
- 0x102b: ('ColorControl', ),
- 0x102c: ('ValidBits', ),
- 0x102d: ('CoringFilter', ),
- 0x102e: ('OlympusImageWidth', ),
- 0x102f: ('OlympusImageHeight', ),
- 0x1034: ('CompressionRatio', ),
- 0x1035: ('PreviewImageValid',
- {0: 'No',
- 1: 'Yes'}),
- 0x1036: ('PreviewImageStart', ),
- 0x1037: ('PreviewImageLength', ),
- 0x1039: ('CCDScanMode',
- {0: 'Interlaced',
- 1: 'Progressive'}),
- 0x103a: ('NoiseReduction',
- {0: 'Off',
- 1: 'On'}),
- 0x103b: ('InfinityLensStep', ),
- 0x103c: ('NearLensStep', ),
-
- # TODO - these need extra definitions
- # http://search.cpan.org/src/EXIFTOOL/Image-ExifTool-6.90/html/TagNames/Olympus.html
- 0x2010: ('Equipment', ),
- 0x2020: ('CameraSettings', ),
- 0x2030: ('RawDevelopment', ),
- 0x2040: ('ImageProcessing', ),
- 0x2050: ('FocusInfo', ),
- 0x3000: ('RawInfo ', ),
- }
-
-# 0x2020 CameraSettings
-MAKERNOTE_OLYMPUS_TAG_0x2020={
- 0x0100: ('PreviewImageValid',
- {0: 'No',
- 1: 'Yes'}),
- 0x0101: ('PreviewImageStart', ),
- 0x0102: ('PreviewImageLength', ),
- 0x0200: ('ExposureMode',
- {1: 'Manual',
- 2: 'Program',
- 3: 'Aperture-priority AE',
- 4: 'Shutter speed priority AE',
- 5: 'Program-shift'}),
- 0x0201: ('AELock',
- {0: 'Off',
- 1: 'On'}),
- 0x0202: ('MeteringMode',
- {2: 'Center Weighted',
- 3: 'Spot',
- 5: 'ESP',
- 261: 'Pattern+AF',
- 515: 'Spot+Highlight control',
- 1027: 'Spot+Shadow control'}),
- 0x0300: ('MacroMode',
- {0: 'Off',
- 1: 'On'}),
- 0x0301: ('FocusMode',
- {0: 'Single AF',
- 1: 'Sequential shooting AF',
- 2: 'Continuous AF',
- 3: 'Multi AF',
- 10: 'MF'}),
- 0x0302: ('FocusProcess',
- {0: 'AF Not Used',
- 1: 'AF Used'}),
- 0x0303: ('AFSearch',
- {0: 'Not Ready',
- 1: 'Ready'}),
- 0x0304: ('AFAreas', ),
- 0x0401: ('FlashExposureCompensation', ),
- 0x0500: ('WhiteBalance2',
- {0: 'Auto',
- 16: '7500K (Fine Weather with Shade)',
- 17: '6000K (Cloudy)',
- 18: '5300K (Fine Weather)',
- 20: '3000K (Tungsten light)',
- 21: '3600K (Tungsten light-like)',
- 33: '6600K (Daylight fluorescent)',
- 34: '4500K (Neutral white fluorescent)',
- 35: '4000K (Cool white fluorescent)',
- 48: '3600K (Tungsten light-like)',
- 256: 'Custom WB 1',
- 257: 'Custom WB 2',
- 258: 'Custom WB 3',
- 259: 'Custom WB 4',
- 512: 'Custom WB 5400K',
- 513: 'Custom WB 2900K',
- 514: 'Custom WB 8000K', }),
- 0x0501: ('WhiteBalanceTemperature', ),
- 0x0502: ('WhiteBalanceBracket', ),
- 0x0503: ('CustomSaturation', ), # (3 numbers: 1. CS Value, 2. Min, 3. Max)
- 0x0504: ('ModifiedSaturation',
- {0: 'Off',
- 1: 'CM1 (Red Enhance)',
- 2: 'CM2 (Green Enhance)',
- 3: 'CM3 (Blue Enhance)',
- 4: 'CM4 (Skin Tones)'}),
- 0x0505: ('ContrastSetting', ), # (3 numbers: 1. Contrast, 2. Min, 3. Max)
- 0x0506: ('SharpnessSetting', ), # (3 numbers: 1. Sharpness, 2. Min, 3. Max)
- 0x0507: ('ColorSpace',
- {0: 'sRGB',
- 1: 'Adobe RGB',
- 2: 'Pro Photo RGB'}),
- 0x0509: ('SceneMode',
- {0: 'Standard',
- 6: 'Auto',
- 7: 'Sport',
- 8: 'Portrait',
- 9: 'Landscape+Portrait',
- 10: 'Landscape',
- 11: 'Night scene',
- 13: 'Panorama',
- 16: 'Landscape+Portrait',
- 17: 'Night+Portrait',
- 19: 'Fireworks',
- 20: 'Sunset',
- 22: 'Macro',
- 25: 'Documents',
- 26: 'Museum',
- 28: 'Beach&Snow',
- 30: 'Candle',
- 35: 'Underwater Wide1',
- 36: 'Underwater Macro',
- 39: 'High Key',
- 40: 'Digital Image Stabilization',
- 44: 'Underwater Wide2',
- 45: 'Low Key',
- 46: 'Children',
- 48: 'Nature Macro'}),
- 0x050a: ('NoiseReduction',
- {0: 'Off',
- 1: 'Noise Reduction',
- 2: 'Noise Filter',
- 3: 'Noise Reduction + Noise Filter',
- 4: 'Noise Filter (ISO Boost)',
- 5: 'Noise Reduction + Noise Filter (ISO Boost)'}),
- 0x050b: ('DistortionCorrection',
- {0: 'Off',
- 1: 'On'}),
- 0x050c: ('ShadingCompensation',
- {0: 'Off',
- 1: 'On'}),
- 0x050d: ('CompressionFactor', ),
- 0x050f: ('Gradation',
- {'-1 -1 1': 'Low Key',
- '0 -1 1': 'Normal',
- '1 -1 1': 'High Key'}),
- 0x0520: ('PictureMode',
- {1: 'Vivid',
- 2: 'Natural',
- 3: 'Muted',
- 256: 'Monotone',
- 512: 'Sepia'}),
- 0x0521: ('PictureModeSaturation', ),
- 0x0522: ('PictureModeHue?', ),
- 0x0523: ('PictureModeContrast', ),
- 0x0524: ('PictureModeSharpness', ),
- 0x0525: ('PictureModeBWFilter',
- {0: 'n/a',
- 1: 'Neutral',
- 2: 'Yellow',
- 3: 'Orange',
- 4: 'Red',
- 5: 'Green'}),
- 0x0526: ('PictureModeTone',
- {0: 'n/a',
- 1: 'Neutral',
- 2: 'Sepia',
- 3: 'Blue',
- 4: 'Purple',
- 5: 'Green'}),
- 0x0600: ('Sequence', ), # 2 or 3 numbers: 1. Mode, 2. Shot number, 3. Mode bits
- 0x0601: ('PanoramaMode', ), # (2 numbers: 1. Mode, 2. Shot number)
- 0x0603: ('ImageQuality2',
- {1: 'SQ',
- 2: 'HQ',
- 3: 'SHQ',
- 4: 'RAW'}),
- 0x0901: ('ManometerReading', ),
- }
-
-
-MAKERNOTE_CASIO_TAGS={
- 0x0001: ('RecordingMode',
- {1: 'Single Shutter',
- 2: 'Panorama',
- 3: 'Night Scene',
- 4: 'Portrait',
- 5: 'Landscape'}),
- 0x0002: ('Quality',
- {1: 'Economy',
- 2: 'Normal',
- 3: 'Fine'}),
- 0x0003: ('FocusingMode',
- {2: 'Macro',
- 3: 'Auto Focus',
- 4: 'Manual Focus',
- 5: 'Infinity'}),
- 0x0004: ('FlashMode',
- {1: 'Auto',
- 2: 'On',
- 3: 'Off',
- 4: 'Red Eye Reduction'}),
- 0x0005: ('FlashIntensity',
- {11: 'Weak',
- 13: 'Normal',
- 15: 'Strong'}),
- 0x0006: ('Object Distance', ),
- 0x0007: ('WhiteBalance',
- {1: 'Auto',
- 2: 'Tungsten',
- 3: 'Daylight',
- 4: 'Fluorescent',
- 5: 'Shade',
- 129: 'Manual'}),
- 0x000B: ('Sharpness',
- {0: 'Normal',
- 1: 'Soft',
- 2: 'Hard'}),
- 0x000C: ('Contrast',
- {0: 'Normal',
- 1: 'Low',
- 2: 'High'}),
- 0x000D: ('Saturation',
- {0: 'Normal',
- 1: 'Low',
- 2: 'High'}),
- 0x0014: ('CCDSpeed',
- {64: 'Normal',
- 80: 'Normal',
- 100: 'High',
- 125: '+1.0',
- 244: '+3.0',
- 250: '+2.0'}),
- }
-
-MAKERNOTE_FUJIFILM_TAGS={
- 0x0000: ('NoteVersion', make_string),
- 0x1000: ('Quality', ),
- 0x1001: ('Sharpness',
- {1: 'Soft',
- 2: 'Soft',
- 3: 'Normal',
- 4: 'Hard',
- 5: 'Hard'}),
- 0x1002: ('WhiteBalance',
- {0: 'Auto',
- 256: 'Daylight',
- 512: 'Cloudy',
- 768: 'DaylightColor-Fluorescent',
- 769: 'DaywhiteColor-Fluorescent',
- 770: 'White-Fluorescent',
- 1024: 'Incandescent',
- 3840: 'Custom'}),
- 0x1003: ('Color',
- {0: 'Normal',
- 256: 'High',
- 512: 'Low'}),
- 0x1004: ('Tone',
- {0: 'Normal',
- 256: 'High',
- 512: 'Low'}),
- 0x1010: ('FlashMode',
- {0: 'Auto',
- 1: 'On',
- 2: 'Off',
- 3: 'Red Eye Reduction'}),
- 0x1011: ('FlashStrength', ),
- 0x1020: ('Macro',
- {0: 'Off',
- 1: 'On'}),
- 0x1021: ('FocusMode',
- {0: 'Auto',
- 1: 'Manual'}),
- 0x1030: ('SlowSync',
- {0: 'Off',
- 1: 'On'}),
- 0x1031: ('PictureMode',
- {0: 'Auto',
- 1: 'Portrait',
- 2: 'Landscape',
- 4: 'Sports',
- 5: 'Night',
- 6: 'Program AE',
- 256: 'Aperture Priority AE',
- 512: 'Shutter Priority AE',
- 768: 'Manual Exposure'}),
- 0x1100: ('MotorOrBracket',
- {0: 'Off',
- 1: 'On'}),
- 0x1300: ('BlurWarning',
- {0: 'Off',
- 1: 'On'}),
- 0x1301: ('FocusWarning',
- {0: 'Off',
- 1: 'On'}),
- 0x1302: ('AEWarning',
- {0: 'Off',
- 1: 'On'}),
- }
-
-MAKERNOTE_CANON_TAGS = {
- 0x0006: ('ImageType', ),
- 0x0007: ('FirmwareVersion', ),
- 0x0008: ('ImageNumber', ),
- 0x0009: ('OwnerName', ),
- }
-
-# this is in element offset, name, optional value dictionary format
-MAKERNOTE_CANON_TAG_0x001 = {
- 1: ('Macromode',
- {1: 'Macro',
- 2: 'Normal'}),
- 2: ('SelfTimer', ),
- 3: ('Quality',
- {2: 'Normal',
- 3: 'Fine',
- 5: 'Superfine'}),
- 4: ('FlashMode',
- {0: 'Flash Not Fired',
- 1: 'Auto',
- 2: 'On',
- 3: 'Red-Eye Reduction',
- 4: 'Slow Synchro',
- 5: 'Auto + Red-Eye Reduction',
- 6: 'On + Red-Eye Reduction',
- 16: 'external flash'}),
- 5: ('ContinuousDriveMode',
- {0: 'Single Or Timer',
- 1: 'Continuous'}),
- 7: ('FocusMode',
- {0: 'One-Shot',
- 1: 'AI Servo',
- 2: 'AI Focus',
- 3: 'MF',
- 4: 'Single',
- 5: 'Continuous',
- 6: 'MF'}),
- 10: ('ImageSize',
- {0: 'Large',
- 1: 'Medium',
- 2: 'Small'}),
- 11: ('EasyShootingMode',
- {0: 'Full Auto',
- 1: 'Manual',
- 2: 'Landscape',
- 3: 'Fast Shutter',
- 4: 'Slow Shutter',
- 5: 'Night',
- 6: 'B&W',
- 7: 'Sepia',
- 8: 'Portrait',
- 9: 'Sports',
- 10: 'Macro/Close-Up',
- 11: 'Pan Focus'}),
- 12: ('DigitalZoom',
- {0: 'None',
- 1: '2x',
- 2: '4x'}),
- 13: ('Contrast',
- {0xFFFF: 'Low',
- 0: 'Normal',
- 1: 'High'}),
- 14: ('Saturation',
- {0xFFFF: 'Low',
- 0: 'Normal',
- 1: 'High'}),
- 15: ('Sharpness',
- {0xFFFF: 'Low',
- 0: 'Normal',
- 1: 'High'}),
- 16: ('ISO',
- {0: 'See ISOSpeedRatings Tag',
- 15: 'Auto',
- 16: '50',
- 17: '100',
- 18: '200',
- 19: '400'}),
- 17: ('MeteringMode',
- {3: 'Evaluative',
- 4: 'Partial',
- 5: 'Center-weighted'}),
- 18: ('FocusType',
- {0: 'Manual',
- 1: 'Auto',
- 3: 'Close-Up (Macro)',
- 8: 'Locked (Pan Mode)'}),
- 19: ('AFPointSelected',
- {0x3000: 'None (MF)',
- 0x3001: 'Auto-Selected',
- 0x3002: 'Right',
- 0x3003: 'Center',
- 0x3004: 'Left'}),
- 20: ('ExposureMode',
- {0: 'Easy Shooting',
- 1: 'Program',
- 2: 'Tv-priority',
- 3: 'Av-priority',
- 4: 'Manual',
- 5: 'A-DEP'}),
- 23: ('LongFocalLengthOfLensInFocalUnits', ),
- 24: ('ShortFocalLengthOfLensInFocalUnits', ),
- 25: ('FocalUnitsPerMM', ),
- 28: ('FlashActivity',
- {0: 'Did Not Fire',
- 1: 'Fired'}),
- 29: ('FlashDetails',
- {14: 'External E-TTL',
- 13: 'Internal Flash',
- 11: 'FP Sync Used',
- 7: '2nd("Rear")-Curtain Sync Used',
- 4: 'FP Sync Enabled'}),
- 32: ('FocusMode',
- {0: 'Single',
- 1: 'Continuous'}),
- }
-
-MAKERNOTE_CANON_TAG_0x004 = {
- 7: ('WhiteBalance',
- {0: 'Auto',
- 1: 'Sunny',
- 2: 'Cloudy',
- 3: 'Tungsten',
- 4: 'Fluorescent',
- 5: 'Flash',
- 6: 'Custom'}),
- 9: ('SequenceNumber', ),
- 14: ('AFPointUsed', ),
- 15: ('FlashBias',
- {0xFFC0: '-2 EV',
- 0xFFCC: '-1.67 EV',
- 0xFFD0: '-1.50 EV',
- 0xFFD4: '-1.33 EV',
- 0xFFE0: '-1 EV',
- 0xFFEC: '-0.67 EV',
- 0xFFF0: '-0.50 EV',
- 0xFFF4: '-0.33 EV',
- 0x0000: '0 EV',
- 0x000C: '0.33 EV',
- 0x0010: '0.50 EV',
- 0x0014: '0.67 EV',
- 0x0020: '1 EV',
- 0x002C: '1.33 EV',
- 0x0030: '1.50 EV',
- 0x0034: '1.67 EV',
- 0x0040: '2 EV'}),
- 19: ('SubjectDistance', ),
- }
-
-# extract multibyte integer in Motorola format (little endian)
-def s2n_motorola(str):
- x = 0
- for c in str:
- x = (x << 8) | ord(c)
- return x
-
-# extract multibyte integer in Intel format (big endian)
-def s2n_intel(str):
- x = 0
- y = 0L
- for c in str:
- x = x | (ord(c) << y)
- y = y + 8
- return x
-
-# ratio object that eventually will be able to reduce itself to lowest
-# common denominator for printing
-def gcd(a, b):
- if b == 0:
- return a
- else:
- return gcd(b, a % b)
-
-class Ratio:
- def __init__(self, num, den):
- self.num = num
- self.den = den
-
- def __repr__(self):
- self.reduce()
- if self.den == 1:
- return str(self.num)
- return '%d/%d' % (self.num, self.den)
-
- def reduce(self):
- div = gcd(self.num, self.den)
- if div > 1:
- self.num = self.num / div
- self.den = self.den / div
-
-# for ease of dealing with tags
-class IFD_Tag:
- def __init__(self, printable, tag, field_type, values, field_offset,
- field_length):
- # printable version of data
- self.printable = printable
- # tag ID number
- self.tag = tag
- # field type as index into FIELD_TYPES
- self.field_type = field_type
- # offset of start of field in bytes from beginning of IFD
- self.field_offset = field_offset
- # length of data field in bytes
- self.field_length = field_length
- # either a string or array of data items
- self.values = values
-
- def __str__(self):
- return self.printable
-
- def __repr__(self):
- try:
- s= '(0x%04X) %s=%s @ %d' % (self.tag,
- FIELD_TYPES[self.field_type][2],
- self.printable,
- self.field_offset)
- except:
- s= '(%s) %s=%s @ %s' % (str(self.tag),
- FIELD_TYPES[self.field_type][2],
- self.printable,
- str(self.field_offset))
- return s
-
-# class that handles an EXIF header
-class EXIF_header:
- def __init__(self, file, endian, offset, fake_exif, strict, debug=0):
- self.file = file
- self.endian = endian
- self.offset = offset
- self.fake_exif = fake_exif
- self.strict = strict
- self.debug = debug
- self.tags = {}
-
- # convert slice to integer, based on sign and endian flags
- # usually this offset is assumed to be relative to the beginning of the
- # start of the EXIF information. For some cameras that use relative tags,
- # this offset may be relative to some other starting point.
- def s2n(self, offset, length, signed=0):
- self.file.seek(self.offset+offset)
- slice=self.file.read(length)
- if self.endian == 'I':
- val=s2n_intel(slice)
- else:
- val=s2n_motorola(slice)
- # Sign extension ?
- if signed:
- msb=1L << (8*length-1)
- if val & msb:
- val=val-(msb << 1)
- return val
-
- # convert offset to string
- def n2s(self, offset, length):
- s = ''
- for dummy in range(length):
- if self.endian == 'I':
- s = s + chr(offset & 0xFF)
- else:
- s = chr(offset & 0xFF) + s
- offset = offset >> 8
- return s
-
- # return first IFD
- def first_IFD(self):
- return self.s2n(4, 4)
-
- # return pointer to next IFD
- def next_IFD(self, ifd):
- entries=self.s2n(ifd, 2)
- next_ifd = self.s2n(ifd+2+12*entries, 4)
- if next_ifd == ifd:
- return 0
- else:
- return next_ifd
-
- # return list of IFDs in header
- def list_IFDs(self):
- i=self.first_IFD()
- a=[]
- while i:
- a.append(i)
- i=self.next_IFD(i)
- return a
-
- # return list of entries in this IFD
- def dump_IFD(self, ifd, ifd_name, dict=EXIF_TAGS, relative=0, stop_tag='UNDEF'):
- entries=self.s2n(ifd, 2)
- for i in range(entries):
- # entry is index of start of this IFD in the file
- entry = ifd + 2 + 12 * i
- tag = self.s2n(entry, 2)
-
- # get tag name early to avoid errors, help debug
- tag_entry = dict.get(tag)
- if tag_entry:
- tag_name = tag_entry[0]
- else:
- tag_name = 'Tag 0x%04X' % tag
-
- # ignore certain tags for faster processing
- if not (not detailed and tag in IGNORE_TAGS):
- field_type = self.s2n(entry + 2, 2)
-
- # unknown field type
- if not 0 < field_type < len(FIELD_TYPES):
- if not self.strict:
- continue
- else:
- raise ValueError('unknown type %d in tag 0x%04X' % (field_type, tag))
-
- typelen = FIELD_TYPES[field_type][0]
- count = self.s2n(entry + 4, 4)
- # Adjust for tag id/type/count (2+2+4 bytes)
- # Now we point at either the data or the 2nd level offset
- offset = entry + 8
-
- # If the value fits in 4 bytes, it is inlined, else we
- # need to jump ahead again.
- if count * typelen > 4:
- # offset is not the value; it's a pointer to the value
- # if relative we set things up so s2n will seek to the right
- # place when it adds self.offset. Note that this 'relative'
- # is for the Nikon type 3 makernote. Other cameras may use
- # other relative offsets, which would have to be computed here
- # slightly differently.
- if relative:
- tmp_offset = self.s2n(offset, 4)
- offset = tmp_offset + ifd - 8
- if self.fake_exif:
- offset = offset + 18
- else:
- offset = self.s2n(offset, 4)
-
- field_offset = offset
- if field_type == 2:
- # special case: null-terminated ASCII string
- # XXX investigate
- # sometimes gets too big to fit in int value
- if count != 0: # and count < (2**31): # 2E31 is hardware dependant. --gd
- try:
- self.file.seek(self.offset + offset)
- values = self.file.read(count)
- #print values
- # Drop any garbage after a null.
- values = values.split('\x00', 1)[0]
- except OverflowError:
- values = ''
- else:
- values = []
- signed = (field_type in [6, 8, 9, 10])
-
- # XXX investigate
- # some entries get too big to handle could be malformed
- # file or problem with self.s2n
- if count < 1000:
- for dummy in range(count):
- if field_type in (5, 10):
- # a ratio
- value = Ratio(self.s2n(offset, 4, signed),
- self.s2n(offset + 4, 4, signed))
- else:
- value = self.s2n(offset, typelen, signed)
- values.append(value)
- offset = offset + typelen
- # The test above causes problems with tags that are
- # supposed to have long values! Fix up one important case.
- elif tag_name == 'MakerNote' :
- for dummy in range(count):
- value = self.s2n(offset, typelen, signed)
- values.append(value)
- offset = offset + typelen
- #else :
- # print "Warning: dropping large tag:", tag, tag_name
-
- # now 'values' is either a string or an array
- if count == 1 and field_type != 2:
- printable=str(values[0])
- elif count > 50 and len(values) > 20 :
- printable=str( values[0:20] )[0:-1] + ", ... ]"
- else:
- printable=str(values)
-
- # compute printable version of values
- if tag_entry:
- if len(tag_entry) != 1:
- # optional 2nd tag element is present
- if callable(tag_entry[1]):
- # call mapping function
- printable = tag_entry[1](values)
- else:
- printable = ''
- for i in values:
- # use lookup table for this tag
- printable += tag_entry[1].get(i, repr(i))
-
- self.tags[ifd_name + ' ' + tag_name] = IFD_Tag(printable, tag,
- field_type,
- values, field_offset,
- count * typelen)
- if self.debug:
- print ' debug: %s: %s' % (tag_name,
- repr(self.tags[ifd_name + ' ' + tag_name]))
-
- if tag_name == stop_tag:
- break
-
- # extract uncompressed TIFF thumbnail (like pulling teeth)
- # we take advantage of the pre-existing layout in the thumbnail IFD as
- # much as possible
- def extract_TIFF_thumbnail(self, thumb_ifd):
- entries = self.s2n(thumb_ifd, 2)
- # this is header plus offset to IFD ...
- if self.endian == 'M':
- tiff = 'MM\x00*\x00\x00\x00\x08'
- else:
- tiff = 'II*\x00\x08\x00\x00\x00'
- # ... plus thumbnail IFD data plus a null "next IFD" pointer
- self.file.seek(self.offset+thumb_ifd)
- tiff += self.file.read(entries*12+2)+'\x00\x00\x00\x00'
-
- # fix up large value offset pointers into data area
- for i in range(entries):
- entry = thumb_ifd + 2 + 12 * i
- tag = self.s2n(entry, 2)
- field_type = self.s2n(entry+2, 2)
- typelen = FIELD_TYPES[field_type][0]
- count = self.s2n(entry+4, 4)
- oldoff = self.s2n(entry+8, 4)
- # start of the 4-byte pointer area in entry
- ptr = i * 12 + 18
- # remember strip offsets location
- if tag == 0x0111:
- strip_off = ptr
- strip_len = count * typelen
- # is it in the data area?
- if count * typelen > 4:
- # update offset pointer (nasty "strings are immutable" crap)
- # should be able to say "tiff[ptr:ptr+4]=newoff"
- newoff = len(tiff)
- tiff = tiff[:ptr] + self.n2s(newoff, 4) + tiff[ptr+4:]
- # remember strip offsets location
- if tag == 0x0111:
- strip_off = newoff
- strip_len = 4
- # get original data and store it
- self.file.seek(self.offset + oldoff)
- tiff += self.file.read(count * typelen)
-
- # add pixel strips and update strip offset info
- old_offsets = self.tags['Thumbnail StripOffsets'].values
- old_counts = self.tags['Thumbnail StripByteCounts'].values
- for i in range(len(old_offsets)):
- # update offset pointer (more nasty "strings are immutable" crap)
- offset = self.n2s(len(tiff), strip_len)
- tiff = tiff[:strip_off] + offset + tiff[strip_off + strip_len:]
- strip_off += strip_len
- # add pixel strip to end
- self.file.seek(self.offset + old_offsets[i])
- tiff += self.file.read(old_counts[i])
-
- self.tags['TIFFThumbnail'] = tiff
-
- # decode all the camera-specific MakerNote formats
-
- # Note is the data that comprises this MakerNote. The MakerNote will
- # likely have pointers in it that point to other parts of the file. We'll
- # use self.offset as the starting point for most of those pointers, since
- # they are relative to the beginning of the file.
- #
- # If the MakerNote is in a newer format, it may use relative addressing
- # within the MakerNote. In that case we'll use relative addresses for the
- # pointers.
- #
- # As an aside: it's not just to be annoying that the manufacturers use
- # relative offsets. It's so that if the makernote has to be moved by the
- # picture software all of the offsets don't have to be adjusted. Overall,
- # this is probably the right strategy for makernotes, though the spec is
- # ambiguous. (The spec does not appear to imagine that makernotes would
- # follow EXIF format internally. Once they did, it's ambiguous whether
- # the offsets should be from the header at the start of all the EXIF info,
- # or from the header at the start of the makernote.)
- def decode_maker_note(self):
- note = self.tags['EXIF MakerNote']
-
- # Some apps use MakerNote tags but do not use a format for which we
- # have a description, so just do a raw dump for these.
- #if self.tags.has_key('Image Make'):
- make = self.tags['Image Make'].printable
- #else:
- # make = ''
-
- # model = self.tags['Image Model'].printable # unused
-
- # Nikon
- # The maker note usually starts with the word Nikon, followed by the
- # type of the makernote (1 or 2, as a short). If the word Nikon is
- # not at the start of the makernote, it's probably type 2, since some
- # cameras work that way.
- if 'NIKON' in make:
- if note.values[0:7] == [78, 105, 107, 111, 110, 0, 1]:
- if self.debug:
- print "Looks like a type 1 Nikon MakerNote."
- self.dump_IFD(note.field_offset+8, 'MakerNote',
- dict=MAKERNOTE_NIKON_OLDER_TAGS)
- elif note.values[0:7] == [78, 105, 107, 111, 110, 0, 2]:
- if self.debug:
- print "Looks like a labeled type 2 Nikon MakerNote"
- if note.values[12:14] != [0, 42] and note.values[12:14] != [42L, 0L]:
- raise ValueError("Missing marker tag '42' in MakerNote.")
- # skip the Makernote label and the TIFF header
- self.dump_IFD(note.field_offset+10+8, 'MakerNote',
- dict=MAKERNOTE_NIKON_NEWER_TAGS, relative=1)
- else:
- # E99x or D1
- if self.debug:
- print "Looks like an unlabeled type 2 Nikon MakerNote"
- self.dump_IFD(note.field_offset, 'MakerNote',
- dict=MAKERNOTE_NIKON_NEWER_TAGS)
- return
-
- # Olympus
- if make.startswith('OLYMPUS'):
- self.dump_IFD(note.field_offset+8, 'MakerNote',
- dict=MAKERNOTE_OLYMPUS_TAGS)
- # XXX TODO
- #for i in (('MakerNote Tag 0x2020', MAKERNOTE_OLYMPUS_TAG_0x2020),):
- # self.decode_olympus_tag(self.tags[i[0]].values, i[1])
- #return
-
- # Casio
- if 'CASIO' in make or 'Casio' in make:
- self.dump_IFD(note.field_offset, 'MakerNote',
- dict=MAKERNOTE_CASIO_TAGS)
- return
-
- # Fujifilm
- if make == 'FUJIFILM':
- # bug: everything else is "Motorola" endian, but the MakerNote
- # is "Intel" endian
- endian = self.endian
- self.endian = 'I'
- # bug: IFD offsets are from beginning of MakerNote, not
- # beginning of file header
- offset = self.offset
- self.offset += note.field_offset
- # process note with bogus values (note is actually at offset 12)
- self.dump_IFD(12, 'MakerNote', dict=MAKERNOTE_FUJIFILM_TAGS)
- # reset to correct values
- self.endian = endian
- self.offset = offset
- return
-
- # Canon
- if make == 'Canon':
- self.dump_IFD(note.field_offset, 'MakerNote',
- dict=MAKERNOTE_CANON_TAGS)
- for i in (('MakerNote Tag 0x0001', MAKERNOTE_CANON_TAG_0x001),
- ('MakerNote Tag 0x0004', MAKERNOTE_CANON_TAG_0x004)):
- if i[0] in self.tags:
- self.canon_decode_tag(self.tags[i[0]].values, i[1])
- return
-
-
- # XXX TODO decode Olympus MakerNote tag based on offset within tag
- def olympus_decode_tag(self, value, dict):
- pass
-
- # decode Canon MakerNote tag based on offset within tag
- # see http://www.burren.cx/david/canon.html by David Burren
- def canon_decode_tag(self, value, dict):
- for i in range(1, len(value)):
- x=dict.get(i, ('Unknown', ))
- if self.debug:
- print i, x
- name=x[0]
- if len(x) > 1:
- val=x[1].get(value[i], 'Unknown')
- else:
- val=value[i]
- # it's not a real IFD Tag but we fake one to make everybody
- # happy. this will have a "proprietary" type
- self.tags['MakerNote '+name]=IFD_Tag(str(val), None, 0, None,
- None, None)
-
-# process an image file (expects an open file object)
-# this is the function that has to deal with all the arbitrary nasty bits
-# of the EXIF standard
-def process_file(f, stop_tag='UNDEF', details=True, strict=False, debug=False):
- # yah it's cheesy...
- global detailed
- detailed = details
-
- # by default do not fake an EXIF beginning
- fake_exif = 0
-
- # determine whether it's a JPEG or TIFF
- data = f.read(12)
- if data[0:4] in ['II*\x00', 'MM\x00*']:
- # it's a TIFF file
- f.seek(0)
- endian = f.read(1)
- f.read(1)
- offset = 0
- elif data[0:2] == '\xFF\xD8':
- # it's a JPEG file
- if debug: print "JPEG format recognized data[0:2] == '0xFFD8'."
- base = 2
- while data[2] == '\xFF' and data[6:10] in ('JFIF', 'JFXX', 'OLYM', 'Phot'):
- if debug: print "data[2] == 0xxFF data[3]==%x and data[6:10] = %s"%(ord(data[3]),data[6:10])
- length = ord(data[4])*256+ord(data[5])
- if debug: print "Length offset is",length
- f.read(length-8)
- # fake an EXIF beginning of file
- # I don't think this is used. --gd
- data = '\xFF\x00'+f.read(10)
- fake_exif = 1
- if base>2:
- if debug: print "added to base "
- base = base + length + 4 -2
- else:
- if debug: print "added to zero "
- base = length + 4
- if debug: print "Set segment base to",base
-
- # Big ugly patch to deal with APP2 (or other) data coming before APP1
- f.seek(0)
- data = f.read(base+4000) # in theory, this could be insufficient since 64K is the maximum size--gd
- # base = 2
- while 1:
- if debug: print "Segment base 0x%X" % base
- if data[base:base+2]=='\xFF\xE1':
- # APP1
- if debug: print "APP1 at base",hex(base)
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if data[base+4:base+8] == "Exif":
- if debug: print "Decrement base by",2,"to get to pre-segment header (for compatibility with later code)"
- base = base-2
- break
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- elif data[base:base+2]=='\xFF\xE0':
- # APP0
- if debug: print "APP0 at base",hex(base)
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- elif data[base:base+2]=='\xFF\xE2':
- # APP2
- if debug: print "APP2 at base",hex(base)
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- elif data[base:base+2]=='\xFF\xEE':
- # APP14
- if debug: print "APP14 Adobe segment at base",hex(base)
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- print "There is useful EXIF-like data here, but we have no parser for it."
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- elif data[base:base+2]=='\xFF\xDB':
- if debug: print "JPEG image data at base",hex(base),"No more segments are expected."
- # sys.exit(0)
- break
- elif data[base:base+2]=='\xFF\xD8':
- # APP12
- if debug: print "FFD8 segment at base",hex(base)
- if debug: print "Got",hex(ord(data[base])), hex(ord(data[base+1])),"and", data[4+base:10+base], "instead."
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- elif data[base:base+2]=='\xFF\xEC':
- # APP12
- if debug: print "APP12 XMP (Ducky) or Pictureinfo segment at base",hex(base)
- if debug: print "Got",hex(ord(data[base])), hex(ord(data[base+1])),"and", data[4+base:10+base], "instead."
- if debug: print "Length",hex(ord(data[base+2])), hex(ord(data[base+3]))
- if debug: print "Code",data[base+4:base+8]
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- print "There is useful EXIF-like data here (quality, comment, copyright), but we have no parser for it."
- base=base+ord(data[base+2])*256+ord(data[base+3])+2
- else:
- try:
- if debug: print "Unexpected/unhandled segment type or file content."
- if debug: print "Got",hex(ord(data[base])), hex(ord(data[base+1])),"and", data[4+base:10+base], "instead."
- if debug: print "Increment base by",ord(data[base+2])*256+ord(data[base+3])+2
- except: pass
- try: base=base+ord(data[base+2])*256+ord(data[base+3])+2
- except: pass
-
- f.seek(base+12)
- if data[2+base] == '\xFF' and data[6+base:10+base] == 'Exif':
- # detected EXIF header
- offset = f.tell()
- endian = f.read(1)
- #HACK TEST: endian = 'M'
- elif data[2+base] == '\xFF' and data[6+base:10+base+1] == 'Ducky':
- # detected Ducky header.
- if debug: print "EXIF-like header (normally 0xFF and code):",hex(ord(data[2+base])) , "and", data[6+base:10+base+1]
- offset = f.tell()
- endian = f.read(1)
- elif data[2+base] == '\xFF' and data[6+base:10+base+1] == 'Adobe':
- # detected APP14 (Adobe)
- if debug: print "EXIF-like header (normally 0xFF and code):",hex(ord(data[2+base])) , "and", data[6+base:10+base+1]
- offset = f.tell()
- endian = f.read(1)
- else:
- # no EXIF information
- if debug: print "No EXIF header expected data[2+base]==0xFF and data[6+base:10+base]===Exif (or Duck)"
- if debug: print " but got",hex(ord(data[2+base])) , "and", data[6+base:10+base+1]
- return {}
- else:
- # file format not recognized
- if debug: print "file format not recognized"
- return {}
-
- # deal with the EXIF info we found
- if debug:
- print "Endian format is ",endian
- print {'I': 'Intel', 'M': 'Motorola', '\x01':'Adobe Ducky', 'd':'XMP/Adobe unknown' }[endian], 'format'
- hdr = EXIF_header(f, endian, offset, fake_exif, strict, debug)
- ifd_list = hdr.list_IFDs()
- ctr = 0
- for i in ifd_list:
- if ctr == 0:
- IFD_name = 'Image'
- elif ctr == 1:
- IFD_name = 'Thumbnail'
- thumb_ifd = i
- else:
- IFD_name = 'IFD %d' % ctr
- if debug:
- print ' IFD %d (%s) at offset %d:' % (ctr, IFD_name, i)
- hdr.dump_IFD(i, IFD_name, stop_tag=stop_tag)
- # EXIF IFD
- exif_off = hdr.tags.get(IFD_name+' ExifOffset')
- if exif_off:
- if debug:
- print ' EXIF SubIFD at offset %d:' % exif_off.values[0]
- hdr.dump_IFD(exif_off.values[0], 'EXIF', stop_tag=stop_tag)
- # Interoperability IFD contained in EXIF IFD
- intr_off = hdr.tags.get('EXIF SubIFD InteroperabilityOffset')
- if intr_off:
- if debug:
- print ' EXIF Interoperability SubSubIFD at offset %d:' \
- % intr_off.values[0]
- hdr.dump_IFD(intr_off.values[0], 'EXIF Interoperability',
- dict=INTR_TAGS, stop_tag=stop_tag)
- # GPS IFD
- gps_off = hdr.tags.get(IFD_name+' GPSInfo')
- if gps_off:
- if debug:
- print ' GPS SubIFD at offset %d:' % gps_off.values[0]
- hdr.dump_IFD(gps_off.values[0], 'GPS', dict=GPS_TAGS, stop_tag=stop_tag)
- ctr += 1
-
- # extract uncompressed TIFF thumbnail
- thumb = hdr.tags.get('Thumbnail Compression')
- if thumb and thumb.printable == 'Uncompressed TIFF':
- hdr.extract_TIFF_thumbnail(thumb_ifd)
-
- # JPEG thumbnail (thankfully the JPEG data is stored as a unit)
- thumb_off = hdr.tags.get('Thumbnail JPEGInterchangeFormat')
- if thumb_off:
- f.seek(offset+thumb_off.values[0])
- size = hdr.tags['Thumbnail JPEGInterchangeFormatLength'].values[0]
- hdr.tags['JPEGThumbnail'] = f.read(size)
-
- # deal with MakerNote contained in EXIF IFD
- # (Some apps use MakerNote tags but do not use a format for which we
- # have a description, do not process these).
- if 'EXIF MakerNote' in hdr.tags and 'Image Make' in hdr.tags and detailed:
- hdr.decode_maker_note()
-
- # Sometimes in a TIFF file, a JPEG thumbnail is hidden in the MakerNote
- # since it's not allowed in a uncompressed TIFF IFD
- if 'JPEGThumbnail' not in hdr.tags:
- thumb_off=hdr.tags.get('MakerNote JPEGThumbnail')
- if thumb_off:
- f.seek(offset+thumb_off.values[0])
- hdr.tags['JPEGThumbnail']=file.read(thumb_off.field_length)
-
- return hdr.tags
-
-
-# show command line usage
-def usage(exit_status):
- msg = 'Usage: EXIF.py [OPTIONS] file1 [file2 ...]\n'
- msg += 'Extract EXIF information from digital camera image files.\n\nOptions:\n'
- msg += '-q --quick Do not process MakerNotes.\n'
- msg += '-t TAG --stop-tag TAG Stop processing when this tag is retrieved.\n'
- msg += '-s --strict Run in strict mode (stop on errors).\n'
- msg += '-d --debug Run in debug mode (display extra info).\n'
- print msg
- sys.exit(exit_status)
-
-# library test/debug function (dump given files)
-if __name__ == '__main__':
- import sys
- import getopt
-
- # parse command line options/arguments
- try:
- opts, args = getopt.getopt(sys.argv[1:], "hqsdt:v", ["help", "quick", "strict", "debug", "stop-tag="])
- except getopt.GetoptError:
- usage(2)
- if args == []:
- usage(2)
- detailed = True
- stop_tag = 'UNDEF'
- debug = False
- strict = False
- for o, a in opts:
- if o in ("-h", "--help"):
- usage(0)
- if o in ("-q", "--quick"):
- detailed = False
- if o in ("-t", "--stop-tag"):
- stop_tag = a
- if o in ("-s", "--strict"):
- strict = True
- if o in ("-d", "--debug"):
- debug = True
-
- # output info for each file
- for filename in args:
- try:
- file=open(filename, 'rb')
- except:
- print "'%s' is unreadable\n"%filename
- continue
- print filename + ':'
- # get the tags
- data = process_file(file, stop_tag=stop_tag, details=detailed, strict=strict, debug=debug)
- if not data:
- print 'No EXIF information found'
- continue
-
- x=data.keys()
- x.sort()
- for i in x:
- if i in ('JPEGThumbnail', 'TIFFThumbnail'):
- continue
- try:
- print ' %s (%s): %s' % \
- (i, FIELD_TYPES[data[i].field_type][2], data[i].printable)
- except:
- print 'error', i, '"', data[i], '"'
- if 'JPEGThumbnail' in data:
- print 'File has JPEG thumbnail'
- print
-
projects / mediagoblin.git / commitdiff