blob: 5f09208b9d7660a7d48ab3185a61b7484ab5c033
1 | /* |
2 | * EXIF metadata parser |
3 | * Copyright (c) 2013 Thilo Borgmann <thilo.borgmann _at_ mail.de> |
4 | * |
5 | * This file is part of FFmpeg. |
6 | * |
7 | * FFmpeg is free software; you can redistribute it and/or |
8 | * modify it under the terms of the GNU Lesser General Public |
9 | * License as published by the Free Software Foundation; either |
10 | * version 2.1 of the License, or (at your option) any later version. |
11 | * |
12 | * FFmpeg is distributed in the hope that it will be useful, |
13 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
15 | * Lesser General Public License for more details. |
16 | * |
17 | * You should have received a copy of the GNU Lesser General Public |
18 | * License along with FFmpeg; if not, write to the Free Software |
19 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
20 | */ |
21 | |
22 | /** |
23 | * @file |
24 | * EXIF metadata parser |
25 | * @author Thilo Borgmann <thilo.borgmann _at_ mail.de> |
26 | */ |
27 | |
28 | #ifndef AVCODEC_EXIF_H |
29 | #define AVCODEC_EXIF_H |
30 | |
31 | #include "avcodec.h" |
32 | #include "bytestream.h" |
33 | #include "tiff.h" |
34 | |
35 | #define EXIF_MAX_IFD_RECURSION 2 |
36 | #define EXIF_TAG_NAME_LENGTH 32 |
37 | |
38 | struct exif_tag { |
39 | char name[EXIF_TAG_NAME_LENGTH]; |
40 | uint16_t id; |
41 | }; |
42 | |
43 | static const struct exif_tag tag_list[] = { // JEITA CP-3451 EXIF specification: |
44 | {"GPSVersionID", 0x00}, // <- Table 12 GPS Attribute Information |
45 | {"GPSLatitudeRef", 0x01}, |
46 | {"GPSLatitude", 0x02}, |
47 | {"GPSLongitudeRef", 0x03}, |
48 | {"GPSLongitude", 0x04}, |
49 | {"GPSAltitudeRef", 0x05}, |
50 | {"GPSAltitude", 0x06}, |
51 | {"GPSTimeStamp", 0x07}, |
52 | {"GPSSatellites", 0x08}, |
53 | {"GPSStatus", 0x09}, |
54 | {"GPSMeasureMode", 0x0A}, |
55 | {"GPSDOP", 0x0B}, |
56 | {"GPSSpeedRef", 0x0C}, |
57 | {"GPSSpeed", 0x0D}, |
58 | {"GPSTrackRef", 0x0E}, |
59 | {"GPSTrack", 0x0F}, |
60 | {"GPSImgDirectionRef", 0x10}, |
61 | {"GPSImgDirection", 0x11}, |
62 | {"GPSMapDatum", 0x12}, |
63 | {"GPSDestLatitudeRef", 0x13}, |
64 | {"GPSDestLatitude", 0x14}, |
65 | {"GPSDestLongitudeRef", 0x15}, |
66 | {"GPSDestLongitude", 0x16}, |
67 | {"GPSDestBearingRef", 0x17}, |
68 | {"GPSDestBearing", 0x18}, |
69 | {"GPSDestDistanceRef", 0x19}, |
70 | {"GPSDestDistance", 0x1A}, |
71 | {"GPSProcessingMethod", 0x1B}, |
72 | {"GPSAreaInformation", 0x1C}, |
73 | {"GPSDateStamp", 0x1D}, |
74 | {"GPSDifferential", 0x1E}, |
75 | {"ImageWidth", 0x100}, // <- Table 3 TIFF Rev. 6.0 Attribute Information Used in Exif |
76 | {"ImageLength", 0x101}, |
77 | {"BitsPerSample", 0x102}, |
78 | {"Compression", 0x103}, |
79 | {"PhotometricInterpretation", 0x106}, |
80 | {"Orientation", 0x112}, |
81 | {"SamplesPerPixel", 0x115}, |
82 | {"PlanarConfiguration", 0x11C}, |
83 | {"YCbCrSubSampling", 0x212}, |
84 | {"YCbCrPositioning", 0x213}, |
85 | {"XResolution", 0x11A}, |
86 | {"YResolution", 0x11B}, |
87 | {"ResolutionUnit", 0x128}, |
88 | {"StripOffsets", 0x111}, |
89 | {"RowsPerStrip", 0x116}, |
90 | {"StripByteCounts", 0x117}, |
91 | {"JPEGInterchangeFormat", 0x201}, |
92 | {"JPEGInterchangeFormatLength",0x202}, |
93 | {"TransferFunction", 0x12D}, |
94 | {"WhitePoint", 0x13E}, |
95 | {"PrimaryChromaticities", 0x13F}, |
96 | {"YCbCrCoefficients", 0x211}, |
97 | {"ReferenceBlackWhite", 0x214}, |
98 | {"DateTime", 0x132}, |
99 | {"ImageDescription", 0x10E}, |
100 | {"Make", 0x10F}, |
101 | {"Model", 0x110}, |
102 | {"Software", 0x131}, |
103 | {"Artist", 0x13B}, |
104 | {"Copyright", 0x8298}, |
105 | {"ExifVersion", 0x9000}, // <- Table 4 Exif IFD Attribute Information (1) |
106 | {"FlashpixVersion", 0xA000}, |
107 | {"ColorSpace", 0xA001}, |
108 | {"ComponentsConfiguration", 0x9101}, |
109 | {"CompressedBitsPerPixel", 0x9102}, |
110 | {"PixelXDimension", 0xA002}, |
111 | {"PixelYDimension", 0xA003}, |
112 | {"MakerNote", 0x927C}, |
113 | {"UserComment", 0x9286}, |
114 | {"RelatedSoundFile", 0xA004}, |
115 | {"DateTimeOriginal", 0x9003}, |
116 | {"DateTimeDigitized", 0x9004}, |
117 | {"SubSecTime", 0x9290}, |
118 | {"SubSecTimeOriginal", 0x9291}, |
119 | {"SubSecTimeDigitized", 0x9292}, |
120 | {"ImageUniqueID", 0xA420}, |
121 | {"ExposureTime", 0x829A}, // <- Table 5 Exif IFD Attribute Information (2) |
122 | {"FNumber", 0x829D}, |
123 | {"ExposureProgram", 0x8822}, |
124 | {"SpectralSensitivity", 0x8824}, |
125 | {"ISOSpeedRatings", 0x8827}, |
126 | {"OECF", 0x8828}, |
127 | {"ShutterSpeedValue", 0x9201}, |
128 | {"ApertureValue", 0x9202}, |
129 | {"BrightnessValue", 0x9203}, |
130 | {"ExposureBiasValue", 0x9204}, |
131 | {"MaxApertureValue", 0x9205}, |
132 | {"SubjectDistance", 0x9206}, |
133 | {"MeteringMode", 0x9207}, |
134 | {"LightSource", 0x9208}, |
135 | {"Flash", 0x9209}, |
136 | {"FocalLength", 0x920A}, |
137 | {"SubjectArea", 0x9214}, |
138 | {"FlashEnergy", 0xA20B}, |
139 | {"SpatialFrequencyResponse", 0xA20C}, |
140 | {"FocalPlaneXResolution", 0xA20E}, |
141 | {"FocalPlaneYResolution", 0xA20F}, |
142 | {"FocalPlaneResolutionUnit", 0xA210}, |
143 | {"SubjectLocation", 0xA214}, |
144 | {"ExposureIndex", 0xA215}, |
145 | {"SensingMethod", 0xA217}, |
146 | {"FileSource", 0xA300}, |
147 | {"SceneType", 0xA301}, |
148 | {"CFAPattern", 0xA302}, |
149 | {"CustomRendered", 0xA401}, |
150 | {"ExposureMode", 0xA402}, |
151 | {"WhiteBalance", 0xA403}, |
152 | {"DigitalZoomRatio", 0xA404}, |
153 | {"FocalLengthIn35mmFilm", 0xA405}, |
154 | {"SceneCaptureType", 0xA406}, |
155 | {"GainControl", 0xA407}, |
156 | {"Contrast", 0xA408}, |
157 | {"Saturation", 0xA409}, |
158 | {"Sharpness", 0xA40A}, |
159 | {"DeviceSettingDescription", 0xA40B}, |
160 | {"SubjectDistanceRange", 0xA40C} |
161 | // {"InteroperabilityIndex", 0x1}, // <- Table 13 Interoperability IFD Attribute Information |
162 | // {"", 0x0} |
163 | }; |
164 | |
165 | /** Recursively decodes all IFD's and |
166 | * adds included TAGS into the metadata dictionary. */ |
167 | int avpriv_exif_decode_ifd(void *logctx, GetByteContext *gbytes, int le, |
168 | int depth, AVDictionary **metadata); |
169 | |
170 | #endif /* AVCODEC_EXIF_H */ |
171 |