DuplicateSymmetry
 
 
 

DuplicateSymmetry

Introduced

v1.5

Description

Duplicates objects and mirrors the resulting objects across a given plane.

This command will fail where Duplicate fails.

At the moment, this works for chains and some simple geometry. DuplicateSymmetry on bone primitives behaves like simple geometry rather than chains. Some issues still have to be resolved in order to apply it to any geometry (use at your own risk).

Scripting Syntax

oReturn = DuplicateSymmetry( InputObjs, [DuplicateConstraints], [ShareParent], [SymmetryPlaneA], [SymmetryPlaneB], [SymmetryPlaneC], [SymmetryPlaneD], [S3D_CMDARG_FREEZESCL] );

Return Value

Returns an XSICollection object that contains the list of symmetric objects

Parameters

Parameter Type Description
InputObjs String List of objects to duplicate and mirror.

Default Value: Selected objects

DuplicateConstraints Boolean Duplicate the constraints on the objects?

Default Value: True

ShareParent Boolean Share the same parent

Default Value: False

Possible Values:

Description:

True Will parent the symmetric object under the same parent as the original (or the symmetric parent, if any)
False Will parent the symmetric object under the scene root.
SymmetryPlaneA Double (Symmetry plane equation) Ax +

Default Value: 0

SymmetryPlaneB Double (Symmetry plane equation) By +

Default Value: 0

SymmetryPlaneC Double (Symmetry plane equation) Cz =

Default Value: 1

SymmetryPlaneD Double (Symmetry plane equation) D

Default Value: 0

S3D_CMDARG_FREEZESCL Boolean Freezes negative scaling values created during the symmetry operation.

Default Value: True

Possible Values:

Description:

True Final scaling will be the absolute value of the original scaling. A center operator may appear in the construction history.
False Duplicated objects will have negative scaling.

Examples

VBScript Example

' This example creates a 3D chain, duplicates it
Create3DSkeleton -1.330, -5.732, 0.000, 2.050, -3.737, 0.000, 0.000, 0.000, 1.000
AppendBone , 0.000, -4.556, -2.271, False
AppendBone , 1.219, -7.006, 0.000, False
SelectObj "root", "BRANCH"
set obj = DuplicateSymmetry(, True, False, 0, 1, 0, 0, True)

See Also

Duplicate