--area

--area "left top right bottom unit"

Please note: Starting with version 2.0.0.0 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:

Unit	Description
inch	Inches
cm	Centimeters
mm	Millimeters
twip	1,440 twips per inch
pica	6 picas per inch
pixel	units are in pixels
point	72 points per inch

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

clip0001

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.