OMR Box

Defines the location, output value, and registration settings for a checkbox.

Remarks

OmrBox specifies a single checkbox to be read by Zonal OMR, including its output value, location, and optional local registration (alignment) settings.

---

Overview

Each OmrBox represents one checkbox on the form. You define:

• The value to output if the box is checked (Value).
• The rectangular region where the checkbox is expected (Bounds).
• (Optionally) an Anchor for local alignment, allowing the box to move relative to a detected label or feature.

OmrBoxes are combined in the parent Zonal OMR extractor to define all checkboxes to be read on a page.

---

Usage Guidance

• Use a unique Value for each box to clearly identify the meaning of a checked box in the output.
• Set Bounds as precisely as possible to the expected checkbox location on the sample document.
• If the checkbox may shift position (e.g., due to variable labels), configure an Anchor to provide local registration.
• Always use the same sample document when configuring both Bounds and Anchor to ensure alignment.

---

Notes

• The number of OmrBoxes must match the requirements of the parent Zonal OMR mode (Boolean: 1, CheckOne/CheckMulti: 2+).
• For more details, see the Zonal OMR and OMR Box wiki pages.

Properties

Name	Type		Description
Value	String	►	Specifies the output value for this checkbox if it is checked. Requiredtrue The value to be output when this checkbox is detected as checked. Use a unique, descriptive value for each box (e.g., "Yes", "No", "OptionA", "OptionB"). This value appears in the output of the parent Zonal OMR extractor.
Bounds	Logical Rectangle	►	Defines the location of the checkbox on the page. EditorZone Editor ConverterLogical Rectangle Converter Requiredtrue The rectangular region (in inches) where the checkbox is expected to appear. Set this region as tightly as possible around the checkbox on the sample document. If the checkbox may move, use the 'Anchor' property for local alignment.
Anchor	Anchor Definition	►	Defines a reference point relative to a text element on the document for local alignment. ConverterOn Off Converter Can be one of the following types: Value Description Enabled Disabled (Optional) An Anchor used to align this checkbox relative to a detected label or feature. Use this if the checkbox's position may vary from page to page. If not set, the parent Zonal OMR's Anchor (if any) is used. Always configure the 'Bounds' and 'Anchor' using the same sample document.

See Also

Logical RectangleAnchor Definition

Used By

Zonal OMR