Introduced
5.0
Description
Assigns the input ShapeKey(s) to the specified shape group. If the shape group doesn't exist it will be created.
A shape key can be part of only one shape group.
Scripting Syntax
SetShapeGroup( InputObj, Name )
Parameters
|
Parameter |
Type |
Description |
|
InputObj |
Shape keys for which we want to set the shape group. |
|
|
Name |
Name of the shape group. |
Examples
JScript Example
/*
This example illustrates how to switch shape groups on a shape key.
*/
NewScene( null, false );
CreatePrim("Cone", "MeshSurface", null, null);
ActivateVertexSelTool(null);
ActivateVertexSelTool(null);
SelectGeometryComponents("cone.pnt[1]");
Translate(null, -4.77865299554318, 0, 0, siRelative, siGlobal, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 1);
StoreShapeKey("cone.pnt[1]", "", siShapeLocalReferenceMode, 1, 0, 0, siShapeContentPrimaryShape, false);
SelectFilter("object");
Translate(null, 9.36145955684278, 0, 0, siRelative, siGlobal, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 1);
StoreShapeKey("cone.polymsh.cls.Shape", "", siShapeLocalReferenceMode, 1, 0, 0, siShapeContentPrimaryShape, false);
SelectObj("cone", null, true);
var oShapeCluster = Selection(0).ActivePrimitive.Geometry.Clusters(0);
var oShapeKey0 = oShapeCluster.Properties("ShapeKey");
var oShapeKey1 = oShapeCluster.Properties("ShapeKey1");
// Logs the default shape group
LogMessage(oShapeKey0.ShapeGroupName);
LogMessage(oShapeKey1.ShapeGroupName);
// Changing the shape group of the first shape key
SetShapeGroup(oShapeKey0, "MyShapeGroup");
// Logs "MyShapeGroup" for the first key and the default for the second.
LogMessage(oShapeKey0.ShapeGroupName);
LogMessage(oShapeKey1.ShapeGroupName);
See Also
SOFTIMAGE|XSI v6.01