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

   107

def make_string (seq):

   108

    """

   109

        Filter a string to strip out non-printing chars

   110

    """

   111

   112

    # screen out non-printing characters

   113

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

   114

   115

    if not str:

   116

        # no printing chars

   117

        return seq

   118

   119

    else :

   120

        return str

   121

   122

def make_string_uc (seq) :

   123

    """

   124

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

   125

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

   126

   127

        XXX: decode?

   128

    """

   129

   130

    code = seq[0:8]

   131

    seq = seq[8:]

   132

   133

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

   134

    ## allows JIS and Unicode.

   135

    return make_string(seq)

   136

   137

   138

# dictionary of main EXIF tag names

   139

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

   140

# another dictionary giving names to values

   141

# { tag_type : (name, spec?) }

   142

EXIF_TAGS = {

   143

    0x0100: ('ImageWidth', ),

   144

    0x0101: ('ImageLength', ),

   145

    0x0102: ('BitsPerSample', ),

   146

    0x0103: ('Compression',

   147

             {1: 'Uncompressed',

   148

              2: 'CCITT 1D',

   149

              3: 'T4/Group 3 Fax',

   150

              4: 'T6/Group 4 Fax',

   151

              5: 'LZW',

   152

              6: 'JPEG (old-style)',

   153

              7: 'JPEG',

   154

              8: 'Adobe Deflate',

   155

              9: 'JBIG B&W',

   156

              10: 'JBIG Color',

   157

              32766: 'Next',

   158

              32769: 'Epson ERF Compressed',

   159

              32771: 'CCIRLEW',

   160

              32773: 'PackBits',

   161

              32809: 'Thunderscan',

   162

              32895: 'IT8CTPAD',

   163

              32896: 'IT8LW',

   164

              32897: 'IT8MP',

   165

              32898: 'IT8BL',

   166

              32908: 'PixarFilm',

   167

              32909: 'PixarLog',

   168

              32946: 'Deflate',

   169

              32947: 'DCS',

   170

              34661: 'JBIG',

   171

              34676: 'SGILog',

   172

              34677: 'SGILog24',

   173

              34712: 'JPEG 2000',

   174

              34713: 'Nikon NEF Compressed',

   175

              65000: 'Kodak DCR Compressed',

   176

              65535: 'Pentax PEF Compressed'}),

   177

    0x0106: ('PhotometricInterpretation', ),

   178

    0x0107: ('Thresholding', ),

   179

    0x010A: ('FillOrder', ),

   180

    0x010D: ('DocumentName', ),

   181

    0x010E: ('ImageDescription', ),

   182

    0x010F: ('Make', ),

   183

    0x0110: ('Model', ),

   184

    0x0111: ('StripOffsets', ),

   185

    0x0112: ('Orientation',

   186

             {1: 'Horizontal (normal)',

   187

              2: 'Mirrored horizontal',

   188

              3: 'Rotated 180',

   189

              4: 'Mirrored vertical',

   190

              5: 'Mirrored horizontal then rotated 90 CCW',

   191

              6: 'Rotated 90 CW',

   192

              7: 'Mirrored horizontal then rotated 90 CW',

   193

              8: 'Rotated 90 CCW'}),

   194

    0x0115: ('SamplesPerPixel', ),

   195

    0x0116: ('RowsPerStrip', ),

   196

    0x0117: ('StripByteCounts', ),

   197

    0x011A: ('XResolution', ),

   198

    0x011B: ('YResolution', ),

   199

    0x011C: ('PlanarConfiguration', ),

   200

    0x011D: ('PageName', make_string),

   201

    0x0128: ('ResolutionUnit',

   202

             {1: 'Not Absolute',

   203

              2: 'Pixels/Inch',

   204

              3: 'Pixels/Centimeter'}),

   205

    0x012D: ('TransferFunction', ),

   206

    0x0131: ('Software', ),

   207

    0x0132: ('DateTime', ),

   208

    0x013B: ('Artist', ),

   209

    0x013E: ('WhitePoint', ),

   210

    0x013F: ('PrimaryChromaticities', ),

   211

    0x0156: ('TransferRange', ),

   212

    0x0200: ('JPEGProc', ),

   213

    0x0201: ('JPEGInterchangeFormat', ),

   214

    0x0202: ('JPEGInterchangeFormatLength', ),

   215

    0x0211: ('YCbCrCoefficients', ),

   216

    0x0212: ('YCbCrSubSampling', ),

   217

    0x0213: ('YCbCrPositioning',

   218

             {1: 'Centered',

   219

              2: 'Co-sited'}),

   220

    0x0214: ('ReferenceBlackWhite', ),

   221

   222

    0x4746: ('Rating', ),

   223

   224

    0x828D: ('CFARepeatPatternDim', ),

   225

    0x828E: ('CFAPattern', ),

   226

    0x828F: ('BatteryLevel', ),

   227

    0x8298: ('Copyright', ),

   228

    0x829A: ('ExposureTime', ),

   229

    0x829D: ('FNumber', ),

   230

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

   231

    0x8769: ('ExifOffset', ),

   232

    0x8773: ('InterColorProfile', ),

   233

    0x8822: ('ExposureProgram',

   234

             {0: 'Unidentified',

   235

              1: 'Manual',

   236

              2: 'Program Normal',

   237

              3: 'Aperture Priority',

   238

              4: 'Shutter Priority',

   239

              5: 'Program Creative',

   240

              6: 'Program Action',

   241

              7: 'Portrait Mode',

   242

              8: 'Landscape Mode'}),

   243

    0x8824: ('SpectralSensitivity', ),

   244

    0x8825: ('GPSInfo', ),

   245

    0x8827: ('ISOSpeedRatings', ),

   246

    0x8828: ('OECF', ),

   247

    0x9000: ('ExifVersion', make_string),

   248

    0x9003: ('DateTimeOriginal', ),

   249

    0x9004: ('DateTimeDigitized', ),

   250

    0x9101: ('ComponentsConfiguration',

   251

             {0: '',

   252

              1: 'Y',

   253

              2: 'Cb',

   254

              3: 'Cr',

   255

              4: 'Red',

   256

              5: 'Green',

   257

              6: 'Blue'}),

   258

    0x9102: ('CompressedBitsPerPixel', ),

   259

    0x9201: ('ShutterSpeedValue', ),

   260

    0x9202: ('ApertureValue', ),

   261

    0x9203: ('BrightnessValue', ),

   262

    0x9204: ('ExposureBiasValue', ),

   263

    0x9205: ('MaxApertureValue', ),

   264

    0x9206: ('SubjectDistance', ),

   265

    0x9207: ('MeteringMode',

   266

             {0: 'Unidentified',

   267

              1: 'Average',

   268

              2: 'CenterWeightedAverage',

   269

              3: 'Spot',

   270

              4: 'MultiSpot',

   271

              5: 'Pattern'}),

   272

    0x9208: ('LightSource',

   273

             {0: 'Unknown',

   274

              1: 'Daylight',

   275

              2: 'Fluorescent',

   276

              3: 'Tungsten',

   277

              9: 'Fine Weather',

   278

              10: 'Flash',

   279

              11: 'Shade',

   280

              12: 'Daylight Fluorescent',

   281

              13: 'Day White Fluorescent',

   282

              14: 'Cool White Fluorescent',

   283

              15: 'White Fluorescent',

   284

              17: 'Standard Light A',

   285

              18: 'Standard Light B',

   286

              19: 'Standard Light C',

   287

              20: 'D55',

   288

              21: 'D65',

   289

              22: 'D75',

   290

              255: 'Other'}),

   291

    0x9209: ('Flash',

   292

             {0: 'No',

   293

              1: 'Fired',

   294

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

   295

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

   296

              9: 'Fill Fired',

   297

              13: 'Fill Fired (?)',

   298

              15: 'Fill Fired (!)',

   299

              16: 'Off',

   300

              24: 'Auto Off',

   301

              25: 'Auto Fired',

   302

              29: 'Auto Fired (?)',

   303

              31: 'Auto Fired (!)',

   304

              32: 'Not Available'}),

   305

    0x920A: ('FocalLength', ),

   306

    0x9214: ('SubjectArea', ),

   307

    0x927C: ('MakerNote', ),

   308

    0x9286: ('UserComment', make_string_uc),

   309

    0x9290: ('SubSecTime', ),

   310

    0x9291: ('SubSecTimeOriginal', ),

   311

    0x9292: ('SubSecTimeDigitized', ),

   312

   313

    # used by Windows Explorer

   314

    0x9C9B: ('XPTitle', ),

   315

    0x9C9C: ('XPComment', ),

   316

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

   317

    0x9C9E: ('XPKeywords', ),

   318

    0x9C9F: ('XPSubject', ),

   319

   320

    0xA000: ('FlashPixVersion', make_string),

   321

    0xA001: ('ColorSpace',

   322

             {1: 'sRGB',

   323

              2: 'Adobe RGB',

   324

              65535: 'Uncalibrated'}),

   325

    0xA002: ('ExifImageWidth', ),

   326

    0xA003: ('ExifImageLength', ),

   327

    0xA005: ('InteroperabilityOffset', ),

   328

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

   329

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

   330

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

   331

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

   332

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

   333

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

   334

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

   335

    0xA217: ('SensingMethod',                # 0x9217

   336

             {1: 'Not defined',

   337

              2: 'One-chip color area',

   338

              3: 'Two-chip color area',

   339

              4: 'Three-chip color area',

   340

              5: 'Color sequential area',

   341

              7: 'Trilinear',

   342

              8: 'Color sequential linear'}),             

   343

    0xA300: ('FileSource',

   344

             {1: 'Film Scanner',

   345

              2: 'Reflection Print Scanner',

   346

              3: 'Digital Camera'}),

   347

    0xA301: ('SceneType',

   348

             {1: 'Directly Photographed'}),

   349

    0xA302: ('CVAPattern', ),

   350

    0xA401: ('CustomRendered',

   351

             {0: 'Normal',

   352

              1: 'Custom'}),

   353

    0xA402: ('ExposureMode',

   354

             {0: 'Auto Exposure',

   355

              1: 'Manual Exposure',

   356

              2: 'Auto Bracket'}),

   357

    0xA403: ('WhiteBalance',

   358

             {0: 'Auto',

   359

              1: 'Manual'}),

   360

    0xA404: ('DigitalZoomRatio', ),

   361

    0xA405: ('FocalLengthIn35mmFilm', ),

   362

    0xA406: ('SceneCaptureType',

   363

             {0: 'Standard',

   364

              1: 'Landscape',

   365

              2: 'Portrait',

   366

              3: 'Night)'}),

   367

    0xA407: ('GainControl',

   368

             {0: 'None',

   369

              1: 'Low gain up',

   370

              2: 'High gain up',

   371

              3: 'Low gain down',

   372

              4: 'High gain down'}),

   373

    0xA408: ('Contrast',

   374

             {0: 'Normal',

   375

              1: 'Soft',

   376

              2: 'Hard'}),

   377

    0xA409: ('Saturation',

   378

             {0: 'Normal',

   379

              1: 'Soft',

   380

              2: 'Hard'}),

   381

    0xA40A: ('Sharpness',

   382

             {0: 'Normal',

   383

              1: 'Soft',

   384

              2: 'Hard'}),

   385

    0xA40B: ('DeviceSettingDescription', ),

   386

    0xA40C: ('SubjectDistanceRange', ),

   387

    0xA500: ('Gamma', ),

   388

    0xC4A5: ('PrintIM', ),

   389

    0xEA1C:	('Padding', ),

   390

    }

   391

   392

