Description
Selects a list of objects as shape keys for another object. Selecting shape keys can optionally set up a relation between the target object or cluster and the shape keys, allowing to you fine-tune the shape keys and have those adjustments appear on the target object or cluster. Selecting shape keys creates shape sources but you also have the option of automatically creating a shape clip in the mixer similarly to SaveShapeKey.
With shape animation (sometimes called morphing), you can change the shape of an object over time, animating the geometrical shape of an object using clusters of points (clusters made of polygons or edges are not supported). You can use surface (NURBS) or polygon objects to create shape animation, or even curves and lattices--any geometry that has a static number of points.
In Softimage, all shape animation is done on clusters. This means that you can create different clusters on an object and create shape keys for each of them; or you can treat a complete object as one cluster and save shape keys for it. For more information on clusters in general, see the Softimage user guide.
Scripting Syntax
SelectShapeKey( InputObj, SourceObj, [RefMode], [Relational], [ApplyKeys] )
Parameters
|
Parameter |
Type |
Description |
|
InputObj |
List of objects to be deformed. |
|
|
SourceObj [in/out] |
List of objects that define the shape keys. |
|
|
RefMode [in/out] |
The reference mode of the shape key created Default Value: siShapeLocalReferenceMode |
|
|
Relational [in/out] |
Keep a modelling relation between the created shape and the selected geometry. Default Value: True |
|
|
ApplyKeys [in/out] |
Apply the shapes on the mixer given the shape instancing mode. Default Value: False |
Return Value
Returns the shape key(s) as an XSICollection of ShapeKey objects.
Examples
VBScript Example
'This example creates 3 spheres: 1 basic sphere and 2 deformed ones. 'The two deformed spheres have a different shape. ' 'The basic sphere will then use the two deformed spheres as shape 'sources, in order to morph between the two shapes. 'Create 3 sphere, give a different shape to 2 of them. NewScene CreatePrim "Sphere", "MeshSurface" SetValue "sphere.sphere.radius", 1 Duplicate "sphere", , 2, 1, 1, 0, 0, 1, 0, 1 Translate , -3, 0, -3, siRelative, siView, siObj, siXYZ SetSelFilter "Point" AddToSelection "sphere1.pnt[0-8,30-36]", , True AddToSelection "sphere1.pnt[0,1,16-22,44-50]", , True Scale , 1.9, 1.9, 1.9, siRelative, siGlobal, siObj, siXYZ Duplicate "sphere", , 2, 1, 1, 0, 0, 1, 0, 1 Translate , 3, 0, -3, siRelative, siView, siObj, siXYZ SetSelFilter "Point" AddToSelection "sphere2.pnt[*]", , True RemoveFromSelection "sphere2.pnt[0-8,30-36]" RemoveFromSelection "sphere2.pnt[0,1,16-22,44-50]" Scale , 2.4, 2.4, 2.4, siRelative, siGlobal, siObj, siXYZ 'Call SelectShapeKey to create 2 shapes based on the 2 deformed spheres SelectShapeKey "sphere", "sphere1,sphere2",_ siShapeLocalReferenceMode, True, False 'Apply the 2 shape keys ApplyShapeKey "sphere.polymsh.cls.sphere1_ShapeKey.sphere1_ShapeKey,"_ & "sphere.polymsh.cls.sphere1_ShapeKey.sphere2_ShapeKey", , , 1 ApplyShapeKey "sphere.polymsh.cls.sphere1_ShapeKey.sphere2_ShapeKey", , , 2 'Change the weights in order to see the blend between 'the 2 shapes on the target sphere SetValue "Mixer.Mixer_Shape_Track.sphere1_ShapeKey_ClusterClip."_ & "Mixer_Shape_Track2.sphere2_ShapeKey_Clip.actionclip.weight", 1 'Changing the sliders' values of sphere.ShapeWeights will blend 'from one source shape to the other: InspectObj "sphere.ShapeWeights"
See Also
Autodesk Softimage v7.5