1

#!/usr/bin/env python

     2

# -*- coding: utf-8 -*-

     3

     4

"""

     5

    EXIF file format data, including tag names, types, etc.

     6

     7

    Most of this was copied with modifications from EXIFpy:

     8

        # Library to extract EXIF information from digital camera image files

     9

        # http://sourceforge.net/projects/exif-py/

    10

        #

    11

        # VERSION 1.1.0

    12

        #

    13

        # Copyright (c) 2002-2007 Gene Cash All rights reserved

    14

        # Copyright (c) 2007-2008 Ianaré Sévi All rights reserved

    15

        #

    16

        # Redistribution and use in source and binary forms, with or without

    17

        # modification, are permitted provided that the following conditions

    18

        # are met:

    19

        #

    20

        #  1. Redistributions of source code must retain the above copyright

    21

        #     notice, this list of conditions and the following disclaimer.

    22

        #

    23

        #  2. Redistributions in binary form must reproduce the above

    24

        #     copyright notice, this list of conditions and the following

    25

        #     disclaimer in the documentation and/or other materials provided

    26

        #     with the distribution.

    27

        #

    28

        #  3. Neither the name of the authors nor the names of its contributors

    29

        #     may be used to endorse or promote products derived from this

    30

        #     software without specific prior written permission.

    31

        #

    32

        # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

    33

        # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

    34

        # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

    35

        # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

    36

        # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    37

        # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    38

        # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

    39

        # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

    40

        # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

    41

        # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

    42

        # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    43

    44

"""

    45

    46

def make_string (seq):

    47

    """

    48

        Filter a string to strip out non-printing chars

    49

    """

    50

    51

    # screen out non-printing characters

    52

    str = ''.join(c for c in seq if 32 <= c < 256)

    53

    54

    if not str:

    55

        # no printing chars

    56

        return seq

    57

    58

    else :

    59

        return str

    60

    61

def make_string_uc (seq) :

    62

    """

    63

        # Special version to deal with the code in the first 8 bytes of a user comment.

    64

        # First 8 bytes gives coding system e.g. ASCII vs. JIS vs Unicode

    65

    66

        XXX: decode?

    67

    """

    68

    69

    code = seq[0:8]

    70

    seq = seq[8:]

    71

    72

    ## Of course, this is only correct if ASCII, and the standard explicitly

    73

    ## allows JIS and Unicode.

    74

    return make_string(seq)

    75

    76

# IFD Tag type information, indexed by code

    77

#  { type_code: (type_fmt, name) }

    78

FIELD_TYPES = {

    79

#    0x0000: (None,  'Proprietary'   ), # ??? no such type

    80

    0x0001: ('B',   'Byte'          ),

    81

    0x0002: ('s',   'ASCII'         ),

    82

    0x0003: ('H',   'Short'         ),

    83

    0x0004: ('L',   'Long'          ),

    84

    0x0005: ('LL',  'Ratio'         ),

    85

    0x0006: ('b',   'Signed Byte'   ),

    86

    0x0007: ('c',   'Undefined'     ),

    87

    0x0008: ('h',   'Signed Short'  ),

    88

    0x0009: ('l',   'Signed Long'   ),

    89

    0x000A: ('ll',  'Signed Ratio'  ),

    90

}

    91

    92

def map_value (spec, value) :

    93

    """

    94

        Map the given tag value to a printable string using the given value spec.

    95

    """

    96

    97

    if callable(spec):

    98

        # call mapping function

    99

        return spec(value)

   100

   101

    else:

   102

        return spec.get(value, repr(value))

   103

   104

# dictionary of main EXIF tag names

   105

# first element of tuple is tag name, optional second element is

   106

# another dictionary giving names to values

   107

# { tag_type : (name, spec?) }

   108

