ImageGear Professional v18.2 > API Reference Guide > TWAIN Component API Reference > TWAIN Component Objects > IGTwainCtl Control > IGTwainCtl Methods > GetImageLayout Method |
Gets the image layout of the selected TWAIN device. You can use it to limit your capture region to a portion of the device's total area. The units are in inches by default. You can set IG_TW_ICAP_UNITS capability to choose different units.
Use OpenSource to select the desired Data Source prior to calling this method.
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. |
GetImageLayout() As IGDoubleRectangle
IGDoubleRectangle that represents the physical bounding box of the region to be acquired.