[deb_ffmpeg.git] / ffmpeg / libavcodec / exif.h

/*
 * EXIF metadata parser
 * Copyright (c) 2013 Thilo Borgmann <thilo.borgmann _at_ mail.de>
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

/**
 * @file
 * EXIF metadata parser
 * @author Thilo Borgmann <thilo.borgmann _at_ mail.de>
 */

#ifndef AVCODEC_EXIF_H
#define AVCODEC_EXIF_H

#include "avcodec.h"
#include "bytestream.h"
#include "tiff.h"

#define EXIF_MAX_IFD_RECURSION 2
#define EXIF_TAG_NAME_LENGTH   32

struct exif_tag {
    char      name[EXIF_TAG_NAME_LENGTH];
    uint16_t  id;
};

static const struct exif_tag tag_list[] = { // JEITA CP-3451 EXIF specification:
    {"GPSVersionID",               0x00}, // <- Table 12 GPS Attribute Information
    {"GPSLatitudeRef",             0x01},
    {"GPSLatitude",                0x02},
    {"GPSLongitudeRef",            0x03},
    {"GPSLongitude",               0x04},
    {"GPSAltitudeRef",             0x05},
    {"GPSAltitude",                0x06},
    {"GPSTimeStamp",               0x07},
    {"GPSSatellites",              0x08},
    {"GPSStatus",                  0x09},
    {"GPSMeasureMode",             0x0A},
    {"GPSDOP",                     0x0B},
    {"GPSSpeedRef",                0x0C},
    {"GPSSpeed",                   0x0D},
    {"GPSTrackRef",                0x0E},
    {"GPSTrack",                   0x0F},
    {"GPSImgDirectionRef",         0x10},
    {"GPSImgDirection",            0x11},
    {"GPSMapDatum",                0x12},
    {"GPSDestLatitudeRef",         0x13},
    {"GPSDestLatitude",            0x14},
    {"GPSDestLongitudeRef",        0x15},
    {"GPSDestLongitude",           0x16},
    {"GPSDestBearingRef",          0x17},
    {"GPSDestBearing",             0x18},
    {"GPSDestDistanceRef",         0x19},
    {"GPSDestDistance",            0x1A},
    {"GPSProcessingMethod",        0x1B},
    {"GPSAreaInformation",         0x1C},
    {"GPSDateStamp",               0x1D},
    {"GPSDifferential",            0x1E},
    {"ImageWidth",                 0x100}, // <- Table 3 TIFF Rev. 6.0 Attribute Information Used in Exif
    {"ImageLength",                0x101},
    {"BitsPerSample",              0x102},
    {"Compression",                0x103},
    {"PhotometricInterpretation",  0x106},
    {"Orientation",                0x112},
    {"SamplesPerPixel",            0x115},
    {"PlanarConfiguration",        0x11C},
    {"YCbCrSubSampling",           0x212},
    {"YCbCrPositioning",           0x213},
    {"XResolution",                0x11A},
    {"YResolution",                0x11B},
    {"ResolutionUnit",             0x128},
    {"StripOffsets",               0x111},
    {"RowsPerStrip",               0x116},
    {"StripByteCounts",            0x117},
    {"JPEGInterchangeFormat",      0x201},
    {"JPEGInterchangeFormatLength",0x202},
    {"TransferFunction",           0x12D},
    {"WhitePoint",                 0x13E},
    {"PrimaryChromaticities",      0x13F},
    {"YCbCrCoefficients",          0x211},
    {"ReferenceBlackWhite",        0x214},
    {"DateTime",                   0x132},
    {"ImageDescription",           0x10E},
    {"Make",                       0x10F},
    {"Model",                      0x110},
    {"Software",                   0x131},
    {"Artist",                     0x13B},
    {"Copyright",                  0x8298},
    {"ExifVersion",                0x9000}, // <- Table 4 Exif IFD Attribute Information (1)
    {"FlashpixVersion",            0xA000},
    {"ColorSpace",                 0xA001},
    {"ComponentsConfiguration",    0x9101},
    {"CompressedBitsPerPixel",     0x9102},
    {"PixelXDimension",            0xA002},
    {"PixelYDimension",            0xA003},
    {"MakerNote",                  0x927C},
    {"UserComment",                0x9286},
    {"RelatedSoundFile",           0xA004},
    {"DateTimeOriginal",           0x9003},
    {"DateTimeDigitized",          0x9004},
    {"SubSecTime",                 0x9290},
    {"SubSecTimeOriginal",         0x9291},
    {"SubSecTimeDigitized",        0x9292},
    {"ImageUniqueID",              0xA420},
    {"ExposureTime",               0x829A}, // <- Table 5 Exif IFD Attribute Information (2)
    {"FNumber",                    0x829D},
    {"ExposureProgram",            0x8822},
    {"SpectralSensitivity",        0x8824},
    {"ISOSpeedRatings",            0x8827},
    {"OECF",                       0x8828},
    {"ShutterSpeedValue",          0x9201},
    {"ApertureValue",              0x9202},
    {"BrightnessValue",            0x9203},
    {"ExposureBiasValue",          0x9204},
    {"MaxApertureValue",           0x9205},
    {"SubjectDistance",            0x9206},
    {"MeteringMode",               0x9207},
    {"LightSource",                0x9208},
    {"Flash",                      0x9209},
    {"FocalLength",                0x920A},
    {"SubjectArea",                0x9214},
    {"FlashEnergy",                0xA20B},
    {"SpatialFrequencyResponse",   0xA20C},
    {"FocalPlaneXResolution",      0xA20E},
    {"FocalPlaneYResolution",      0xA20F},
    {"FocalPlaneResolutionUnit",   0xA210},
    {"SubjectLocation",            0xA214},
    {"ExposureIndex",              0xA215},
    {"SensingMethod",              0xA217},
    {"FileSource",                 0xA300},
    {"SceneType",                  0xA301},
    {"CFAPattern",                 0xA302},
    {"CustomRendered",             0xA401},
    {"ExposureMode",               0xA402},
    {"WhiteBalance",               0xA403},
    {"DigitalZoomRatio",           0xA404},
    {"FocalLengthIn35mmFilm",      0xA405},
    {"SceneCaptureType",           0xA406},
    {"GainControl",                0xA407},
    {"Contrast",                   0xA408},
    {"Saturation",                 0xA409},
    {"Sharpness",                  0xA40A},
    {"DeviceSettingDescription",   0xA40B},
    {"SubjectDistanceRange",       0xA40C}
//    {"InteroperabilityIndex",      0x1}, // <- Table 13 Interoperability IFD Attribute Information
//    {"",                           0x0}
};

/** Recursively decodes all IFD's and
 *  adds included TAGS into the metadata dictionary. */
int avpriv_exif_decode_ifd(AVCodecContext *avctx, GetByteContext *gbytes, int le,
                           int depth, AVDictionary **metadata);

#endif /* AVCODEC_EXIF_H */
Commit	Line	Data
2ba45a60 DM	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 */