Project

General

Profile

The Metadata in TIFF files » History » Version 17

Robin Mills, 13 Nov 2016 09:31

1 16 Robin Mills
h2{color:#628DB6}. The Metadata in TIFF files
2 1 Robin Mills
3 16 Robin Mills
p{margin-left:60px;}. The Tagged Image File Format is a container.  It's very flexible and can deal with multiple pages, different colour spaces, different frame configurations as well as metadata.  The specification is available from:  https://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf
4 1 Robin Mills
5 16 Robin Mills
p{margin-left:60px;}. The TIFF container is so flexible it is used as the structure for most RAW formats including Adobe's DNG.  Additionally the TIFF container is used to store the metadata that lies inside the Exif blocks embedded in JPEG and PNG files.
6 14 Robin Mills
7 16 Robin Mills
p{margin-left:60px;}. There is a 64bit version of Tiff called _*BigTiff*_. This is currently not supported by exiv2.
8 14 Robin Mills
9 16 Robin Mills
p{margin-left:60px;}. !Tiff.png!
10 3 Robin Mills
11 16 Robin Mills
p{margin-left:60px;}. The format consists of an 8 byte header which provides a 2 byte endian flag (II or MM), a 2 byte type "magic number" (42) and a 4 byte offset to an _*Image File Directory*_.
12 1 Robin Mills
13 16 Robin Mills
p{margin-left:60px;}. The _*IFD*_ _(Image File Directory)_  has a two byte header which contains the length of the directory followed by 12 byte "fields" or "tags".  The trailing 4 bytes of the directory is the offset to the next directory _*or*_ zero to terminate the directory chain.
14 15 Robin Mills
15 16 Robin Mills
p{margin-left:60px;}. A tag consists of a 12 byte record: TagID, TagType, Count and Offset which are 2,2,4 and 4 bytes respectively.  The TagID defines the purpose of the record (Width, Height, ColorSpace etc) and the TagType defines the data format.  Count and Offset are used to contain the raw data _*or*_ provide an offset in the file at which to read the raw data for this tag.
16 7 Robin Mills
17 16 Robin Mills
h2{color:#628DB6}. Example:
18
19 10 Robin Mills
The version of exiv2(.exe) which ships with v0.25 provides options _*<code>-pS</code>*_ to reveals the structure of the TIFF and option _*<code>-pX</code>*_ is used to extract the raw XMP/xml data.
20
21 17 Robin Mills
The option _*<code>-pa</code>*_ is used to print the metadata in human readable format.<pre>$ exiv2 -pa test/data/test.tiff 
22 10 Robin Mills
Exif.Image.NewSubfileType                    Long        1  Primary image
23
Exif.Image.ImageWidth                        Short       1  282
24
Exif.Image.ImageLength                       Short       1  212
25 1 Robin Mills
Exif.Image.BitsPerSample                     Short       3  8 8 8
26
Exif.Image.Compression                       Short       1  LZW
27
Exif.Image.PhotometricInterpretation         Short       1  RGB
28 10 Robin Mills
Exif.Image.ImageDescription                  Ascii      32                                 
29
Exif.Image.Make                              Ascii       5  SONY
30
Exif.Image.Model                             Ascii       9  DSC-S600
31
Exif.Image.StripOffsets                      Long       16  4372 ...
32
Exif.Image.Orientation                       Short       1  top, left
33 1 Robin Mills
Exif.Image.SamplesPerPixel                   Short       1  3
34 10 Robin Mills
Exif.Image.RowsPerStrip                      Long        1  14
35
Exif.Image.StripByteCounts                   Long       16  10492 ...
36
Exif.Image.XResolution                       Rational    1  96
37
Exif.Image.YResolution                       Rational    1  96
38 1 Robin Mills
Exif.Image.PlanarConfiguration               Short       1  1
39 10 Robin Mills
Exif.Image.ResolutionUnit                    Short       1  inch
40
Exif.Image.DateTime                          Ascii      20  2009:04:26 12:38:18
41
Exif.Image.Predictor                         Short       1  No prediction scheme used
42 1 Robin Mills
Exif.Image.SampleFormat                      Short       3  Unsigned integer data
43 10 Robin Mills
Exif.Image.XMLPacket                         Byte      2505  (Binary value suppressed)
44
Exif.Image.InterColorProfile                 Undefined 1352  (Binary value suppressed)
45
Xmp.dc.title                                 LangAlt     1  lang="x-default" this is a test image
46 11 Robin Mills
$ exiv2 -pS test/data/test.tiff
47 10 Robin Mills
STRUCTURE OF TIFF FILE (II): test/data/test.tiff
48
 address |    tag                           |      type |    count |    offset | value
49
      10 | 0x00fe NewSubfileType            |      LONG |        1 |         0 | 0
50
      22 | 0x0100 ImageWidth                |     SHORT |        1 |       282 | 282
51
      34 | 0x0101 ImageLength               |     SHORT |        1 |       212 | 212
52
      46 | 0x0102 BitsPerSample             |     SHORT |        3 |       290 | 8 8 8
53
      58 | 0x0103 Compression               |     SHORT |        1 |         5 | 5
54
      70 | 0x0106 PhotometricInterpretation |     SHORT |        1 |         2 | 2
55
      82 | 0x010e ImageDescription          |     ASCII |       32 |       296 |                                
56
      94 | 0x010f Make                      |     ASCII |        5 |       328 | SONY
57
     106 | 0x0110 Model                     |     ASCII |        9 |       334 | DSC-S600
58
     118 | 0x0111 StripOffsets              |      LONG |       16 |       344 | 4372 14864 25634 37110 50496 ...
59
     130 | 0x0112 Orientation               |     SHORT |        1 |         1 | 1
60
     142 | 0x0115 SamplesPerPixel           |     SHORT |        1 |         3 | 3
61
     154 | 0x0116 RowsPerStrip              |      LONG |        1 |        14 | 14
62
     166 | 0x0117 StripByteCounts           |      LONG |       16 |       408 | 10492 10770 11476 13385 13348 ...
63
     178 | 0x011a XResolution               |  RATIONAL |        1 |       472 | 96/1
64
     190 | 0x011b YResolution               |  RATIONAL |        1 |       480 | 96/1
65
     202 | 0x011c PlanarConfiguration       |     SHORT |        1 |         1 | 1
66
     214 | 0x0128 ResolutionUnit            |     SHORT |        1 |         2 | 2
67
     226 | 0x0132 DateTime                  |     ASCII |       20 |       488 | 2009:04:26 12:38:18
68
     238 | 0x013d Predictor                 |     SHORT |        1 |         1 | 1
69
     250 | 0x0153 SampleFormat              |     SHORT |        3 |       508 | 1 1 1
70
     262 | 0x02bc XMLPacket                 |      BYTE |     2505 |       514 | <?xpacket begin="..." id="W5M0Mp ...
71
     274 | 0x8773 InterColorProfile         | UNDEFINED |     1352 |      3020 | ...Happl. ..scnrRGB XYZ ....... ...
72
END test/data/test.tiff
73
$ exiv2 -pX test/data/test.tiff  | xmllint --format -
74 1 Robin Mills
<?xml version="1.0"?>
75
<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
76
<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="XMP Core 4.4.0-Exiv2">
77
  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
78
    <rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about="">
79
      <dc:title>
80
        <rdf:Alt>
81 10 Robin Mills
          <rdf:li xml:lang="x-default">this is a test image</rdf:li>
82 1 Robin Mills
        </rdf:Alt>
83
      </dc:title>
84
    </rdf:Description>
85
  </rdf:RDF>
86
</x:xmpmeta>
87
<?xpacket end="w"?>
88 16 Robin Mills
$ </pre>
89
90
You can use the output from _*<code>-pS</code>*_ to determine the location of the XMLPacket:<pre>$ exiv2 -pS test/data/test.tiff | grep XMLPacket 
91 10 Robin Mills
     262 | 0x02bc XMLPacket                 |      BYTE |     2505 |       514 | <?xpacket begin="..." id="W5M0Mp ...
92 16 Robin Mills
$ </pre>You can see the XMLPacket of 2505 bytes stored at offset 514.   You can extract the XMP with the following command which says:  set the block size to 1 byte, skip 514 bytes and extract 2505 bytes:<pre>$ dd bs=1 count=2505 skip=514 if=test/data/test.tiff | xmllint --format - 
93 10 Robin Mills
2505+0 records in
94
2505+0 records out
95 1 Robin Mills
2505 bytes (2.5 kB) copied, 0.0064 s, 391 kB/s
96
<?xml version="1.0"?>
97
<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
98 4 Robin Mills
<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="XMP Core 4.4.0-Exiv2">
99 1 Robin Mills
  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
100
    <rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about="">
101 2 Robin Mills
      <dc:title>
102
        <rdf:Alt>
103
          <rdf:li xml:lang="x-default">this is a test image</rdf:li>
104 10 Robin Mills
        </rdf:Alt>
105 2 Robin Mills
      </dc:title>
106
    </rdf:Description>
107
  </rdf:RDF>
108
</x:xmpmeta>
109
<?xpacket end="w"?>
110 16 Robin Mills
</pre>
111 13 Robin Mills
112 16 Robin Mills
The option _*<code>-pX</code>*_ doesn't use dd to achieve the same result and is much more convenient to use.
113
114 2 Robin Mills
To demonstrate that the metadata block in a JPEG is a TIFF file, extract and print the structure.<pre>$ exiv2 -pS test/data/Reagan.jpg 
115 1 Robin Mills
$ exiv2 -pS test/data/Reagan.jpg
116
STRUCTURE OF JPEG FILE: test/data/Reagan.jpg
117
 address | marker       |  length | data
118 2 Robin Mills
       0 | 0xffd8 SOI  
119
       2 | 0xffe1 APP1  |    5718 | Exif..MM.*......................
120
    5722 | 0xffed APP13 |    3038 | Photoshop 3.0.8BIM..........Z...
121 10 Robin Mills
    8762 | 0xffe1 APP1  |    5329 | http://ns.adobe.com/xap/1.0/.<?x
122
   14093 | 0xffe2 APP2  |     576 | ICC_PROFILE......0ADBE....mntrRG chunk 1/1
123
   14671 | 0xffee APP14 |      14 | Adobe.d@......
124
   14687 | 0xffdb DQT   |     132 
125
   14821 | 0xffc0 SOF0  |      17 
126
   14840 | 0xffdd DRI   |       4 
127
   14846 | 0xffc4 DHT   |     418 
128
   15266 | 0xffda SOS  
129 16 Robin Mills
$ </pre>
130
131
We can extract the APP1/Exif data as follows:<pre>$ dd bs=1 skip=$((2+2+8)) count=$((5718-8)) if=test/data/Reagan.jpg of=ReaganExif.tiff
132 10 Robin Mills
5710+0 records in
133
5710+0 records out
134
5710 bytes (5.7 kB) copied, 0.026688 s, 214 kB/s
135
$ exiv2 -pS ReaganExif.tif 
136
STRUCTURE OF TIFF FILE (MM): ReaganExif.tif
137
 address |    tag                           |      type |    count |    offset | value
138
      10 | 0x0100 ImageWidth                |     SHORT |        1 |  13107200 | 200
139
      22 | 0x0101 ImageLength               |     SHORT |        1 |   8519680 | 130
140
      34 | 0x0102 BitsPerSample             |     SHORT |        4 |       242 | 8 8 8 8
141
      46 | 0x0103 Compression               |     SHORT |        1 |     65536 | 1
142
      58 | 0x0106 PhotometricInterpretation |     SHORT |        1 |    131072 | 2
143
      70 | 0x010e ImageDescription          |     ASCII |      403 |       250 | 040621-N-6536T-062.USS Ronald Re ...
144
      82 | 0x010f Make                      |     ASCII |       18 |       653 | NIKON CORPORATION
145
      94 | 0x0110 Model                     |     ASCII |       10 |       671 | NIKON D1X
146
     106 | 0x0112 Orientation               |     SHORT |        1 |     65536 | 1
147
     118 | 0x0115 SamplesPerPixel           |     SHORT |        1 |    262144 | 4
148
     130 | 0x011a XResolution               |  RATIONAL |        1 |       681 | 3000000/10000
149 1 Robin Mills
     142 | 0x011b YResolution               |  RATIONAL |        1 |       689 | 3000000/10000
150
     154 | 0x011c PlanarConfiguration       |     SHORT |        1 |     65536 | 1
151
     166 | 0x0128 ResolutionUnit            |     SHORT |        1 |    131072 | 2
152 10 Robin Mills
     178 | 0x0131 Software                  |     ASCII |       40 |       697 | Adobe Photoshop Elements 12.0 Ma ...
153
     190 | 0x0132 DateTime                  |     ASCII |       20 |       737 | 2016:09:13 11:58:16
154
     202 | 0x013b Artist                    |     ASCII |       34 |       757 | Photographer..s Mate 3rd Class ( ...
155
     214 | 0x8769 ExifTag                   |      LONG |        1 |       792 | 792
156
     226 | 0x8825 GPSTag                    |      LONG |        1 |      1400 | 1400
157
    1422 | 0x0103 Compression               |     SHORT |        1 |    393216 | 6
158
    1434 | 0x011a XResolution               |  RATIONAL |        1 |      1498 | 72/1
159
    1446 | 0x011b YResolution               |  RATIONAL |        1 |      1506 | 72/1
160
    1458 | 0x0128 ResolutionUnit            |     SHORT |        1 |    131072 | 2
161
    1470 | 0x0201 JPEGInterchangeFormat     |      LONG |        1 |      1514 | 1514
162
    1482 | 0x0202 JPEGInterchangeFormatLeng |      LONG |        1 |      4196 | 4196
163
END ReaganExif.tif
164 16 Robin Mills
$ </pre>
165
166
The version of the exiv2 utility that ships with v0.26 later has an option _*<code>-pR</code>*_ which _Recursively_ prints the structure of an image file.  *_Recursively*_ means  the utility prints structures embedded within other structures.  For example, the Exif metadata in a JPEG is encoded as a TIFF embedded in the APP1/Exif segment of the JPEG.<pre>$ exiv2 -pR test/data/Reagan.jpg 
167 10 Robin Mills
STRUCTURE OF JPEG FILE: test/data/Reagan.jpg
168
 address | marker       |  length | data
169
       0 | 0xffd8 SOI  
170 4 Robin Mills
       2 | 0xffe1 APP1  |    5718 | Exif..MM.*......................
171
  STRUCTURE OF TIFF FILE (MM): MemIo
172
   address |    tag                           |      type |    count |    offset | value
173
        10 | 0x0100 ImageWidth                |     SHORT |        1 |  13107200 | 200
174
        22 | 0x0101 ImageLength               |     SHORT |        1 |   8519680 | 130
175
        34 | 0x0102 BitsPerSample             |     SHORT |        4 |       242 | 8 8 8 8
176
        46 | 0x0103 Compression               |     SHORT |        1 |     65536 | 1
177
        58 | 0x0106 PhotometricInterpretation |     SHORT |        1 |    131072 | 2
178
        70 | 0x010e ImageDescription          |     ASCII |      403 |       250 | 040621-N-6536T-062.USS Ronald Re ...
179
        82 | 0x010f Make                      |     ASCII |       18 |       653 | NIKON CORPORATION
180
        94 | 0x0110 Model                     |     ASCII |       10 |       671 | NIKON D1X
181
       106 | 0x0112 Orientation               |     SHORT |        1 |     65536 | 1
182
       118 | 0x0115 SamplesPerPixel           |     SHORT |        1 |    262144 | 4
183
       130 | 0x011a XResolution               |  RATIONAL |        1 |       681 | 681/0
184
       142 | 0x011b YResolution               |  RATIONAL |        1 |       689 | 689/0
185
       154 | 0x011c PlanarConfiguration       |     SHORT |        1 |     65536 | 1
186
       166 | 0x0128 ResolutionUnit            |     SHORT |        1 |    131072 | 2
187
       178 | 0x0131 Software                  |     ASCII |       40 |       697 | Adobe Photoshop Elements 12.0 Ma ...
188
       190 | 0x0132 DateTime                  |     ASCII |       20 |       737 | 2016:09:13 11:58:16
189
       202 | 0x013b Artist                    |     ASCII |       34 |       757 | Photographer..s Mate 3rd Class ( ...
190
       214 | 0x8769 ExifTag                   |      LONG |        1 |       792 | 792
191
    STRUCTURE OF TIFF FILE (MM): MemIo
192
     address |    tag                           |      type |    count |    offset | value
193
         794 | 0x829a ExposureTime              |  RATIONAL |        1 |      1254 | 1254/0
194
         806 | 0x829d FNumber                   |  RATIONAL |        1 |      1262 | 1262/0
195
         818 | 0x8822 ExposureProgram           |     SHORT |        1 |     65536 | 1
196
         830 | 0x9000 ExifVersion               | UNDEFINED |        4 | 808596016 | 0220
197
         842 | 0x9003 DateTimeOriginal          |     ASCII |       20 |      1270 | 2004:06:21 23:37:53
198
         854 | 0x9004 DateTimeDigitized         |     ASCII |       20 |      1290 | 2004:06:21 23:37:53
199
         866 | 0x9101 ComponentsConfiguration   | UNDEFINED |        4 |  16909056 | ...
200
         878 | 0x9102 CompressedBitsPerPixel    |  RATIONAL |        1 |      1310 | 1310/0
201
         890 | 0x9201 ShutterSpeedValue         | SRATIONAL |        1 |      1318 | 1318/0
202
         902 | 0x9202 ApertureValue             |  RATIONAL |        1 |      1326 | 1326/0
203
         914 | 0x9204 ExposureBiasValue         | SRATIONAL |        1 |      1334 | 1334/0
204
         926 | 0x9205 MaxApertureValue          |  RATIONAL |        1 |      1342 | 1342/0
205
         938 | 0x9207 MeteringMode              |     SHORT |        1 |    131072 | 2
206 1 Robin Mills
         950 | 0x9208 LightSource               |     SHORT |        1 |    655360 | 10
207 4 Robin Mills
         962 | 0x9209 Flash                     |     SHORT |        1 |         0 | 0
208
         974 | 0x920a FocalLength               |  RATIONAL |        1 |      1350 | 1350/0
209
         986 | 0x9290 SubSecTime                |     ASCII |        3 | 808845312 | 06
210
         998 | 0x9291 SubSecTimeOriginal        |     ASCII |        3 | 808845312 | 06
211
        1010 | 0x9292 SubSecTimeDigitized       |     ASCII |        3 | 808845312 | 06
212
        1022 | 0xa000 FlashpixVersion           | UNDEFINED |        4 | 808529968 | 0100
213
        1034 | 0xa001 ColorSpace                |     SHORT |        1 |4294901760 | 65535
214
        1046 | 0xa002 PixelXDimension           |      LONG |        1 |       200 | 200
215
        1058 | 0xa003 PixelYDimension           |      LONG |        1 |       130 | 130
216
        1070 | 0xa217 SensingMethod             |     SHORT |        1 |    131072 | 2
217
        1082 | 0xa300 FileSource                | UNDEFINED |        1 |  50331648 | .
218
        1094 | 0xa301 SceneType                 | UNDEFINED |        1 |  16777216 | .
219
        1106 | 0xa401 CustomRendered            |     SHORT |        1 |         0 | 0
220
        1118 | 0xa402 ExposureMode              |     SHORT |        1 |     65536 | 1
221
        1130 | 0xa403 WhiteBalance              |     SHORT |        1 |     65536 | 1
222
        1142 | 0xa404 DigitalZoomRatio          |  RATIONAL |        1 |      1358 | 1358/0
223
        1154 | 0xa405 FocalLengthIn35mmFilm     |     SHORT |        1 |   4128768 | 63
224
        1166 | 0xa406 SceneCaptureType          |     SHORT |        1 |         0 | 0
225
        1178 | 0xa407 GainControl               |     SHORT |        1 |         0 | 0
226
        1190 | 0xa408 Contrast                  |     SHORT |        1 |         0 | 0
227
        1202 | 0xa409 Saturation                |     SHORT |        1 |         0 | 0
228
        1214 | 0xa40a Sharpness                 |     SHORT |        1 |         0 | 0
229
        1226 | 0xa40c SubjectDistanceRange      |     SHORT |        1 |         0 | 0
230
        1238 | 0xa420 ImageUniqueID             |     ASCII |       33 |      1366 | 127c1377b054a3f65bf2754ebb24e7f2 ...
231
    END MemIo
232
       226 | 0x8825 GPSTag                    |      LONG |        1 |      1400 | 1400
233
      1422 | 0x0103 Compression               |     SHORT |        1 |    393216 | 6
234
      1434 | 0x011a XResolution               |  RATIONAL |        1 |      1498 | 1498/0
235
      1446 | 0x011b YResolution               |  RATIONAL |        1 |      1506 | 1506/0
236
      1458 | 0x0128 ResolutionUnit            |     SHORT |        1 |    131072 | 2
237
      1470 | 0x0201 JPEGInterchangeFormat     |      LONG |        1 |      1514 | 1514
238
      1482 | 0x0202 JPEGInterchangeFormatLeng |      LONG |        1 |      4196 | 4196
239
  END MemIo
240
    5722 | 0xffed APP13 |    3038 | Photoshop 3.0.8BIM..........Z...
241
  Record | DataSet | Name                     | Length | Data
242
       1 |      90 | CharacterSet             |      3 | .%G
243
       1 |      90 | CharacterSet             |      3 | .%G
244
       2 |       0 | RecordVersion            |      2 | ..
245
       2 |     120 | Caption                  |    402 | 040621-N-6536T-062.USS Ronald Reagan (CV...
246
       2 |     122 | Writer                   |      9 | Dir. NVNS
247
       2 |      40 | SpecialInstructions      |     49 | Credit as U.S. Navy photo by Elizabeth T...
248
       2 |      80 | Byline                   |     32 | Photographer..s Mate 3rd Class (
249
       2 |      85 | BylineTitle              |     21 | U.S Navy Photographer
250
       2 |     110 | Credit                   |      8 | U.S Navy
251
       2 |     115 | Source                   |     24 | Navy Visual News Service
252
       2 |       5 | ObjectName               |     18 | 040621-N-6536T-062
253
       2 |      55 | DateCreated              |      8 | 20040621
254
       2 |      60 | TimeCreated              |     11 | 000000+0000
255
       2 |      62 | DigitizationDate         |      8 | 20040621
256
       2 |      63 | DigitizationTime         |     11 | 233753-0400
257
       2 |      90 | City                     |     19 | Straits of Magellan
258
       2 |     101 | CountryName              |     13 | South America
259 1 Robin Mills
       2 |      15 | Category                 |      1 | N
260
       2 |      20 | SuppCategory             |     12 | 703-614-9154
261
       2 |      20 | SuppCategory             |     23 | navyvisualnews@navy.mil
262
       2 |      20 | SuppCategory             |     11 | UNCLASSFIED
263
       2 |      10 | Urgency                  |      1 | 5
264
       2 |      25 | Keywords                 |     13 | ronald reagan
265
       2 |      25 | Keywords                 |      6 | reagan
266
       2 |      25 | Keywords                 |      6 | cvn 76
267
       2 |      25 | Keywords                 |      6 | cvn-76
268
       2 |      25 | Keywords                 |     18 | straights magellan
269
       2 |      25 | Keywords                 |      8 | magellan
270
       2 |      25 | Keywords                 |      7 | carrier
271
       2 |      25 | Keywords                 |     12 | nimitz-class
272
       2 |      25 | Keywords                 |      4 | ship
273
       2 |      25 | Keywords                 |      8 | underway
274
    8762 | 0xffe1 APP1  |    5329 | http://ns.adobe.com/xap/1.0/.<?x
275
   14093 | 0xffe2 APP2  |     576 | ICC_PROFILE......0ADBE....mntrRG chunk 1/1
276
   14671 | 0xffee APP14 |      14 | Adobe.d@......
277
   14687 | 0xffdb DQT   |     132 
278
   14821 | 0xffc0 SOF0  |      17 
279
   14840 | 0xffdd DRI   |       4 
280
   14846 | 0xffc4 DHT   |     418 
281 10 Robin Mills
   15266 | 0xffda SOS  
282 1 Robin Mills
$ </pre>