IG_ISIS_tag_set

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:

Name	Type	Description
hDriver	HISISDRV	The handle to the driver.
nTag	AT_MODE	Specifies the ASCII tag to set.
lpszValue	LPSTR	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);