(v13) HqnLayout ControlBars

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP.

A ControlBar object is defined as a dictionary containing the following keys. The ControlBar may also contain keys as described in the (v13) HqnLayout strips and (v13) HqnLayout blocks, in which case all Strips or Blocks that do not contain their own explicit definition of those keys inherit from the ControlBar.

ControlDepth (ControlBars)

number

The height of the rectangle to be allocated for this control bar, in points. Required (no default value).

Marks (ControlBars)

Array Default: 0

An array of marks, as defined in the HqnImpose2 documentation. Each may include a definition of BaseX , BaseY, and BaseAngle, which define the position of this mark within the space allocated for the control bar. All default to 0.

You can use the adaptstandard utility procedure to convert a suitable Block object to a Mark dictionary in this array.

If no marks are required in the control bar, this entry should be omitted.

StripSequence (ControlBars)

array

An array of Strip objects, defining the color bars to be drawn within this ControlBar. The BaseY, LeftEnd, and RightEnd values within each Strip are used to position each strip relative to the space allocated for the whole ControlBar.