]> git.sesse.net Git - ffmpeg/blob - libavcodec/exif.h
Merge remote-tracking branch 'qatar/master'
[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 ff_exif_decode_ifd(AVCodecContext *avctx, GetByteContext *gbytes, int le,
168                        int depth, AVDictionary **metadata);
169
170 #endif /* AVCODEC_EXIF_H */