# interoperability tags

   393

INTR_TAGS = {

   394

    0x0001: ('InteroperabilityIndex', ),

   395

    0x0002: ('InteroperabilityVersion', ),

   396

    0x1000: ('RelatedImageFileFormat', ),

   397

    0x1001: ('RelatedImageWidth', ),

   398

    0x1002: ('RelatedImageLength', ),

   399

    }

   400

   401

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

   402

GPS_TAGS = {

   403

    0x0000: ('GPSVersionID', ),

   404

    0x0001: ('GPSLatitudeRef', ),

   405

    0x0002: ('GPSLatitude', ),

   406

    0x0003: ('GPSLongitudeRef', ),

   407

    0x0004: ('GPSLongitude', ),

   408

    0x0005: ('GPSAltitudeRef', ),

   409

    0x0006: ('GPSAltitude', ),

   410

    0x0007: ('GPSTimeStamp', ),

   411

    0x0008: ('GPSSatellites', ),

   412

    0x0009: ('GPSStatus', ),

   413

    0x000A: ('GPSMeasureMode', ),

   414

    0x000B: ('GPSDOP', ),

   415

    0x000C: ('GPSSpeedRef', ),

   416

    0x000D: ('GPSSpeed', ),

   417

    0x000E: ('GPSTrackRef', ),

   418

    0x000F: ('GPSTrack', ),

   419

    0x0010: ('GPSImgDirectionRef', ),

   420

    0x0011: ('GPSImgDirection', ),

   421

    0x0012: ('GPSMapDatum', ),

   422

    0x0013: ('GPSDestLatitudeRef', ),

   423

    0x0014: ('GPSDestLatitude', ),

   424

    0x0015: ('GPSDestLongitudeRef', ),

   425

    0x0016: ('GPSDestLongitude', ),

   426

    0x0017: ('GPSDestBearingRef', ),

   427

    0x0018: ('GPSDestBearing', ),

   428

    0x0019: ('GPSDestDistanceRef', ),

   429

    0x001A: ('GPSDestDistance', ),

   430

    0x001D: ('GPSDate', ),

   431

    }

   432

   433

