v1.0

Applies a deformation by spine, which causes objects and/or clusters to be deformed in response to the deformations of one or more curves.

oReturn = SIApplyDeformBySpine( [ConnectionSet], [Interactive], [ConstructionMode] );

Returns the Object Name of the newly created Spine WeightMap operator(s).

Parameter	Type	Description
ConnectionSet	ConnectionSet	Specifies the objects connected to an operator. The first group of the ConnectionSet contains vertex based objects. The second group of the ConnectionSet contains NURBS curve objects. Once the command is executed, this argument returns the resulting ConnectionSet (for instance, if Interactive was TRUE, then the picked objects are included in the returned ConnectionSet). Default Value: Currently selected objects are used as the main group. Warning: An error occurs if the connection set is invalid. Please verify the connection set required for this operator to avoid breaking your scripts.
Interactive	Boolean	True to prompt the user to pick objects when the ConnectionSet doesn't include a secondary group. Default Value: False
ConstructionMode	siConstructionMode	Specifies in which construction mode to apply the operator. Default Value: Use the current construction mode

1. VBScript Example

'This example shows how to deform a grid using a circle.

'The circle is the curve spine used to deform the grid.

newscene

dim obj, crv

set obj = CreatePrim( "Grid", "MeshSurface" )

set crv = CreatePrim( "Circle", "NurbsCurve" )

Rotate crv, 90, 0, 0, siAbsolute, siParent, siObj, siX

Scale crv, 0.75, 0.75, 0.75, siAbsolute, siParent, siObj, siX

SIApplyDeformBySpine obj & ";" & crv

'moving the circle will deform the grid

Translate crv, 0, 5, 0, siAbsolute, siParent, siObj, siY

2. VBScript Example

' Create a Mesh Grid and Nurbs circle objects:

set CircleObj = CreatePrim( "Circle", "NurbsCurve" )

set GridObj = CreatePrim( "Grid", "MeshSurface" )

Rotate , 90, 0, 0

' Apply a Spine deform on the Grid, using the circle as deformer:

DeformSpineOp = SIApplyDeformBySpine( GridObj & ";" & CircleObj )

Application.LogMessage DeformSpineOp

' Now translate the circle and notice the deformation:

Translate CircleObj, 0, 0, 3

'========================================================

'OUTPUT:

'INFO : "grid.polymsh.cls.DeformBySpineWeightCls.Envelope_Weights.spinewgtmapop"

ApplyDeformBySpine