Description

Merges multiple selected box or rule objects (also if rotated) into one multi-shape object.

Syntax

options

bit-field. Bit 0 "off" will delete the source multiple objects, leaving only the merged one, otherwise (bit "on") original boxes will remain in page. Bit 1 "off" will copy rule/fill/transparency properties of the first selected source object, otherwise (bit "on") a box with default properties will be created.

Remarks

It is recommended to be applied on objects, created by converting text to curves to have a single object, instead one for each character. In that way, you can achieve texture effects replacing the object with a picture), or shading across all characters.

Note: you can combine boxes with other boxes, and rules with other rules, but not boxes and rules.

The return value is "false" when the operation was correctly performed. It can fail (returning "true") if: 1) less than two object are selected; 2) an object that is not a box nor rule is selected; 3) too many objects are to be merged (the limit is 128 polygons, that is about 80 chars when merging letters, duplicated in curves).

Example

Page.ObjMerge (0)   --> Merge objects deleting source and copying drawing options

Page.ObjMerge (1+2) --> Merge objects leaving source in page and creating an object with default box drawing options

Context

Page designer