EXIF_TAGS = {

   109

    0x0100: ('ImageWidth', ),

   110

    0x0101: ('ImageLength', ),

   111

    0x0102: ('BitsPerSample', ),

   112

    0x0103: ('Compression',

   113

             {1: 'Uncompressed',

   114

              2: 'CCITT 1D',

   115

              3: 'T4/Group 3 Fax',

   116

              4: 'T6/Group 4 Fax',

   117

              5: 'LZW',

   118

              6: 'JPEG (old-style)',

   119

              7: 'JPEG',

   120

              8: 'Adobe Deflate',

   121

              9: 'JBIG B&W',

   122

              10: 'JBIG Color',

   123

              32766: 'Next',

   124

              32769: 'Epson ERF Compressed',

   125

              32771: 'CCIRLEW',

   126

              32773: 'PackBits',

   127

              32809: 'Thunderscan',

   128

              32895: 'IT8CTPAD',

   129

              32896: 'IT8LW',

   130

              32897: 'IT8MP',

   131

              32898: 'IT8BL',

   132

              32908: 'PixarFilm',

   133

              32909: 'PixarLog',

   134

              32946: 'Deflate',

   135

              32947: 'DCS',

   136

              34661: 'JBIG',

   137

              34676: 'SGILog',

   138

              34677: 'SGILog24',

   139

              34712: 'JPEG 2000',

   140

              34713: 'Nikon NEF Compressed',

   141

              65000: 'Kodak DCR Compressed',

   142

              65535: 'Pentax PEF Compressed'}),

   143

    0x0106: ('PhotometricInterpretation', ),

   144

    0x0107: ('Thresholding', ),

   145

    0x010A: ('FillOrder', ),

   146

    0x010D: ('DocumentName', ),

   147

    0x010E: ('ImageDescription', ),

   148

    0x010F: ('Make', ),

   149

    0x0110: ('Model', ),

   150

    0x0111: ('StripOffsets', ),

   151

    0x0112: ('Orientation',

   152

             {1: 'Horizontal (normal)',

   153

              2: 'Mirrored horizontal',

   154

              3: 'Rotated 180',

   155

              4: 'Mirrored vertical',

   156

              5: 'Mirrored horizontal then rotated 90 CCW',

   157

              6: 'Rotated 90 CW',

   158

              7: 'Mirrored horizontal then rotated 90 CW',

   159

              8: 'Rotated 90 CCW'}),

   160

    0x0115: ('SamplesPerPixel', ),

   161

    0x0116: ('RowsPerStrip', ),

   162

    0x0117: ('StripByteCounts', ),

   163

    0x011A: ('XResolution', ),

   164

    0x011B: ('YResolution', ),

   165

    0x011C: ('PlanarConfiguration', ),

   166

    0x011D: ('PageName', make_string),

   167

    0x0128: ('ResolutionUnit',

   168

             {1: 'Not Absolute',

   169

              2: 'Pixels/Inch',

   170

              3: 'Pixels/Centimeter'}),

   171

    0x012D: ('TransferFunction', ),

   172

    0x0131: ('Software', ),

   173

    0x0132: ('DateTime', ),

   174

    0x013B: ('Artist', ),

   175

    0x013E: ('WhitePoint', ),

   176

    0x013F: ('PrimaryChromaticities', ),

   177

    0x0156: ('TransferRange', ),

   178

    0x0200: ('JPEGProc', ),

   179

    0x0201: ('JPEGInterchangeFormat', ),

   180

    0x0202: ('JPEGInterchangeFormatLength', ),

   181

    0x0211: ('YCbCrCoefficients', ),

   182

    0x0212: ('YCbCrSubSampling', ),

   183

    0x0213: ('YCbCrPositioning',

   184

             {1: 'Centered',

   185

              2: 'Co-sited'}),

   186

    0x0214: ('ReferenceBlackWhite', ),

   187

   188

    0x4746: ('Rating', ),

   189

   190

    0x828D: ('CFARepeatPatternDim', ),

   191

    0x828E: ('CFAPattern', ),

   192

    0x828F: ('BatteryLevel', ),

   193

    0x8298: ('Copyright', ),

   194

    0x829A: ('ExposureTime', ),

   195

    0x829D: ('FNumber', ),

   196

    0x83BB: ('IPTC/NAA', ),

   197

    0x8769: ('ExifOffset', ),

   198

    0x8773: ('InterColorProfile', ),

   199

    0x8822: ('ExposureProgram',

   200

             {0: 'Unidentified',

   201

              1: 'Manual',

   202

              2: 'Program Normal',

   203

              3: 'Aperture Priority',

   204

              4: 'Shutter Priority',

   205

              5: 'Program Creative',

   206

              6: 'Program Action',

   207

              7: 'Portrait Mode',

   208

              8: 'Landscape Mode'}),

   209

    0x8824: ('SpectralSensitivity', ),

   210

    0x8825: ('GPSInfo', ),

   211

    0x8827: ('ISOSpeedRatings', ),

   212

    0x8828: ('OECF', ),

   213

    0x9000: ('ExifVersion', make_string),

   214

    0x9003: ('DateTimeOriginal', ),

   215

    0x9004: ('DateTimeDigitized', ),

   216

    0x9101: ('ComponentsConfiguration',

   217

             {0: '',

   218

              1: 'Y',

   219

              2: 'Cb',

   220

              3: 'Cr',

   221

              4: 'Red',

   222

              5: 'Green',

   223

              6: 'Blue'}),

   224

    0x9102: ('CompressedBitsPerPixel', ),

   225

    0x9201: ('ShutterSpeedValue', ),

   226

    0x9202: ('ApertureValue', ),

   227

    0x9203: ('BrightnessValue', ),

   228

    0x9204: ('ExposureBiasValue', ),

   229

    0x9205: ('MaxApertureValue', ),

   230

    0x9206: ('SubjectDistance', ),

   231

    0x9207: ('MeteringMode',

   232

             {0: 'Unidentified',

   233

              1: 'Average',

   234

              2: 'CenterWeightedAverage',

   235

              3: 'Spot',

   236

              4: 'MultiSpot',

   237

              5: 'Pattern'}),

   238

    0x9208: ('LightSource',

   239

             {0: 'Unknown',

   240

              1: 'Daylight',

   241

              2: 'Fluorescent',

   242

              3: 'Tungsten',

   243

              9: 'Fine Weather',

   244

              10: 'Flash',

   245

              11: 'Shade',

   246

              12: 'Daylight Fluorescent',

   247

              13: 'Day White Fluorescent',

   248

              14: 'Cool White Fluorescent',

   249

              15: 'White Fluorescent',

   250

              17: 'Standard Light A',

   251

              18: 'Standard Light B',

   252

              19: 'Standard Light C',

   253

              20: 'D55',

   254

              21: 'D65',

   255

              22: 'D75',

   256

              255: 'Other'}),

   257

    0x9209: ('Flash',

   258

             {0: 'No',

   259

              1: 'Fired',

   260

              5: 'Fired (?)', # no return sensed

   261

              7: 'Fired (!)', # return sensed

   262

              9: 'Fill Fired',

   263

              13: 'Fill Fired (?)',

   264

              15: 'Fill Fired (!)',

   265

              16: 'Off',

   266

              24: 'Auto Off',

   267

              25: 'Auto Fired',

   268

              29: 'Auto Fired (?)',

   269

              31: 'Auto Fired (!)',

   270

              32: 'Not Available'}),

   271

    0x920A: ('FocalLength', ),

   272

    0x9214: ('SubjectArea', ),

   273

    0x927C: ('MakerNote', ),

   274

    0x9286: ('UserComment', make_string_uc),

   275

    0x9290: ('SubSecTime', ),

   276

    0x9291: ('SubSecTimeOriginal', ),

   277

    0x9292: ('SubSecTimeDigitized', ),

   278

   279

    # used by Windows Explorer

   280

    0x9C9B: ('XPTitle', ),

   281

    0x9C9C: ('XPComment', ),

   282

    0x9C9D: ('XPAuthor', ), #(ignored by Windows Explorer if Artist exists)

   283

    0x9C9E: ('XPKeywords', ),

   284

    0x9C9F: ('XPSubject', ),

   285

   286

    0xA000: ('FlashPixVersion', make_string),

   287

    0xA001: ('ColorSpace',

   288

             {1: 'sRGB',

   289

              2: 'Adobe RGB',

   290

              65535: 'Uncalibrated'}),

   291

    0xA002: ('ExifImageWidth', ),

   292

    0xA003: ('ExifImageLength', ),

   293

    0xA005: ('InteroperabilityOffset', ),

   294

    0xA20B: ('FlashEnergy', ),               # 0x920B in TIFF/EP

   295

    0xA20C: ('SpatialFrequencyResponse', ),  # 0x920C

   296

    0xA20E: ('FocalPlaneXResolution', ),     # 0x920E

   297

    0xA20F: ('FocalPlaneYResolution', ),     # 0x920F

   298

    0xA210: ('FocalPlaneResolutionUnit', ),  # 0x9210

   299

    0xA214: ('SubjectLocation', ),           # 0x9214

   300

    0xA215: ('ExposureIndex', ),             # 0x9215

   301

    0xA217: ('SensingMethod',                # 0x9217

   302

             {1: 'Not defined',

   303

              2: 'One-chip color area',

   304

              3: 'Two-chip color area',

   305

              4: 'Three-chip color area',

   306

              5: 'Color sequential area',

   307

              7: 'Trilinear',

   308

              8: 'Color sequential linear'}),             

   309

    0xA300: ('FileSource',

   310

             {1: 'Film Scanner',

   311

              2: 'Reflection Print Scanner',

   312

              3: 'Digital Camera'}),

   313

    0xA301: ('SceneType',

   314

             {1: 'Directly Photographed'}),

   315

    0xA302: ('CVAPattern', ),

   316

    0xA401: ('CustomRendered',

   317

             {0: 'Normal',

   318

              1: 'Custom'}),

   319

    0xA402: ('ExposureMode',

   320

             {0: 'Auto Exposure',

   321

              1: 'Manual Exposure',

   322

              2: 'Auto Bracket'}),

   323

    0xA403: ('WhiteBalance',

   324

             {0: 'Auto',

   325

              1: 'Manual'}),

   326

    0xA404: ('DigitalZoomRatio', ),

   327

    0xA405: ('FocalLengthIn35mmFilm', ),

   328

    0xA406: ('SceneCaptureType',

   329

             {0: 'Standard',

   330

              1: 'Landscape',

   331

              2: 'Portrait',

   332

              3: 'Night)'}),

   333

    0xA407: ('GainControl',

   334

             {0: 'None',

   335

              1: 'Low gain up',

   336

              2: 'High gain up',

   337

              3: 'Low gain down',

   338

              4: 'High gain down'}),

   339

    0xA408: ('Contrast',

   340

             {0: 'Normal',

   341

              1: 'Soft',

   342

              2: 'Hard'}),

   343

    0xA409: ('Saturation',

   344

             {0: 'Normal',

   345

              1: 'Soft',

   346

              2: 'Hard'}),

   347

    0xA40A: ('Sharpness',

   348

             {0: 'Normal',

   349

              1: 'Soft',

   350

              2: 'Hard'}),

   351

    0xA40B: ('DeviceSettingDescription', ),

   352

    0xA40C: ('SubjectDistanceRange', ),

   353

    0xA500: ('Gamma', ),

   354

    0xC4A5: ('PrintIM', ),

   355

    0xEA1C:	('Padding', ),

   356

    }

   357

   358

