The PIC2List functions allow the PICTools PIC2List data to be searched, stored and retrieved. PIC2List provides PICTools operations with a way of returning information to an application when the amount of information and the types of information are not known.  It also provides an application with a way of providing this information to PICTools operations.  Ordinarily, the information is not strictly necessary to the PICTools operation.  For example, if an image comment is not returned to the client application, the image can still be decompressed.  Similarly, if the client application doesn't supply an image comment, an image can still be compressed.

A particular item of information, such as a single comment, is stored in a PIC2List packet.  Different types of information are stored in different kinds of PIC2List packets.  See also the PICTools include file pic2file.h for additional information. The PIC2List Functions are implemented in the pic2list.c file with header pic2list.h. These files are included in the PICTools SDK samples\common folder.

The PIC2List functions are in the following groups:

• PIC2List General Functions
• PIC2List Generic Packet Functions
• PIC2List Registration Packet Functions
• PIC2List RawData Packet Functions
• PIC2List TIFF / EXIF Packet Functions
• PIC2List MO:DCA Packet Functions
• PIC2List IOCA Packet Functions
• PIC2List CALS Packet Functions
• PIC2List PNGText Packet Functions
• PIC2List JBIG2 Comment Packet Functions
• PIC2List IPTCDataSet Packet Functions
• PIC2List JPEG2000 Metadata Packets Functions