# Ignore these tags when quick processing

   434

# 0x927C is MakerNote Tags

   435

# 0x9286 is user comment

   436

IGNORE_TAGS=(0x9286, 0x927C)

   437

   438

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

   439

def nikon_ev_bias(seq):

   440

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

   441

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

   442

    # but it is 12 for the ExposureDifference.

   443

    #

   444

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

   445

    # This only happens if something has gone really wrong in

   446

    # reading the Nikon MakerNote.

   447

    if len( seq ) < 4 : return ""

   448

    #

   449

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

   450

        return "-2/3 EV"

   451

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

   452

        return "-1/2 EV"

   453

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

   454

        return "-1/3 EV"

   455

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

   456

        return "0 EV"

   457

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

   458

        return "+1/3 EV"

   459

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

   460

        return "+1/2 EV"

   461

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

   462

        return "+2/3 EV"

   463

    # Handle combinations not in the table.

   464

    a = seq[0]

   465

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

   466

    if a == 0:

   467

        return "0 EV"

   468

    if a > 127:

   469

        a = 256 - a

   470

        ret_str = "-"

   471

    else:

   472

        ret_str = "+"

   473

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

   474

    whole = a / b

   475

    a = a % b

   476

    if whole != 0:

   477

        ret_str = ret_str + str(whole) + " "

   478

    if a == 0:

   479

        ret_str = ret_str + "EV"

   480

    else:

   481

        r = Ratio(a, b)

   482

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

   483

    return ret_str

   484

   485