# interoperability tags

   359

INTR_TAGS = {

   360

    0x0001: ('InteroperabilityIndex', ),

   361

    0x0002: ('InteroperabilityVersion', ),

   362

    0x1000: ('RelatedImageFileFormat', ),

   363

    0x1001: ('RelatedImageWidth', ),

   364

    0x1002: ('RelatedImageLength', ),

   365

    }

   366

   367

# GPS tags (not used yet, haven't seen camera with GPS)

   368

GPS_TAGS = {

   369

    0x0000: ('GPSVersionID', ),

   370

    0x0001: ('GPSLatitudeRef', ),

   371

    0x0002: ('GPSLatitude', ),

   372

    0x0003: ('GPSLongitudeRef', ),

   373

    0x0004: ('GPSLongitude', ),

   374

    0x0005: ('GPSAltitudeRef', ),

   375

    0x0006: ('GPSAltitude', ),

   376

    0x0007: ('GPSTimeStamp', ),

   377

    0x0008: ('GPSSatellites', ),

   378

    0x0009: ('GPSStatus', ),

   379

    0x000A: ('GPSMeasureMode', ),

   380

    0x000B: ('GPSDOP', ),

   381

    0x000C: ('GPSSpeedRef', ),

   382

    0x000D: ('GPSSpeed', ),

   383

    0x000E: ('GPSTrackRef', ),

   384

    0x000F: ('GPSTrack', ),

   385

    0x0010: ('GPSImgDirectionRef', ),

   386

    0x0011: ('GPSImgDirection', ),

   387

    0x0012: ('GPSMapDatum', ),

   388

    0x0013: ('GPSDestLatitudeRef', ),

   389

    0x0014: ('GPSDestLatitude', ),

   390

    0x0015: ('GPSDestLongitudeRef', ),

   391

    0x0016: ('GPSDestLongitude', ),

   392

    0x0017: ('GPSDestBearingRef', ),

   393

    0x0018: ('GPSDestBearing', ),

   394

    0x0019: ('GPSDestDistanceRef', ),

   395

    0x001A: ('GPSDestDistance', ),

   396

    0x001D: ('GPSDate', ),

   397

    }

   398

   399

