ImageGear Professional v18.2 > 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.
IG_ISIS_TAG_TYPE_STRING
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.
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.
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
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.