L_LTFIL_API L_INT L_GetTag(uTag, pType, pCount, pData)
Gets the data that is ready to be saved as tagged data in a TIFF file. This lets you see the data that was specified with the L_SetTag function.
Tag to identify the data in the TIFF file. Use the same tag that you specified in the L_SetTag function.
Address of the variable to be updated with the tagged data type. The following are possible values:
|TAG_ASCII|| Byte in the range of 0 to 255.|
|TAG_SBYTE|| Byte used as signed number in the range of -128 to +127.|
|TAG_UNDEFINED|| Byte, with application-defined usage.|
|TAG_SHORT|| Two bytes, unsigned.|
|TAG_SSHORT|| Two bytes, signed.|
|TAG_LONG|| Four bytes, unsigned.|
|TAG_SLONG|| Four bytes, signed.|
|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_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|| 32-bit IFD offset.|
|TAG_LONG8|| Unsigned 64-bit integer (valid only for BigTIFF formats).|
|TAG_SLONG8|| Signed 64-bit integer (valid only for BigTIFF formats).|
|TAG_IFD8|| 64-bit IFD offset (valid only for BigTIFF formats).|
Address of the variable to be updated with the count of data items. The count is based on the tagged data type. For example, if the count is 2 and the data type is TAG_DOUBLE, the required buffer size is 16.
Pointer to the buffer to be updated with the data. You can pass NULL if you want to use this function's return value to determine the required buffer size.
|>0||Length of the tagged data, in bytes.|
|<= 0||An error occurred. Refer to Return Codes.|
It is often convenient to call this function twice, as follows:
pDataparameter, and using the return value to determine the required size of the buffer.
For general information about TIFF tags, refer to Implementing TIFF Comments and Tags.
To detect whether a file has annotation information, you should call L_GetTag and see if ANNTAG_TYPE is present.
Required DLLs and Libraries
Win32, x64, Linux.
For an example, refer to L_SetTag.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries