Logical Range

Defines a range of distances.

Remarks

Logical Range is used to define a range of distances or sizes in Grooper, where each bound can be specified using a value and unit (such as 2.5in, 5pt, 3cm, or 10mm). This allows for flexible configuration of measurements that adapt to different page sizes and logical coordinate systems.

The range is defined by two properties: 'Minimum' and 'Maximum'. Each can be set independently, or both can be set to the same value to specify an exact distance. If only one bound is set, the range is considered open-ended on the other side.

Usage

• To specify an exact value, set both 'Minimum' and 'Maximum' to the same value (e.g., 2in).
• To specify a range, set 'Minimum' and 'Maximum' to different values (e.g., 1in and 2in).
• To specify only a minimum, leave 'Maximum' blank (e.g., > 5pt).
• To specify only a maximum, leave 'Minimum' blank (e.g., < 3cm).

The values are parsed and validated using Grooper's unit system, and are automatically converted to logical (inch-based) values as needed for processing. Unlike Unit Range, Logical Range does not support pixel (px) or percent (%) units, as these are not meaningful in logical coordinate contexts.

Examples

• 1in - 2in: Defines a range from 1 to 2 inches.
• 5pt: Sets both minimum and maximum to 5 points.
• < 3cm: Sets a maximum of 3 centimeters, with no minimum.
• > 10mm: Sets a minimum of 10 millimeters, with no maximum.

Supported Unit Types

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

• in: Inches
• pt: Points (1/72 of an inch)
• cm: Centimeters
• mm: Millimeters

Note: The px (pixels) and % (percent) units are not supported in Logical Range. Attempting to use these units will result in a validation error.

When configuring a Logical Range, ensure that the units are appropriate for the logical context in which the range will be used. If the minimum value is greater than the maximum, validation will fail.

The Logical Range is commonly used in scenarios where measurements must be specified in logical (physical) units, such as inches or points, rather than device-dependent units like pixels.

Properties

Name	Type		Description
Minimum	String	►	The minimum value of the range, specified as a unit-aware string. ConverterUnit Value Converter The 'Minimum' property defines the lower bound of the Unit Range. Enter a value with a unit (such as 10px, 2.5in, or 5pt). If left blank, the range will have no lower bound. Examples 10px: Sets the minimum to 10 pixels. 2.5in: Sets the minimum to 2.5 inches. If both 'Minimum' and 'Maximum' are set, the range will include all values between them. If only 'Minimum' is set, the range will include all values greater than or equal to the specified minimum.
Maximum	String	►	The maximum value of the range, specified as a unit-aware string. ConverterUnit Value Converter The 'Maximum' property defines the upper bound of the Unit Range. Enter a value with a unit (such as 15px, 3in, or 10pt). If left blank, the range will have no upper bound. Examples 15px: Sets the maximum to 15 pixels. 3in: Sets the maximum to 3 inches. If both 'Minimum' and 'Maximum' are set, the range will include all values between them. If only 'Maximum' is set, the range will include all values less than or equal to the specified maximum.

Used By

Constrained Wrap OptionsResult Filter