IPTC Comments - Namespace - Raster, Medical, Document Help

IPTC Comments

The IPTC-NAA comments are standardized by the International Press Telecommunications Council in collaboration with Newspaper Association of America. More information about these comments can be found on IPTC's web site (https://iptc.org/). Many comments have to follow a particular format, so refer to the IPTC documentation to make sure you are writing valid comments.

LEADTOOLS will verify that the size of the comment is within the limits specified by the standard. Comments with invalid length will NOT be written in the file. LEADTOOLS will NOT verify the contents of the data (it will not verify that the numerical comments contain only digits, etc.).

Some of these comments are repeatable (i.e. you can have more than one comment of this type). To write two or more values for a repeatable comment, concatenate the comments using IptcSeparator as the separator. IptcSeparator has an Ascii code of 1 and cannot appear in any comment, so there is not a possibility of confusion about this character being the separator or part of the comment. Do not confuse this with the character '1', whose Ascii code is 49!

When reading a repeatable comment with more than one value, LEADTOOLS will concatenate all the values and use IptcSeparator to separate the values. Therefore, when a comment that might be repeatable is retrieved, it is best to search for the separator.

IptcKeywords is the best example of a comment that is repeatable. If the file has three keywords (keyword1, keyword2 and keyword3), they will be returned as the following string:

"keyword1\001keyword2\001keyword3".

Every IPTC comment is identified by x:y, where x is the Record number and y is the DataSet number. For example,IptcKeywords is identified as 2:15. We will list the corresponding "x:y" identifier for every comment supported in LEADTOOLS, together with the length limits.

All the date comments use the format YYYYMMDD, so July 4, 2001 is "20010704".

All the time comments use the format HHMMSSñHHMM, following the ISO 8601 standard. The part after ñ is the reference to the Universal Time Format. For example, 3PM Eastern USA time is "150000-0500".

Please note that IptcSeparator is not a comment, it is only a define used for the separator!

IptcSeparator '\001' A separator used for repeatable comments.

IPTC comments can be saved inside TIFF and JPEG files.

For more information about file comments, refer to RasterCodecs.ReadComment and RasterCodecs.WriteComment.

Help Version 20.0.2018.8.13
Products | Support | Contact Us | Copyright Notices
© 1991-2018 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Imaging, Medical, and Document