app: s/sprintf/g_snprintf/ in xcf_save_image()
[gimp.git] / devel-docs / exif-handling.txt
blobe196752ee80d0958ec0b0f84ec425f3c5aa34d3c
1              How GIMP should handle EXIF data
3                      Bill Skaggs 1/2/05
5 This is a summary of how an image editing program is supposed to
6 handle each of the EXIF fields, according to the EXIF specs.  Note
7 that this expresses my understanding based on a quick reading, and
8 should not be taken as gospel.  For details on the contents of each of
9 these fields, consult the formal EXIF specifications, available from
10 http://www.exif.org/specifications.html.
12 (Note: according to the EXIF specs, an EXIF jpeg file must have a name
13 that is ASCII, in 8.3 format, with extension .JPG, but of course we
14 are not going to enforce this.)
18 Fields that should be used to set up the GIMP image when an EXIF file
19 is loaded, either by using them to configure the image (e.g.,
20 orientation), or by placing them in parasites that can be accessed by
21 non-exif-aware functions.  
23 Orientation 
24 XResolution 
25 YResolution 
26 ResolutionUnit
27 ImageDescription 
28 Artist 
29 Copyright 
30 Colorspace
31 ComponentsConfiguration 
32 UserComment 
33 SubjectArea 
34 SubjectLocation
35 ImageUniqueID 
36 PixelXDimension 
37 PixelYDimension 
41 Fields that should be modified by GIMP when an EXIF jpeg file is
42 saved.  A letter "M" indicates fields whose presence is mandatory
43 according to the spec. 
45 Orientation 
46 XResolution (M) 
47 YResolution (M) 
48 ResolutionUnit (M) 
49 Software 
50 DateTime 
51 ImageDescription 
52 Artist 
53 Colorspace (M)
54 PixelXDimension (M) 
55 PixelYDimension (M) 
56 ComponentsConfiguration (M)
57 UserComment 
58 SubsecTime 
59 SubjectArea 
60 SubjectLocation 
61 FileSource
62 ImageUniqueID 
63 thumbnail Compression (M) 
64 thumbnail XResolution (M)
65 thumbnail YResolution (M) 
66 thumbnail JPEGInterchangeFormat (M)
67 thumbnail JPEGInterchangeFormatLength (M)  
71 Fields that should be used and saved related to color management:
73 TransferFunction 
74 WhitePoint 
75 PrimaryChromaticity 
76 YCbCrCoefficients
77 ReferenceBlackWhite
81 Fields that should be deleted if they exist when saving a file as
82 jpeg, because they only apply to uncompressed (TIFF) data.  This
83 applies both to the main image and to the thumbnail, if there is one. 
85 ImageWidth 
86 ImageLength 
87 BitsPerSample
88 Compression 
89 SamplesPerPixel 
90 PhotometricInterpretation 
91 StripOffsets
92 PlanarConfiguration 
93 YCbCrSubSampling
97 Any field not mentioned here should be passed through unchanged.