# Ignore these tags when quick processing

   400

# 0x927C is MakerNote Tags

   401

# 0x9286 is user comment

   402

IGNORE_TAGS=(0x9286, 0x927C)

   403

   404

# http://tomtia.plala.jp/DigitalCamera/MakerNote/index.asp

   405

def nikon_ev_bias(seq):

   406

    # First digit seems to be in steps of 1/6 EV.

   407

    # Does the third value mean the step size?  It is usually 6,

   408

    # but it is 12 for the ExposureDifference.

   409

    #

   410

    # Check for an error condition that could cause a crash.

   411

    # This only happens if something has gone really wrong in

   412

    # reading the Nikon MakerNote.

   413

    if len( seq ) < 4 : return ""

   414

    #

   415

    if seq == [252, 1, 6, 0]:

   416

        return "-2/3 EV"

   417

    if seq == [253, 1, 6, 0]:

   418

        return "-1/2 EV"

   419

    if seq == [254, 1, 6, 0]:

   420

        return "-1/3 EV"

   421

    if seq == [0, 1, 6, 0]:

   422

        return "0 EV"

   423

    if seq == [2, 1, 6, 0]:

   424

        return "+1/3 EV"

   425

    if seq == [3, 1, 6, 0]:

   426

        return "+1/2 EV"

   427

    if seq == [4, 1, 6, 0]:

   428

        return "+2/3 EV"

   429

    # Handle combinations not in the table.

   430

    a = seq[0]

   431

    # Causes headaches for the +/- logic, so special case it.

   432

    if a == 0:

   433

        return "0 EV"

   434

    if a > 127:

   435

        a = 256 - a

   436

        ret_str = "-"

   437

    else:

   438

        ret_str = "+"

   439

    b = seq[2]	# Assume third value means the step size

   440

    whole = a / b

   441

    a = a % b

   442

    if whole != 0:

   443

        ret_str = ret_str + str(whole) + " "

   444

    if a == 0:

   445

        ret_str = ret_str + "EV"

   446

    else:

   447

        r = Ratio(a, b)

   448

        ret_str = ret_str + r.__repr__() + " EV"

   449

    return ret_str

   450

   451

