SaveShapeKey

Description

Creates a shape key for the current shape and adds it to the model's list of shape sources (in the model's Mixer > Sources > Shape folder). Also adds an instance of the shape key as a shape clip on a track in the animation mixer. The track is contained in a compound clip corresponding to the cluster.

This is the scripting equivalent of storing a shape key and then immediately bringing it into the animation mixer as a clip with ApplyShapeKey.

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

    SaveShapeKey( InputObj, [Compound], [Track], [Time], [Duration], [Mode], [Name], [Overwrite], [RefMode] )

Parameters

Parameter | Type | Description
InputObj | XSICollection | The geometry or cluster to create the clip from.
Compound | XSICollection | The compound container (track owner) to add this clip to.
Track | XSICollection | The track to add this clip to.
Time [in/out] | Double | The time at which to add the clip. Default Value: If not supplied, the key frame will be used.
Duration | Double | The length of the clip in frames. Default Value: If not supplied, the time stored in the source is used.
Mode | Long | The shape clip authoring mode (0=instance only, 1=weight mix, 2=transition, 3=transition cardinal, 4=use default). Default Value: If not supplied try to figure out the "right" mode. Possible Values: • 0: instanceonly • 1: weightmix • 2: transition • 3: transitioncardinal • 4: usedefault
Name | String | The name to use for the new clip. Default Value: If no name is supplied, then a variation on the source name will be used.
Overwrite | Long | The behaviour when a shape clip already exist at the key time (0=prompt user, 1=replace, 2=add, 3=skip). Default Value: If not supplied prompt user (in batch mode the default is replace). Possible Values: • 0: promptuser • 1: replace • 2: add • 3: skip
RefMode [in/out] | siShapeReferenceMode | The reference mode of the shape key created Default Value: siShapeLocalReferenceMode

Return Value

Returns the created shape animation clip as a Clip object.

Examples

VBScript Example

    CreatePrim "Sphere", "NurbsSurface"
    SetSelFilter "Point"
    AddToSelection "sphere.pnt[(5,4),(6,4),(7,4),(0,5),(1,5),(2,5),(3,5),(4,5),(5,5),(6,5),(7,5),(0,6),(1,6),(2,6),(3,6)]"
    CreateCluster
    SaveShapeKey "sphere.surfmsh.cls.Point" , , , 10, , 1 , "MyShapeClip"

See Also

SaveShapeKey | ApplyShapeKey | SelectShapeKey | StoreShapeKey

Autodesk Softimage v7.5