ApplyShapeKey

Categories

animation deformation

Description

Applies the specified shape key to an object at the current frame and creates a ShapeClip in the animation mixer. You can apply ShapeKeys that you have stored or selected, as well as those that you have saved if you want to return to a previous shape.

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

oReturn = ApplyShapeKey( [InputObj], [Compound], [Track], [Time], [Duration], [Mode], [Name], [Overwrite] );

Return Value

Returns a Clip.

Parameters

Parameter Type Description
InputObj String The source to create the clip from. Typically, a "source" is an shape action or a cluster key

Default Value: Current source

Compound String The compound container (track owner) to add this clip to.

Default Value: Current compound container

Track String Track to add this clip to.

Default Value: Current track

Time Double Frame at which to add the clip.

Default Value: Key frame

Duration Double Length of the clip in frames.

Default Value: Time stored in source

Mode Integer Shape key mode.

Default Value: 4 (Use Default)

Possible Values:

Description:

0 Instance Only
1 Weight Mix
2 Standard Transition
3 Cardinal Transition
4 Use Default
5 Blend Weight
Name String Name of the new clip.
Overwrite Integer Behaviour when a shape clip already exists at the key time.

Default Value: Prompt user (in batch mode the default is replace).

Possible Values:

Description:

0 Prompt User
1 Replace
2 Add
3 Skip

Examples

VBScript Example

'
' This example stores two shape keys without activating them.
' Then, it applies the second stored shape to the object.
'
' Create a sphere, store a first key with no deforms
NewScene , false
CreatePrim "Sphere", "MeshSurface"
StoreShapeKey "sphere", , siShapeLocalReferenceMode
' Store a second key with some deforms (move points)
SetSelFilter "Point"
SelectGeometryComponents "sphere.pnt[27,28,34,35,41,42]"
Translate , 4.8, 4.3, -0.4, siRelative, siView, siObj, siXYZ
StoreShapeKey "sphere", , siShapeLocalReferenceMode
ActivateObjectSelTool
' Delete the move point op (info is already in the key)
DeleteObj "sphere.polymsh.movecomponentop"
' Apply the stored shape key
ApplyShapeKey "sphere.polymsh.cls.Shape.ShapeKey1", , , 1

See Also

SaveShapeKey ApplyShapeKey SelectShapeKey StoreShapeKey