ImageGear for C and C++ on Windows v19.5 - Updated
IG_ISIS_TAG_DITHER
API Reference Guide > ISIS Component API Reference > ISIS Component Tags Reference > Scanning Mode Tags > IG_ISIS_TAG_DITHER

Scanner's dither settings. 0x0500  1280

IG_ISIS_TAG_DITHER sets or reads the dither settings of a scanner.

Type:

IG_ISIS_TAG_TYPE_STRING

Drivers:

All scanner drivers.

Values:

The application must get choices (using IG_ISIS_choice_get_ascii) to be aware of the number of values and the actual values of IG_ISIS_TAG_DITHER. Note that the first choice for this tag actually represents no dithering and is usually called "None." The actual values are defined within the scanner itself, and have names such as "A -- 8x8 w/53 grays," and "4x4 Diagonal." Scanners that support dithering store the IG_ISIS_TAG_DITHER values in an array. The lpwCount parameter of the IG_ISIS_choice_get_count function returns the number of dither choices for IG_ISIS_TAG_DITHER. The lpwLength parameter of the IG_ISIS_choice_get_ascii Length function returns the number of characters in each IG_ISIS_TAG_DITHER choice.

Tag Dependencies and Dependent Tags:

Many scanners only support dithering of binary images, and so the following tags may affect whether IG_ISIS_TAG_DITHER reports values other than `None.' Furthermore, some scanners may return different choices for IG_ISIS_TAG_DITHER depending on the values of the color format tags.

IG_ISIS_TAG_SAMPLESPERPIXEL  IG_ISIS_TAG_BITSPERSAMPLE  IG_ISIS_TAG_PHOTOMETRICINTERPRETATION  IG_ISIS_TAG_DITHER

Remarks:

Because dither patterns are unique to each scanner, there is no way to reduce the choices to numbers that can be understood programmatically. Your application must get the ASCII values of each of the IG_ISIS_TAG_DITHER choices, present them to the user, let the user make a selection, and then set the desired choice by setting the ASCII value.

See Also:

IG_ISIS_TAG_SAMPLESPERPIXEL

IG_ISIS_TAG_BITSPERSAMPLE

IG_ISIS_TAG_PHOTOMETRICINTERPRETATION