txCopyFigSet

txCopyFigSet(
T_srcFigSet
l_transform
)
=> T_newFigSet / nil

Description

Copies each figure from the source FigSet and applies to it the specified transform to create a new FigSet with an automatically generated name.

Arguments

T_srcFigSet	ID of the source FigSet.
l_transform	list(g_offset t_transform [f_scale]) A transformation object. where, g_offset: list(f_offsetX f_offsetY) An offset vector. t_transform A transformation name. Valid values are “R0”, “R90”, “R180”, “R270”, “MX”, “MXR90”, “MY”, and “MYR90”; or, their corresponding symbols such as 'R0, 'R90, 'R180, 'R270, 'MX, 'MXR90, 'MY, and 'MYR90. f_scale A scale ratio (optional). Default value is 1.0.

Value Returned

T_newFigSet	ID of the created FigSet.
nil	Returned in case of failure.

Examples

Copies the source FigSet fs0 and applies to it the R90 transform to create a new FigSet fs1.

fs0 = txCreateFigSet(cv "fs0")

> tx@0x2c0295c0

txAppendObjectToFigSet(fs0 dbCreateRect(cv '(0 "drawing") '((0 0) (200 100))))

> t

fs1 = txCopyFigSet(fs0 '(((0 0) "R90")))

> tx@0x2c04f190

txGetFigSetData(fs1 0)~>bBox

> ((-100.0 0.0) 

>     (0.0 200.0)

> )

Related Topics

FigSet Functions

Return to top