# Nikon E99x MakerNote Tags

   452

MAKERNOTE_NIKON_NEWER_TAGS={

   453

    0x0001: ('MakernoteVersion', make_string),	# Sometimes binary

   454

    0x0002: ('ISOSetting', make_string),

   455

    0x0003: ('ColorMode', ),

   456

    0x0004: ('Quality', ),

   457

    0x0005: ('Whitebalance', ),

   458

    0x0006: ('ImageSharpening', ),

   459

    0x0007: ('FocusMode', ),

   460

    0x0008: ('FlashSetting', ),

   461

    0x0009: ('AutoFlashMode', ),

   462

    0x000B: ('WhiteBalanceBias', ),

   463

    0x000C: ('WhiteBalanceRBCoeff', ),

   464

    0x000D: ('ProgramShift', nikon_ev_bias),

   465

    # Nearly the same as the other EV vals, but step size is 1/12 EV (?)

   466

    0x000E: ('ExposureDifference', nikon_ev_bias),

   467

    0x000F: ('ISOSelection', ),

   468

    0x0011: ('NikonPreview', ),

   469

    0x0012: ('FlashCompensation', nikon_ev_bias),

   470

    0x0013: ('ISOSpeedRequested', ),

   471

    0x0016: ('PhotoCornerCoordinates', ),

   472

    # 0x0017: Unknown, but most likely an EV value

   473

    0x0018: ('FlashBracketCompensationApplied', nikon_ev_bias),

   474

    0x0019: ('AEBracketCompensationApplied', ),

   475

    0x001A: ('ImageProcessing', ),

   476

    0x001B: ('CropHiSpeed', ),

   477

    0x001D: ('SerialNumber', ),	# Conflict with 0x00A0 ?

   478

    0x001E: ('ColorSpace', ),

   479

    0x001F: ('VRInfo', ),

   480

    0x0020: ('ImageAuthentication', ),

   481

    0x0022: ('ActiveDLighting', ),

   482

    0x0023: ('PictureControl', ),

   483

    0x0024: ('WorldTime', ),

   484

    0x0025: ('ISOInfo', ),

   485

    0x0080: ('ImageAdjustment', ),

   486

    0x0081: ('ToneCompensation', ),

   487

    0x0082: ('AuxiliaryLens', ),

   488

    0x0083: ('LensType', ),

   489

    0x0084: ('LensMinMaxFocalMaxAperture', ),

   490

    0x0085: ('ManualFocusDistance', ),

   491

    0x0086: ('DigitalZoomFactor', ),

   492

    0x0087: ('FlashMode',

   493

             {0x00: 'Did Not Fire',

   494

              0x01: 'Fired, Manual',

   495

              0x07: 'Fired, External',

   496

              0x08: 'Fired, Commander Mode ',

   497

              0x09: 'Fired, TTL Mode'}),

   498

    0x0088: ('AFFocusPosition',

   499

             {0x0000: 'Center',

   500

              0x0100: 'Top',

   501

              0x0200: 'Bottom',

   502

              0x0300: 'Left',

   503

              0x0400: 'Right'}),

   504

    0x0089: ('BracketingMode',

   505

             {0x00: 'Single frame, no bracketing',

   506

              0x01: 'Continuous, no bracketing',

   507

              0x02: 'Timer, no bracketing',

   508

              0x10: 'Single frame, exposure bracketing',

   509

              0x11: 'Continuous, exposure bracketing',

   510

              0x12: 'Timer, exposure bracketing',

   511

              0x40: 'Single frame, white balance bracketing',

   512

              0x41: 'Continuous, white balance bracketing',

   513

              0x42: 'Timer, white balance bracketing'}),

   514

    0x008A: ('AutoBracketRelease', ),

   515

    0x008B: ('LensFStops', ),

   516

    0x008C: ('NEFCurve1', ),	# ExifTool calls this 'ContrastCurve'

   517

    0x008D: ('ColorMode', ),

   518

    0x008F: ('SceneMode', ),

   519

    0x0090: ('LightingType', ),

   520

    0x0091: ('ShotInfo', ),	# First 4 bytes are a version number in ASCII

   521

    0x0092: ('HueAdjustment', ),

   522

    # ExifTool calls this 'NEFCompression', should be 1-4

   523

    0x0093: ('Compression', ),

   524

    0x0094: ('Saturation',

   525

             {-3: 'B&W',

   526

              -2: '-2',

   527

              -1: '-1',

   528

              0: '0',

   529

              1: '1',

   530