--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/degal/exif.py Sat Jun 13 18:34:55 2009 +0300
@@ -0,0 +1,491 @@
+"""
+ A custom EXIF parsing module, aimed at high performance.
+"""
+
+import struct, mmap, os
+
+def read_struct (file, fmt) :
+ """
+ Utility function to read data from the a file using struct
+ """
+
+ # length of data
+ fmt_size = struct.calcsize(fmt)
+
+ # get data
+ file_data = file.read(fmt_size)
+
+ # unpack single item, this should raise an error if file_data is too short
+ return struct.unpack(fmt, file_data)
+
+class Buffer (object) :
+ """
+ Wraps a buffer object (anything that supports the python buffer protocol) for read-only access.
+
+ Includes an offset for relative values, and an endianess for reading binary data.
+ """
+
+ def __init__ (self, obj, offset=None, size=None, struct_prefix='=') :
+ """
+ Create a new Buffer object with a new underlying buffer, created from the given object, offset and size.
+
+ The endiannes is given in the form of a struct-module prefix, which should be one of '<' or '>'.
+ Standard size/alignment are assumed.
+ """
+
+ # store
+ self.buf = buffer(obj, offset, size)
+ self.offset = offset
+ self.size = size
+ self.prefix = struct_prefix
+
+ def subregion (self, offset, length=None) :
+ """
+ Create a new sub-Buffer referencing a view of this buffer, at the given offset, and with the given
+ length, if any, and the same struct_prefix.
+ """
+
+ return Buffer(self.buf, offset, length, struct_prefix=self.prefix)
+
+ def pread (self, offset, length) :
+ """
+ Read a random-access region of raw data
+ """
+
+ return self.buf[offset:offset + length]
+
+ def pread_struct (self, offset, fmt) :
+ """
+ Read structured data using the given struct format from the given offset.
+ """
+
+ return struct.unpack_from(self.prefix + fmt, self.buf, offset=offset)
+
+ def pread_item (self, offset, fmt) :
+ """
+ Read a single item of structured data from the given offset.
+ """
+
+ value, = self.pread_struct(offset, fmt)
+
+ return value
+
+ def iter_offsets (self, count, size, offset=0) :
+ """
+ Yield a series of offsets for `count` items of `size` bytes, beginning at `offset`.
+ """
+
+ return xrange(offset, offset + count * size, size)
+
+ def item_size (self, fmt) :
+ """
+ Returns the size in bytes of the given item format
+ """
+
+ return struct.calcsize(self.prefix + fmt)
+
+ def unpack_item (self, fmt, data) :
+ """
+ Unpacks a single item from the given data
+ """
+
+ value, = struct.unpack(self.prefix + fmt, data)
+
+ return value
+
+def mmap_buffer (file, size) :
+ """
+ Create and return a new read-only mmap'd region
+ """
+
+ return mmap.mmap(file.fileno(), size, access=mmap.ACCESS_READ)
+
+import exif_data
+
+class Tag (object) :
+ """
+ Represents a single Tag in an IFD
+ """
+
+ def __init__ (self, offset, tag, type, count, value_ref) :
+ """
+ Build a Tag with the given binary items from the IFD entry
+ """
+
+ self.offset = offset
+ self.tag = tag
+ self.type = type
+ self.count = count
+ self.value_ref = value_ref
+
+ # lookup the type for this tag
+ self.type_data = exif_data.FIELD_TYPES.get(type)
+
+ # unpack it
+ if self.type_data :
+ self.type_format, self.type_name = self.type_data
+
+ # lookup the tag data for this tag
+ self.tag_data = exif_data.EXIF_TAGS.get(tag)
+
+ # unpack it
+ if self.tag_data :
+ # the EXIF tag name
+ self.tag_name = tag_data[0]
+
+ # the optional value formatting specification
+ if len(self.tag_data) > 1 :
+ self.tag_value_spec = self.tag_data[1]
+
+ else :
+ self.tag_value_spec = None
+
+ @property
+ def name (self) :
+ """
+ Lookup the name of this tag via its code, returns None if unknown.
+ """
+
+ if self.tag_data :
+ return self.tag_name
+
+ else :
+ return None
+
+ def readable_value (self, value) :
+ """
+ Convert the given value for this tag into a human-readable string.
+
+ Returns the value itself by default.
+ """
+
+ if self.tag_data and self.tag_value_spec :
+ # map it
+ return exif_data.tag_value(self.tag_value_spec, value)
+
+ else :
+ # nope...
+ return value
+
+# size of an IFD entry in bytes
+IFD_ENTRY_SIZE = 12
+
+class IFD (Buffer) :
+ """
+ Represents an IFD (Image file directory) region in EXIF data.
+ """
+
+ def __init__ (self, buffer, **buffer_opts) :
+ """
+ Access the IFD data from the given bufferable object with given buffer opts.
+
+ This will read the `count` and `next_offset` values.
+ """
+
+ # init
+ super(IFD, self).__init__(buffer, **buffer_opts)
+
+ # read header
+ self.count = self.pread_item(0, 'H')
+
+ # read next-offset
+ self.next_offset = self.pread_item(0x02 + self.count * IFD_ENTRY_SIZE, 'I')
+
+ def iter_tags (self) :
+ """
+ Iterate over all the Tag objects in this IFD
+ """
+
+ # read each tag
+ for offset in self.iter_offsets(self.count, IFD_ENTRY_SIZE, 0x02) :
+ # read the tag data
+ tag, type, count, value_ref = self.pread_struct(offset, 'HHII')
+
+ # yield the new Tag
+ yield Tag(offset, tag, type, count, value_ref)
+
+class EXIF (Buffer) :
+ """
+ Represents the EXIF data embedded in some image file in the form of a Region.
+ """
+
+ def __init__ (self, buffer, tags=None, **buffer_opts) :
+ """
+ Access the EXIF data from the given bufferable object with the given buffer options.
+
+ `tags`, if given, specifies that only the given named tags should be loaded.
+ """
+
+ # init Buffer
+ super(EXIF, self).__init__(buffer, **buffer_opts)
+
+ # store
+ self.buffer = buffer
+
+ def iter_ifds (self) :
+ """
+ Iterate over all of the IFD objects in this EXIF.
+ """
+
+ # starting offset
+ offset = self.pread_item(0x04, 'I')
+
+ while offset :
+ # create and read the IFD
+ ifd = IFD(self, offset=offset)
+
+ # yield it
+ yield ifd
+
+ # skip to next offset
+ offset = ifd.next_offset
+
+ __iter__ = iter_ifds
+
+ def tag_values (self, tag) :
+ """
+ Get the raw values for the given tag as a tuple.
+
+ Returns None if the tag could not be recognized.
+ """
+
+ # unknown tag?
+ if not tag.type_data :
+ return None
+
+ # size of the data
+ data_size = tag.count * self.item_size(tag.type_format)
+
+ # inline or external?
+ if data_size > 0x04 :
+ # point at the external data
+ offset = self.unpack_item('I', tag.value_ref)
+
+ else :
+ # point at the inline data
+ offset = tag.offset + 0x08
+
+ # read values
+ return self.pread_struct(offset, "%d%s" % (tag.count, tag.type_format))
+
+ def tag_value (self, tag) :
+ """
+ Return the human-readable string value for the given tag.
+ """
+
+ # load the raw values
+ values = self.tag_values(tag)
+
+ # unknown?
+ if not values :
+ return ""
+
+ # return as comma-separated formatted string, yes
+ return ", ".join(tag.readable_value(value) for value in values)
+
+# mapping from two-byte TIFF byte order marker to struct prefix
+TIFF_BYTE_ORDER = {
+ 'II': '<',
+ 'MM': '>',
+}
+
+# "An arbitrary but carefully chosen number (42) that further identifies the file as a TIFF file"
+TIFF_BYTEORDER_MAGIC = 42
+
+def tiff_load (file, length=0, **opts) :
+ """
+ Load the Exif/TIFF data from the given file at its current position with optional length, using exif_load.
+ """
+
+ # all Exif data offsets are relative to the beginning of this TIFF header
+ offset = file.tell()
+
+ # mmap the region for the EXIF data
+ buffer = mmap_region(file, length)
+
+ # read byte-order header
+ byte_order = file.read(2)
+
+ # map to struct prefix
+ struct_prefix = TIFF_BYTE_ORDER[byte_order]
+
+ # validate
+ check_value, = read_struct(file, struct_prefix + 'H')
+
+ if check_value != TIFF_BYTEORDER_MAGIC :
+ raise Exception("Invalid byte-order for TIFF: %2c -> %d" % (byte_order, check_value))
+
+ # build and return the EXIF object with the correct offset/size from the mmap region
+ return EXIF(buffer, offset=offset, size=length, **opts)
+
+# the JPEG markers that don't have any data
+JPEG_NOSIZE_MARKERS = (0xD8, 0xD9)
+
+# the first marker in a JPEG File
+JPEG_START_MARKER = 0xD8
+
+# the JPEG APP1 marker used for EXIF
+JPEG_EXIF_MARKER = 0xE1
+
+# the JPEG APP1 Exif header
+JPEG_EXIF_HEADER = "Exif\x00\x00"
+
+def jpeg_markers (file) :
+ """
+ Iterate over the JPEG markers in the given file, yielding (type_byte, size) tuples.
+
+ The size fields will be 0 for markers with no data. The file will be positioned at the beginning of the data
+ region, and may be seek'd around if needed.
+
+ XXX: find a real implementation of this somewhere?
+ """
+
+ while True :
+ # read type
+ marker_byte, marker_type = read_struct(file, '!BB')
+
+ # validate
+ if marker_byte != 0xff :
+ raise Exception("Not a JPEG marker: %x%x" % (marker_byte, marker_type))
+
+ # special cases for no data
+ if marker_byte in JPEG_NOSIZE_MARKERS :
+ size = 0
+
+ else :
+ # read size field
+ size, = read_struct(file, '!H')
+
+ # validate
+ if size < 0x02 :
+ raise Exception("Invalid size for marker %x%x: %x" % (marker_byte, marker_type, size))
+
+ else :
+ # do not count the size field itself
+ size = size - 2
+
+ # ok, data is at current position
+ offset = file.tell()
+
+ # yield
+ yield marker_type, size
+
+ # absolute seek to next marker
+ file.seek(offset + size)
+
+def jpeg_find_exif (file) :
+ """
+ Find the Exif/TIFF section in the given JPEG file.
+
+ If found, the file will be seek'd to the start of the Exif/TIFF header, and the size of the Exif/TIFF data will
+ be returned.
+
+ Returns None if no EXIF section was found.
+ """
+
+ for count, (marker, size) in enumerate(jpeg_markers(file)) :
+ # verify that it's a JPEG file
+ if count == 0 :
+ # must start with the right marker
+ if marker != JPEG_START_MARKER :
+ raise Exception("JPEG file must start with 0xFF%02x marker" % (marker, ))
+
+ # look for APP1 marker (0xE1) with EXIF signature
+ elif marker == JPEG_EXIF_MARKER and file.read(len(JPEG_EXIF_HEADER)) == JPEG_EXIF_HEADER:
+ # skipped the initial Exif marker signature
+ return size - JPEG_EXIF_HEADER
+
+ # nothing
+ return None
+
+def jpeg_load (file, **opts) :
+ """
+ Loads the embedded Exif TIFF data from the given JPEG file using tiff_load.
+
+ Returns None if no EXIF data could be found.
+ """
+
+ # look for the right section
+ size = jpeg_find_exif(file)
+
+ # not found?
+ if not res :
+ # nothing
+ return
+
+ else :
+ # load it as TIFF data
+ return tiff_load(file, size, **opts)
+
+def load_path (path, **opts) :
+ """
+ Loads an EXIF object from the given filesystem path.
+
+ Returns None if it could not be parsed.
+ """
+
+ # file extension
+ root, fext = os.path.splitext(path)
+
+ # map
+ func = {
+ '.jpeg': jpeg_load,
+ '.jpg': jpeg_load,
+ '.tiff': tiff_load, # XXX: untested
+ }.get(fext.lower())
+
+ # not recognized?
+ if not func :
+ # XXX: sniff the file
+ return None
+
+ # open it
+ file = open(path, 'rb')
+
+ # try and load it
+ return func(file, **opts)
+
+def dump_exif (exif) :
+ """
+ Dump all tags from the given EXIF object to stdout
+ """
+
+ print "EXIF offset=%d, size=%d:" % (exif.offset, exif.size)
+
+ for i, ifd in enumerate(exif.iter_ifds()) :
+ print "\tIFD %d, offset=%d, size=%d, count=%d, next=%d:" % (i, ifd.offset, ifd.size, ifd.count, ifd.next_offset)
+
+ for i, tag in enumerate(exif.iter_tags()) :
+ print "\t\tTag %d, offset=%d, tag=%d/%s, type=%d/%s, count=%d:" % (
+ i,
+ tag.offset,
+ tag.code, tag.name or '???',
+ tag.type, tag.type_name if tag.type_data else '???',
+ tag.count,
+ )
+
+ for i, value in enumerate(exif.tag_values(tag)) :
+ print "\t\t\t%02d: %s" % (i, tag.readable_value(value))
+
+def main (path) :
+ """
+ Load and dump EXIF data from the given path
+ """
+
+ # try and load it
+ exif = load_path(path)
+
+ if not exif :
+ raise Exception("No EXIF data found")
+
+ # dump it
+ print "%s: " % path
+ print
+
+ dump_exif(exif)
+
+if __name__ == '__main__' :
+ from sys import argv
+
+ main(argv[1])
+
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/degal/exif_data.py Sat Jun 13 18:34:55 2009 +0300
@@ -0,0 +1,1180 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+ EXIF file format data, including tag names, types, etc.
+
+ Most of this was copied with modifications from EXIFpy:
+ # Library to extract EXIF information from digital camera image files
+ # http://sourceforge.net/projects/exif-py/
+ #
+ # VERSION 1.1.0
+ #
+ # Copyright (c) 2002-2007 Gene Cash All rights reserved
+ # Copyright (c) 2007-2008 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.
+
+"""
+
+def make_string (seq):
+ """
+ Filter a string to strip out non-printing chars
+ """
+
+ # screen out non-printing characters
+ str = ''.join(c for c in seq if 32 <= c < 256)
+
+ if not str:
+ # no printing chars
+ return seq
+
+ else :
+ return str
+
+def make_string_uc (seq) :
+ """
+ # 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
+
+ XXX: decode?
+ """
+
+ 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(seq)
+
+# IFD Tag type information, indexed by code
+# { type_code: (type_fmt, name) }
+FIELD_TYPES = {
+# 0x0000: (None, 'Proprietary' ), # ??? no such type
+ 0x0001: ('B', 'Byte' ),
+ 0x0002: ('s', 'ASCII' ),
+ 0x0003: ('H', 'Short' ),
+ 0x0004: ('L', 'Long' ),
+ 0x0005: ('LL', 'Ratio' ),
+ 0x0006: ('b', 'Signed Byte' ),
+ 0x0007: ('c', 'Undefined' ),
+ 0x0008: ('h', 'Signed Short' ),
+ 0x0009: ('l', 'Signed Long' ),
+ 0x000A: ('ll', 'Signed Ratio' ),
+}
+
+def map_value (spec, value) :
+ """
+ Map the given tag value to a printable string using the given value spec.
+ """
+
+ if callable(spec):
+ # call mapping function
+ return spec(value)
+
+ else:
+ return spec.get(value, repr(value))
+
+# dictionary of main EXIF tag names
+# first element of tuple is tag name, optional second element is
+# another dictionary giving names to values
+# { tag_type : (name, spec?) }
+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 CW',
+ 7: 'Mirrored horizontal then rotated 90 CW',
+ 8: 'Rotated 90 CCW'}),
+ 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'}),
+ 0x9208: ('LightSource',
+ {0: 'Unknown',
+ 1: 'Daylight',
+ 2: 'Fluorescent',
+ 3: 'Tungsten',
+ 9: 'Fine Weather',
+ 10: 'Flash',
+ 11: 'Shade',
+ 12: 'Daylight Fluorescent',
+ 13: 'Day White Fluorescent',
+ 14: 'Cool White Fluorescent',
+ 15: 'White Fluorescent',
+ 17: 'Standard Light A',
+ 18: 'Standard Light B',
+ 19: 'Standard Light C',
+ 20: 'D55',
+ 21: 'D65',
+ 22: 'D75',
+ 255: 'Other'}),
+ 0x9209: ('Flash',
+ {0: 'No',
+ 1: 'Fired',
+ 5: 'Fired (?)', # no return sensed
+ 7: 'Fired (!)', # return sensed
+ 9: 'Fill Fired',
+ 13: 'Fill Fired (?)',
+ 15: 'Fill Fired (!)',
+ 16: 'Off',
+ 24: 'Auto Off',
+ 25: 'Auto Fired',
+ 29: 'Auto Fired (?)',
+ 31: 'Auto Fired (!)',
+ 32: 'Not Available'}),
+ 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', ),
+ 0x001D: ('GPSDate', ),
+ }
+
+# 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', ),
+ }
+
+# 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
+
+
--- a/degal/lib/EXIF.py Thu Jun 11 23:57:53 2009 +0300
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,1770 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-#
-# Library to extract EXIF information from digital camera image files
-# http://sourceforge.net/projects/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-2008 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 ----- #
-#
-import mmap
-
-# 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(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 CW',
- 7: 'Mirrored horizontal then rotated 90 CW',
- 8: 'Rotated 90 CCW'}),
- 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'}),
- 0x9208: ('LightSource',
- {0: 'Unknown',
- 1: 'Daylight',
- 2: 'Fluorescent',
- 3: 'Tungsten',
- 9: 'Fine Weather',
- 10: 'Flash',
- 11: 'Shade',
- 12: 'Daylight Fluorescent',
- 13: 'Day White Fluorescent',
- 14: 'Cool White Fluorescent',
- 15: 'White Fluorescent',
- 17: 'Standard Light A',
- 18: 'Standard Light B',
- 19: 'Standard Light C',
- 20: 'D55',
- 21: 'D65',
- 22: 'D75',
- 255: 'Other'}),
- 0x9209: ('Flash',
- {0: 'No',
- 1: 'Fired',
- 5: 'Fired (?)', # no return sensed
- 7: 'Fired (!)', # return sensed
- 9: 'Fill Fired',
- 13: 'Fill Fired (?)',
- 15: 'Fill Fired (!)',
- 16: 'Off',
- 24: 'Auto Off',
- 25: 'Auto Fired',
- 29: 'Auto Fired (?)',
- 31: 'Auto Fired (!)',
- 32: 'Not Available'}),
- 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', ),
- 0x001D: ('GPSDate', ),
- }
-
-# 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):
- return '(0x%04X) %s=%s @ %d' % (self.tag,
- FIELD_TYPES[self.field_type][2],
- self.printable,
- self.field_offset)
-
-# class that handles an EXIF header
-class EXIF_header:
- def __init__(self, file, endian, offset, fake_exif, strict, debug=0):
- self.file = file
- self.mmap = mmap.mmap(file.fileno(), 0, access=mmap.ACCESS_READ)
- self.endian = endian
- self.offset = offset
- self.fake_exif = fake_exif
- self.strict = strict
- self.debug = debug
- self.tags = {}
-
- def pread(self, reloffset, length):
- """Read <length> bytes from self.file at relative offset <offset>"""
-
- offset = self.offset + reloffset
-
- return self.mmap[offset:offset + length]
-
- # 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):
- slice=self.pread(offset, 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)
- return self.s2n(ifd+2+12*entries, 4)
-
- # 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):
- values = self.pread(offset, count)
- #print values
- # Drop any garbage after a null.
- values = values.split('\x00', 1)[0]
- else:
- 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
- tiff += self.pread(thumb_ifd, 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
- tiff += self.pread(oldoff, 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
- tiff += self.pread(old_offsets[i], 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)):
- 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
- while data[2] == '\xFF' and data[6:10] in ('JFIF', 'JFXX', 'OLYM', 'Phot'):
- length = ord(data[4])*256+ord(data[5])
- f.read(length-8)
- # fake an EXIF beginning of file
- data = '\xFF\x00'+f.read(10)
- fake_exif = 1
- if data[2] == '\xFF' and data[6:10] == 'Exif':
- # detected EXIF header
- offset = f.tell()
- endian = f.read(1)
- else:
- # no EXIF information
- return {}
- else:
- # file format not recognized
- return {}
-
- # deal with the EXIF info we found
- if debug:
- print {'I': 'Intel', 'M': 'Motorola'}[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
-
--- a/degal/lib/EXIFpy-1.0.8-changes.txt Thu Jun 11 23:57:53 2009 +0300
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,114 +0,0 @@
-~ EXIF.py Changelog ~
-
-2009-06-11 - Tero Marttila <terom@fixme.fi>
-Replace file.seek/file.read calls with direct mmap access
-
-2008-07-31 - Ianaré Sévi
-Wikipedia Commons hunt for suitable test case images,
-testing new code additions.
-
-2008-07-09 - Stephen H. Olson
-Fix a problem with reading MakerNotes out of NEF files.
-Add some more Nikon MakerNote tags.
-
-2008-07-08 - Stephen H. Olson
-An error check for large tags totally borked MakerNotes.
- With Nikon anyway, valid MakerNotes can be pretty big.
-Add error check for a crash caused by nikon_ev_bias being
- called with the wrong args.
-Drop any garbage after a null character in string
- (patch from Andrew McNabb <amcnabb@google.com>).
-
-2008-02-12 - Ianaré Sévi
-Fix crash on invalid MakerNote
-Fix crash on huge Makernote (temp fix)
-Add printIM tag 0xC4A5, needs decoding info
-Add 0x9C9B-F range of tags
-Add a bunch of tag definitions from:
- http://owl.phy.queensu.ca/~phil/exiftool/TagNames/EXIF.html
-Add 'strict' variable and command line option
-
-2008-01-18 - Gunter Ohrner
-Add 'GPSDate' tag
-
-2007-12-12 - Ianaré Sévi
-Fix quick option on certain image types
-Add note on tag naming in documentation
-
-2007-11-30 - Ianaré Sévi
-Changed -s option to -t
-Put changelog into separate file
-
-2007-10-28 - Ianaré Sévi
-Merged changes from MoinMoin:ReimarBauer
-Added command line option for debug, stop
-processing on tag.
-
-2007-09-27 - Ianaré Sévi
-Add some Olympus Makernote tags.
-
-2007-09-26 - Stephen H. Olson
-Don't error out on invalid Olympus 'SpecialMode'.
-Add a few more Olympus/Minolta tags.
-
-2007-09-22 - Stephen H. Olson
-Don't error on invalid string
-Improved Nikon MakerNote support
-
-2007-05-03 - Martin Stone <mj_stone@users.sourceforge.net>
-Fix for inverted detailed flag and Photoshop header
-
-2007-03-24 - Ianaré Sévi
-Can now ignore MakerNotes Tags for faster processing.
-
-2007-01-18 - Ianaré Sévi <ianare@gmail.com>
-Fixed a couple errors and assuming maintenance of the library.
-
-2006-08-04 MoinMoin:ReimarBauer
-Added an optional parameter name to process_file and dump_IFD. Using this parameter the
-loop is breaked after that tag_name is processed.
-some PEP8 changes
-
----------------------------- original notices -------------------------
-
-Contains code from "exifdump.py" originally written by Thierry Bousch
-<bousch@topo.math.u-psud.fr> and released into the public domain.
-
-Updated and turned into general-purpose library by Gene Cash
-
-Patch Contributors:
-* Simon J. Gerraty <sjg@crufty.net>
-s2n fix & orientation decode
-* John T. Riedl <riedl@cs.umn.edu>
-Added support for newer Nikon type 3 Makernote format for D70 and some
-other Nikon cameras.
-* Joerg Schaefer <schaeferj@gmx.net>
-Fixed subtle bug when faking an EXIF header, which affected maker notes
-using relative offsets, and a fix for Nikon D100.
-
-1999-08-21 TB Last update by Thierry Bousch to his code.
-2002-01-17 CEC Discovered code on web.
- Commented everything.
- Made small code improvements.
- Reformatted for readability.
-2002-01-19 CEC Added ability to read TIFFs and JFIF-format JPEGs.
- Added ability to extract JPEG formatted thumbnail.
- Added ability to read GPS IFD (not tested).
- Converted IFD data structure to dictionaries indexed by
- tag name.
- Factored into library returning dictionary of IFDs plus
- thumbnail, if any.
-2002-01-20 CEC Added MakerNote processing logic.
- Added Olympus MakerNote.
- Converted data structure to single-level dictionary, avoiding
- tag name collisions by prefixing with IFD name. This makes
- it much easier to use.
-2002-01-23 CEC Trimmed nulls from end of string values.
-2002-01-25 CEC Discovered JPEG thumbnail in Olympus TIFF MakerNote.
-2002-01-26 CEC Added ability to extract TIFF thumbnails.
- Added Nikon, Fujifilm, Casio MakerNotes.
-2003-11-30 CEC Fixed problem with canon_decode_tag() not creating an
- IFD_Tag() object.
-2004-02-15 CEC Finally fixed bit shift warning by converting Y to 0L.
-
-~ EOF ~