Sets up pose-based deformation so that shape animation can be driven by one or more specified parameters
(the position and orientation of an element in a scene, for example). Once the pose-base deformation is
set up using LinkDeform and deform keys are created (using ApplyDeformKey or
SaveDeformKey), the selected parameters drive the deformation of the geometry. The
resulting deformation is interpolated smoothly between the shapes in the N-space defined by the N
parameters selected.
Pose-based deformation (which is based on multi-linked parameters) allows you to link the shape of a
cluster to several parameters simultaneously. The resulting shapes are smoothly interpolated in the
space defined by the parameters. Pose-based deformations are particularly useful to link the shape of
muscles to bone orientations or other parameters.
oReturn = LinkDeform( [Cluster], [Parameter list], [LinkWithOri] ); |
Returns an ISIVTCollection containing an XSICollection which contains the objects whose numerical parameters are linked with the shape.
Parameter | Type | Description |
---|---|---|
Cluster | String |
Cluster to consider for future deformations Default Value: Current selection |
Parameter list | String |
List of numerical parameters to link with the shape. Default Value: Picked in explorer. |
LinkWithOri | Boolean |
True to link deformation with rotation. Default Value: False |
' This example illustrates how to control the shape of an object (a sphere) based on two parameters ' its position in x and in z. NewScene ' Here we create the geometry that will be deformed CreatePrim "Sphere", "MeshSurface" ' We create the specific cluster that will be deformed SelectGeometryComponents "sphere.pnt[4-6,11-13,18-20,25-27,32-34,39-41,46-48,53-55]" CreateCluster ' We link the deformation of the new cluster to the position of the sphere in x and z LinkDeform "sphere.polymsh.cls.Point", "sphere.kine.global.posz,sphere.kine.global.posx" ' Finally we model and save deform keys defining the relationship between the different ' sphere positions and the shape Translate "Sphere", -10, 0, 0, siAbsolute, siParent, siObj, siX ActivateVertexSelTool Scale "sphere.polymsh.cls.Point", 0.267441860465116, 1, 1, siRelative, siLocal, siObj, siXYZ SaveDeformKey "sphere.polymsh.cls.Point" Translate "Sphere", 10, 0, 0, siAbsolute, siParent, siObj, siX Scale "sphere.polymsh.cls.Point", 0.313953488372093, 1, 1, siRelative, siLocal, siObj, siXYZ SaveDeformKey "sphere.polymsh.cls.Point" Translate "Sphere", 0, 0, 10, siAbsolute, siParent, siObj, siZ Scale "sphere.polymsh.cls.Point", 1, 1, 0.302325581395349, siRelative, siLocal, siObj, siXYZ SaveDeformKey "sphere.polymsh.cls.Point" Translate "Sphere", 0, 0, -10, siAbsolute, siParent, siObj, siZ Scale "sphere.polymsh.cls.Point", 1, 1, 0.27906976744186, siRelative, siLocal, siObj, siXYZ SaveDeformKey "sphere.polymsh.cls.Point" ' To see the result translate the sphere in the XZ plane. The multi-link interpolator will ' calculate a smooth blending between the deform keys over the space defined by the two parameters |
' ' In this example, an animation is created (on Y axis) on ' a sphere. A cluster is created with some points of the ' sphere, and the cluster is "linked" for deform with the ' local YPos parameter of the sphere. In this way, changes ' on YPos of the sphere will deform its shape. ' Two deformations (i.e. moves) of the points of the cluster are ' performed in different frames, and each of the deformation acts ' as DeformKey. ' NewScene CreatePrim "Sphere", "NurbsSurface", "MySphere" ' Create anim key of YPos of the sphere, at different frames SetValue "PlayControl.Out", 40 SaveKey "MySphere.kine.local.posy", 1, -3.0 SaveKey "MySphere.kine.local.posy", 30, 3.0 SaveKey "MySphere.kine.local.posy", 40, 1.5 ' Create a cluster in the sphere, and create a LinkDeform SetSelFilter "Point" AddToSelection "MySphere.pnt[(0,6),(7,6),(6,6),(5,6),(4,6),(3,6),(6,5),(1,6),(1,5),(2,6),(7,5),(0,5),(2,5),(5,4),(5,5),(4,5)]" CreateCluster LinkDeform "MySphere.surfmsh.cls.Point", "MySphere.kine.local.posy" ' Create the first Deform key at frame 1, with translation of ' points of the cluster SetValue "PlayControl.Current", 1 Translate "MySphere.pnt[(0,6)]", -1.74522900164809, 0.27627214396616, -0.027627214396616, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(0,5)]", -1.63879153625736, 7.95443183208384E-02, -7.95443183208383E-03, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(4,6)]", 2.5, 0.5, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(4,5)]", 2.5, -0.3, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(3,5)]", 2, -1.5, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(1,5)]", -1.5, -0.4, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(7,6)]", -1.2, 1.26649251503908, -0.2, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(5,6)]", 1.5, 1.53788376826177, -0.2, siRelative, siView, siObj, siXYZ SelectObj "MySphere.surfmsh.cls.Point" SaveDeformKey ' Create the second Deform key at frame 30, with translation of ' points of the cluster SetValue "PlayControl.Current", 30 Translate "MySphere.pnt[(0,6)]", 6.0, -0.5, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(0,5)]", 5.4, 0, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(1,5)]", 4.0, 1.3, -0.13, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(4,5)]", -5.5, 0.12, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(4,6)]", -6.0, -0.5, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(5,4)]", -1.7, 0.5, 0, siRelative, siView, siObj, siXYZ Translate "MySphere.pnt[(3,6)]", -2.0, 0, 0, siRelative, siView, siObj, siXYZ SaveDeformKey "MySphere.surfmsh.cls.Point" ' Playback the animation SetDisplayMode "Camera", "textured" PlayForwardsFromStart |