Replaces a shape key with the current shape of an object. When you
do this, any existing clips that use the source are also updated,
and new clips from this source will be based upon its new 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.
Note: This command uses output arguments. C# and some
scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you
need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection
which you can use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand
packs the output arguments into a C# System.Object containing an Array of the output arguments (see
Calling Commands from C#).
ReplaceShapeKey( InputObj, [OutputObj], [ForceDeformStripping] ); |
Parameter | Type | Description |
---|---|---|
InputObj | String | The shape key to be replaced. |
OutputObj | ShapeKey | Returns the shape key |
ForceDeformStripping | Boolean |
Forces the removal of any deformations above the shape combiner. Default Value: false |
' ' This example creates a shape key, and then replaces it with another ' key that creates another shape (overwrites the original one) ' NewScene , false set oTarget = CreatePrim( "Sphere", "MeshSurface" ) SaveShapeKey oTarget , , , 1, , , , , siShapeLocalReferenceMode ' Replace the saved key with one 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 SelectObj "sphere.polymsh.cls.Shape.ShapeKey" ReplaceShapeKey , rtn 'INFO : sphere.polymsh.cls.Shape.ShapeKey logmessage rtn.FullName |