L_EnumFileTags2 calls this callback for each tag present on the page.
Tag to identify the data in the TIFF file. This may be any tag specified in L_SetTag, or any other tag added by the TIFF filter when saving the file. For example, all TIFF comments would generate a particular TIFF tag.
Tagged data type. Valid values are:
|TAG_BYTE|| Byte in the range of 0 to 255.|
|TAG_ASCII|| Byte in the range of 0 to 127.|
|TAG_SHORT|| Two bytes, unsigned.|
|TAG_LONG|| Four bytes, unsigned.|
|TAG_RATIONAL|| Eight bytes, used as a pair of unsigned long integers, where the first number is the numerator and the second is the denominator of a fraction.|
|TAG_SBYTE|| Byte used as signed number in the range of -128 to +127.|
|TAG_UNDEFINED|| Byte, with application-defined usage.|
|TAG_SSHORT|| Two bytes, signed.|
|TAG_SLONG|| Four bytes, signed.|
|TAG_SRATIONAL|| Eight bytes, used as a pair of signed long integers, where the first number is the numerator and the second is the denominator of a fraction.|
|TAG_FLOAT|| Four bytes used as a floating point number.|
|TAG_DOUBLE|| Eight bytes used as a double-precision floating point number.|
|TAG_IFD|| Four bytes containing a file offset for an IFD (image file descriptor).|
|TAG_LONG8|| (BigTIFF only) Eight bytes used as an unsigned 64-bit integer value.|
|TAG_SLONG8|| (BigTIFF only) Eight bytes used as a signed 64-bit integer value.|
|TAG_IFD8|| (BigTIFF only) Eight bytes containing a file offset for an IFD (image file descriptor).|
Number of elements of type
uType. Note that this is not the same as the number of bytes. For example, if
uCount is 10 and
TAG_LONG, it will need 10 x 4 = 40 bytes to read the tag data.
Pointer to the tag data (only if L_EnumFileTags2 was called with the ENUM_TAGDATA flag). If ENUM_TAGDATA flag was not used, this pointer is NULL.
A void pointer that can be used to access a variable or structure containing data that the callback function needs. This gives a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that is passed in the
pUserData parameter of the L_EnumMarkers function.)
Keep in mind that this is a void pointer, which must be cast to the appropriate data type within the callback function.
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
L_EnumFileTags2 calls this callback for each tag in the page.
DO NOT use the L_DeleteTag function to delete tags from inside an ENUMTAGS2CALLBACK callback function. To this, use ENUMTAGS2CALLBACK to add the tags to a list. Upon returning from L_EnumFileTags2, delete all the tags from the list.
The pData pointer is valid only until this callback returns. To use this data after it is being called, make a copy of this information and store it in the user data.
For an example, refer to L_EnumFileTags2.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries