Group options

Create or select group (g)

g command causes the current layer to be applied to a group instead of the main canvas. The parameter value should indicate the desired group ID. Group IDs can be arbitrary values; they do not have any effect on the rendering process.

Since group command applies to the current layer, it should follow the layer command.

Groups are automatically created whenever a new group ID is encountered. Whenever a new group is created, gsz parameter should be used to specify the group canvas dimensions; size specification can be omitted (in fact it is ignored) after a group has been created. If canvas dimensions are not known when a layer is rendered, an error will be generated.

For example: g=Monogramming&gsz=1000,1000

Group canvas dimensions (gsz)

Configures group canvas dimensions. The parameter value should two comma-separated numbers, width and height respectively.

For example: gsz=1000,2000

Group flow (gfl)

By default, the main canvas and groups are rendered using direct positioning instructions that are provided by each layer - using pos, sz, etc commands.

However, groups can be configured to perform automatic layout of layers that are rendered on corresponding canvases. If automatic layout is enabled, all positioning instructions will be ignored, with a few exceptions, and images and text layers will be arranged on the canvas. Dimensions of layers can be automatically adjusted to ensure that all group elements fit within the allotted space using fit parameter.

When using fixed sized group elements, it is still possible to overrun the allowed group space if the total of fixed dimensions is too big.

The parameter value should follow the usual pattern of complex variables and parameter values. The command parameter sequence shall be a semi-colon-separated list of variable names and values, each separated by : character, for example:var1:value1;var2:value2,...

The flow command supports the following parameters:

Variable	Type of value	Description
`f`	`string`	Flow type. Supported values: `stacked`
`fit`	`string`	Autosing mode. Supported values: `none` (default) `contain`
`g`	`number`	Gap between group elements, in pixels.
`a`	Supported values: `s` `c` `e`	Horizontal alignment, respectively: Start (left for LTR languages) Center End (right for LTR languages)
`va`	Supported values: `s` `c` `e`	Vertical alignment, respectively: Top Center Bottom

Layer position type (pt)

pt command allows to specifying the layer positioning type when the group automatic layout is enabled.

For example: pt=abs

Type	Comments
`auto`	The default value. The layer will be subject to the group flow layout.
`fixed`	Similar to `auto`, however the layer dimensions will be fixed and not adjusted when layout autosiznig is used.
`abs`	Absolute positioning. The layer will not be subject to the group flow layout, and will be placed on the canvas using the standard rules.