Logical Rectangle

Defines a rectangle in terms of top, left, width, and height using logical (unit-aware) values.

Remarks

Logical Rectangle allows you to specify the position and size of a rectangle using unit-aware string values for each edge and dimension. This is useful in scenarios where rectangles must be defined in logical (physical) units such as inches, points, centimeters, millimeters, or as a percentage of a reference size, rather than device-dependent units like pixels.

Each property (Left, Top, Width, Height) can be configured independently. You may enter values directly as a comma-separated string, or expand the property in the UI to edit each value separately.

Usage

• To set all values in points: 10pt, 15pt, 5pt, 8pt
• To use percentages: 10%, 10%, 80%, 80%
• To use mixed units: 1in, 2cm, 100pt, 25mm

Supported Unit Types

The following unit types are supported when specifying values for Logical Rectangle:

• in: Inches
• pt: Points (1/72 of an inch)
• cm: Centimeters
• mm: Millimeters
• %: Percent (relative to the page or container size)

Note: The px (pixels), twip (twentieths of a point), and em (typographic em) units are not supported in Logical Rectangle. Attempting to use these units will result in a validation error.

Examples

• 10pt, 15pt, 5pt, 8pt: Sets left, top, width, and height in points.
• 1in, 2in, 3in, 4in: Sets all values in inches.
• 10%, 10%, 80%, 80%: Defines a rectangle as a percentage of the page or container.

When configuring a Logical Rectangle, ensure that the units are appropriate for the logical context in which the rectangle will be used.

Properties

Name	Type		Description
Left	String	►	The left edge of the rectangle, specified as a unit-aware string. ConverterUniversal Value Converter Sets the horizontal starting position of the rectangle. Enter a value with a supported unit (such as 1in, 10pt, 2cm, 5mm, or 10%). Supported units:in, pt, cm, mm, %
Top	String	►	The top edge of the rectangle, specified as a unit-aware string. ConverterUniversal Value Converter Sets the vertical starting position of the rectangle. Enter a value with a supported unit (such as 1in, 10pt, 2cm, 5mm, or 10%). Supported units:in, pt, cm, mm, %
Width	String	►	The width of the rectangle, specified as a unit-aware string. ConverterUniversal Value Converter Sets the width of the rectangle. Enter a value with a supported unit (such as 3in, 100pt, 5cm, 25mm, or 80%). Supported units:in, pt, cm, mm, %
Height	String	►	The height of the rectangle, specified as a unit-aware string. ConverterUniversal Value Converter Sets the height of the rectangle. Enter a value with a supported unit (such as 4in, 80pt, 6cm, 30mm, or 80%). Supported units:in, pt, cm, mm, %

Used By

Color Stamp DetectionBarcode DetectionOCR ReaderFind BarcodePlace ZoneResult FilterFixed RegionRelative RegionOMR BoxColorTrac ScannerImport DeviceISIS DeviceTWAIN DeviceBarcode Detected