ImageGear for C and C++ on Windows v19.1 - Updated
IG_ISIS_TAG_PAGESIZE
API Reference Guide > ISIS Component API Reference > ISIS Component Tags Reference > Position and Resolution Tags > IG_ISIS_TAG_PAGESIZE

Scanner page size setting. 0x050E  1294  

IG_ISIS_TAG_PAGESIZE allows the application to obtain and then subsequently set the size of the page that the scanner is to scan.

Type:

IG_ISIS_TAG_TYPE_STRING

Drivers:

Drivers for scanners that support setting the desired page size. In addition, for scanners that do not support setting of page sizes, PIXDFLT has several predefined page sizes.

Values:

String containing the current page size to scan; for example, "Letter - 8.5 x 11 in", "Legal - 8.5 x 14 in", "A4 - 210 x 297 mm", and "Scanner's Maximum". The choices for IG_ISIS_TAG_PAGESIZE contain the entire set of page size values defined in the currently-selected scanner driver.

Tag Dependencies and Dependent Tags:

IG_ISIS_TAG_PAGESIZE affects the values of several other tags and so should be set before all of these other tags:

IG_ISIS_TAG_PAGESIZE  IG_ISIS_TAG_XRESOLUTION  IG_ISIS_TAG_YRESOLUTION  IG_ISIS_TAG_XPOSITION  IG_ISIS_TAG_YPOSITION  IG_ISIS_TAG_IMAGEWIDTH  IG_ISIS_TAG_IMAGELENGTH

Remarks:

Start by getting the choices for IG_ISIS_TAG_PAGESIZE from the scanner driver. These choices are ASCII strings that vary according to the scanner make, model, and the language of the driver. Display these choices for the user. When the user picks a choice, set this ASCII value on the driver.

If the scanner driver does not support settable page sizes, you can pass in IG_ISIS_DRV_LOAD_NEED_PAGESIZE in the IG_ISIS_drv_is_loaded call and PIXDFLT will return its set of predefined page sizes, from which the user can choose. Choosing one of these predefined page sizes from PIXDFLT is equivalent to (but easier than) setting a scanning area. To the user, the effect is the same: a page of the desired size is obtained.

See Also

IG_ISIS_TAG_XRESOLUTION

IG_ISIS_TAG_YRESOLUTION

IG_ISIS_TAG_XPOSITION

IG_ISIS_TAG_YPOSITION

IG_ISIS_TAG_IMAGELENGTH

IG_ISIS_TAG_IMAGEWIDTH