Top  Previous  Next

-area "left top right bottom unit"


Please note:  Starting with version of TwainSave, the -area command uses the TWAIN device's internal area of interest (AOI) support.  This means that your device must support the following:


1) setting the area of interest to acquire and

2) the unit of measure (inch, centimeter, etc.) must also be supported by your device.


Acquires a partial area of the pages to be scanned.  The -area command line option must be followed by four numeric arguments that define a rectangular area of the page to acquire, and the unit of measure of the arguments.  The arguments must be in the order of left, right, top, and bottom of the rectangle, and unit of measure.


Note that the arguments for -area must be enclosed in double quotes.


The unit of measurement that these arguments must be one of the following:












1,440 twips per inch


6 picas per inch


units are in pixels


72 points per inch


The following illustration shows the definition of the image area of acquisition and left, top, right, and bottom values denote:


The origin of the page (top left-hand corner) always has an (x,y) coordinate of (0,0).  Going right from the origin, the x-values increase.  Going down from the origin, the y-values increase.  There are no negative coordinates.


For example, if the entire page is 8.5 inches by 11 inches, and you desire to acquire a 4 inch by 4 inch area starting from the top left, the following options on the twainsave command line should be used:


-area "0 0 4 4 inch"


The top left is (0, 0), and the bottom right of the rectangle is (4, 4).  The unit inch specifies that the unit of measurement is in inches.


The arguments for -area can be integer or floating point numbers.  For example, to specify 4 1/2 inches x 6 1/4 centimeters starting from the top left:


-area "0 0 4.5 6.25 cm"


Default Setting:

The entire page is acquired.