ImageGear Professional v18.2 > API Reference Guide > TWAIN Component API Reference > TWAIN Component Objects > IGTwainCtl Control > IGTwainCtl Methods > SetImageLayout Method |
Sets the image layout of the selected TWAIN device. You can use this to limit your capture region to a portion of the device's total area. The units are in inches by default. You can set the IG_TW_ICAP_UNITS capability to choose different units.
Use OpenSource to select the desired Data Source prior to calling this function.
![]() |
TWAIN image layout is specified using the Left, Top, Right, and Bottom properties of IGDoubleRectangle. The Width and Height properties should not be used, because they assume endpoint-inclusive semantics. Using endpoint-inclusive semantics, a rectangle with left, top, right, and bottom coordinates all equal to 0 is one pixel wide and one pixel tall. So, for example, the Width property is calculated as Right - Left + 1. This is not appropriate for a TWAIN image layout rectangle. Therefore, use only the Left, Top, Right, and Bottom properties. |
SetImageLayout(pVal As IGDoubleRectangle)
Name | Description |
---|---|
pVal | IGDoubleRectangle representing the physical bounding box of the region to be acquired. |
None