Set the value of an ASCII tag.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_tag_set_ascii( HISISDRV hDriver, AT_MODE nTag, LPSTR lpszValue ); |
Arguments:
hDriver | The handle to the driver. |
nTag | Specifies the ASCII tag to set. |
lpszValue | Points to a buffer that contains the string to which to set nTag. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
The IG_ISIS_tag_set_ascii function sets the value of the specified ASCII tag to the specified string.
Use IG_ISIS_tag_set_ascii to set the specified nTag to the ASCII string in lpcBuffer. IG_ISIS_tag_set_ascii automatically sets the tag's length.
Example:
The following example gets the ASCII value of the choice for IG_ISIS_TAG_DITHER whose index value is 2 (the third choice), and then sets this tag to that value:
Copy Code | |
---|---|
IG_ISIS_choice_get_ascii(hDriver, IG_ISIS_TAG_DITHER, 2, caBuffer);IG_ISIS_tag_set_ascii(hDriver, IG_ISIS_TAG_DITHER, caBuffer); |