# Nikon E99x MakerNote Tags

   486

MAKERNOTE_NIKON_NEWER_TAGS={

   487

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

   488

    0x0002: ('ISOSetting', make_string),

   489

    0x0003: ('ColorMode', ),

   490

    0x0004: ('Quality', ),

   491

    0x0005: ('Whitebalance', ),

   492

    0x0006: ('ImageSharpening', ),

   493

    0x0007: ('FocusMode', ),

   494

    0x0008: ('FlashSetting', ),

   495

    0x0009: ('AutoFlashMode', ),

   496

    0x000B: ('WhiteBalanceBias', ),

   497

    0x000C: ('WhiteBalanceRBCoeff', ),

   498

    0x000D: ('ProgramShift', nikon_ev_bias),

   499

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

   500

    0x000E: ('ExposureDifference', nikon_ev_bias),

   501

    0x000F: ('ISOSelection', ),

   502

    0x0011: ('NikonPreview', ),

   503

    0x0012: ('FlashCompensation', nikon_ev_bias),

   504

    0x0013: ('ISOSpeedRequested', ),

   505

    0x0016: ('PhotoCornerCoordinates', ),

   506

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

   507

    0x0018: ('FlashBracketCompensationApplied', nikon_ev_bias),

   508

    0x0019: ('AEBracketCompensationApplied', ),

   509

    0x001A: ('ImageProcessing', ),

   510

    0x001B: ('CropHiSpeed', ),

   511

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

   512

    0x001E: ('ColorSpace', ),

   513

    0x001F: ('VRInfo', ),

   514

    0x0020: ('ImageAuthentication', ),

   515

    0x0022: ('ActiveDLighting', ),

   516

    0x0023: ('PictureControl', ),

   517

    0x0024: ('WorldTime', ),

   518

    0x0025: ('ISOInfo', ),

   519

    0x0080: ('ImageAdjustment', ),

   520

    0x0081: ('ToneCompensation', ),

   521

    0x0082: ('AuxiliaryLens', ),

   522

    0x0083: ('LensType', ),

   523

    0x0084: ('LensMinMaxFocalMaxAperture', ),

   524

    0x0085: ('ManualFocusDistance', ),

   525

    0x0086: ('DigitalZoomFactor', ),