International Press and Telecommunications Council Standards (IPTC) have been created for exchanging different type of information.
IPTC is a metadata format rather than a image file format. It can be stored within JPEG and TIFF image files. In TIFF files the IPTC data is stored in TIFF tag with Id = 34377 (see TIFF Non-Image Data Structure for metadata structure of the tag). In JPEG files, the IPTC data is stored in Photoshop Image Resource APP13 marker segment (see JPEG Non-Image Data Structure).
ImageGear IPTC metadata structure is framed in two levels:
- IPTC level containing all IPTC data
- Record level containing value items of a record
IPTC Level
Name |
Id |
Type |
Value Type |
Value |
Value Length |
Ignored on save |
Record level 1 |
<Record#> |
Tree |
|
|
|
|
... |
|
|
|
|
|
|
Record level n |
<Record#> |
Tree |
|
|
|
|
The <Record#> tag is the primary identifier of IPTC record. Its value is the number of appropriate IPTC record described in IPTC - NAA IIM4 specification. Record levels must follow in numerical order within IPTC level.
Record Level
Name |
Id |
Type |
Value Type |
Value |
Value Length |
Ignored on save |
Dataset value item |
|
Leaf |
|
|
|
FALSE |
... |
|
|
|
|
|
|
Dataset value item |
|
Leaf |
|
|
|
FALSE |
The available , , - , and values are described below for each IPTC record according to IPTC-NAA IIM4 specification. Dataset value item can follow in any order within appropriate record level.
In the tables below, the last column lists the maximum item count for non-string types, and string length for string types. Item count for string types in IPTC metadata is always 1.
Dataset Value Items Description for IPTC Envelope Record (Record #1)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
0 |
"ModelVersion" |
UINT16 |
1 |
5 |
"Destination" |
STRING |
1024 |
20 |
"FileFormat" |
UINT16 |
1 |
22 |
"FileFormatVersion" |
UINT16 |
1 |
30 |
"ServiceIdentifier" |
STRING |
10 |
40 |
"EnvelopeNumber" |
STRING |
8 |
50 |
"ProductID" |
STRING |
32 |
60 |
"EnvelopePriority" |
STRING |
1 |
70 |
"DateSent" |
STRING |
8 |
80 |
"TimeSent" |
STRING |
11 |
90 |
"CodedCharacterSet" |
STRING |
32 |
100 |
"UNO" |
STRING |
80 |
120 |
"ARMIdentifier" |
UINT16 |
1 |
122 |
"ARMVersion" |
UINT16 |
1 |
Dataset Value Items Description for IPTC Application Record (Record #2)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
0 |
"RecordVersion" |
UINT16 |
1 |
3 |
"ObjectTypeReference" |
STRING |
67 |
4 |
"ObjectAttributeReference" |
STRING |
68 |
5 |
"ObjectName" |
STRING |
64 |
7 |
"EditStatus" |
STRING |
64 |
8 |
"EditorialUpdate" |
STRING |
2 |
10 |
"Urgency" |
STRING |
1 |
12 |
"SubjectReference" |
STRING |
236 |
15 |
"Category" |
STRING |
3 |
20 |
"SupplementalCategory" |
STRING |
32 |
22 |
"FixtureIdentifier" |
STRING |
32 |
25 |
"Keywords" |
STRING |
64 |
26 |
"ContentLocationCode" |
STRING |
3 |
27 |
"ContentLocationName" |
STRING |
64 |
30 |
"ReleaseDate" |
STRING |
8 |
35 |
"ReleaseTime" |
STRING |
11 |
37 |
"ExpirationDate" |
STRING |
8 |
38 |
"ExpirationTime" |
STRING |
11 |
40 |
"SpecialInstructions" |
STRING |
256 |
42 |
"ActionAdvised" |
STRING |
2 |
45 |
"ReferenceService" |
STRING |
10 |
47 |
"ReferenceDate" |
STRING |
8 |
50 |
"ReferenceNumber" |
STRING |
8 |
55 |
"DateCreated" |
STRING |
8 |
60 |
"TimeCreated" |
STRING |
11 |
62 |
"DigitalCreationDate" |
STRING |
8 |
63 |
"DigitalCreationTime" |
STRING |
11 |
65 |
"OriginatingProgram" |
STRING |
32 |
70 |
"ProgramVersion" |
STRING |
10 |
75 |
"ObjectCycle" |
STRING |
1 |
80 |
"By-line" |
STRING |
32 |
85 |
"By-lineTitle" |
STRING |
32 |
90 |
"City" |
STRING |
32 |
92 |
"Sublocation" |
STRING |
32 |
95 |
"Province/State" |
STRING |
32 |
100 |
"Country/ PrimaryLocationCode" |
STRING |
3 |
101 |
"Country/ PrimaryLocationName" |
STRING |
64 |
103 |
"OriginalTransmission Reference" |
STRING |
32 |
105 |
"Headline" |
STRING |
256 |
110 |
"Credit" |
STRING |
32 |
115 |
"Source" |
STRING |
32 |
116 |
"CopyrightNotice" |
STRING |
128 |
118 |
"Contact" |
STRING |
128 |
120 |
"Caption/Abstract" |
STRING |
2000 |
122 |
"Writer/Editor" |
STRING |
32 |
125 |
"RasterizedCaption" |
UINT8 |
7360 |
130 |
"ImageType" |
STRING |
2 |
131 |
"ImageOrientation" |
STRING |
1 |
135 |
"LanguageIdentifier" |
STRING |
3 |
150 |
"AudioType" |
STRING |
2 |
151 |
"AudioSamplingRate" |
STRING |
6 |
152 |
"AudioSamplingResolution" |
STRING |
2 |
153 |
"AudioDuration" |
STRING |
6 |
154 |
"AudioOutcue" |
STRING |
64 |
200 |
"ObjectDataPreview FileFormat" |
UINT16 |
1 |
201 |
"ObjectDataPreview FileFormatVersion" |
UINT16 |
1 |
202 |
"ObjectDataPreviewData" |
UINT8 |
Undefined |
Dataset Value Items Description for IPTC Digital News Photo Parameter Record (Record #3)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
0 |
"RecordVersion" |
UINT16 |
1 |
10 |
"PictureNumber" |
RAW_DATA |
16 |
20 |
"PixelsPerLine" |
UINT16 |
1 |
30 |
"NumberOfLine" |
UINT16 |
1 |
40 |
"PixelSizeInScanningDirection" |
UINT16 |
1 |
50 |
"PixelSizePerpendicularTo ScanningDirection" |
UINT16 |
1 |
55 |
"SupplementType" |
UINT8 |
1 |
60 |
"ColourRepresentation" |
UINT8 |
2 |
64 |
"InterchangeColourSpace" |
UINT8 |
1 |
65 |
"ColourSequence" |
UINT8 |
4 |
66 |
"ICCInputColourProfile" |
RAW_DATA |
Undefined |
70 |
"ColourCalibrationMatrixTable" |
RAW_DATA |
Undefined |
80 |
"LookupTable" |
RAW_DATA |
131072 |
84 |
"NumberOfIndexEntries" |
UINT16 |
1 |
85 |
"ColourPalette" |
RAW_DATA |
Undefined |
86 |
"NumberOfBitsPerSample" |
UINT8 |
1 |
90 |
"SamplingStructure" |
UINT8 |
1 |
100 |
"ScanningDirection" |
UINT8 |
1 |
102 |
"ImageRotation" |
UINT8 |
1 |
110 |
"DataCompressionMethod" |
RAW_DATA |
4 |
120 |
"QuantisationMethod" |
UINT8 |
1 |
125 |
"EndPoints" |
UINT8 |
Undefined |
130 |
"ExcursionTolerance" |
UINT8 |
1 |
135 |
"BitsPerComponent" |
UINT8 |
Undefined |
140 |
"MaximumDensityRange" |
UINT16 |
1 |
145 |
"GammaCompensatedValue" |
UINT16 |
1 |
Dataset Value Items Description for IPTC Pre-Object Descriptor Record (Record #7)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
10 |
"SizeMode" |
UINT8 |
1 |
20 |
"MaxSubfileSize" |
UINT8 or UINT16 or UINT32 |
1 |
90 |
"ObjectDataSizeAnnounced" |
UINT8 or UINT16 or UINT32 |
1 |
95 |
"MaximumObjectDataSize" |
UINT8 or UINT16 or UINT32 |
1 |
Dataset Value Items Description for IPTC Object Record (Record #8)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
10 |
"Subfile" |
RAW_DATA |
Undefined |
Dataset Value Items Description for IPTC Post-Object Descriptor Record (Record #9)
Item Identifier |
Item Name |
Value Type |
Max. Value Length (for String last NULL is not counted) |
10 |
"ConfirmedObjectDataSize" |
UINT8 or UINT16 or UINT32 |
1 |