Imported Debian version 2.5.3~trusty1
[deb_ffmpeg.git] / ffmpeg / libavcodec / exif.h
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(AVCodecContext *avctx, GetByteContext *gbytes, int le,
168 int depth, AVDictionary **metadata);
169
170 #endif /* AVCODEC_EXIF_H */