ActionDelta.AddExpressionItem

Description

Adds a new ActionDeltaItem of type siModificationDeltaExpression to an ActionDelta created with the Delta.AddAction method.

The ActionDelta should be of type siModificationDeltaExpression to use this method (see siModificationDeltaType for a list of ActionDelta types).

C# Syntax

ActionDeltaItem ActionDelta.AddExpressionItem( Object in_vTarget, Object in_vExpression );

Scripting Syntax

oReturn = ActionDelta.AddExpressionItem( Target, Expression );

Return Value

ActionDeltaItem

Parameters

Parameter Type Description
Target String Target path for source item
Expression String The definition (formula) that defines the expression. For more information on how to define an expression, see "Expression Reference" in the Softimage User?s Guide.

Examples

JScript Example

/*
	This example demonstrates how to add an ActionDeltaItem of type 
	siModificationDeltaExpression to a ActionDelta.
*/
NewScene (null, false);
// Create a reference model from a cube
var oRoot = Application.ActiveProject.ActiveScene.Root;
var oCube = oRoot.AddGeometry("Cube", "MeshSurface");
var emdlFileRefModel = XSIUtils.BuildPath(Application.InstallationPath(siProjectPath), "Models", "MyModel.emdl"); 
CreateModelAndConvertToRef(oCube, emdlFileRefModel);
// Create a cone
var oCone = oRoot.AddGeometry("Cone", "MeshSurface");
// Translate the cube that also generate a delta
Translate(oCone , 3.0, 3.0, 0, siRelative, siView, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 0, null);
// Add the Delta object
var oDelta = AddDelta(oCube.Model);
// Add an action of type siModificationDeltaExpression
var oDeltaAction = oDelta.AddAction(siModificationDeltaExpression)
// Add the expression item
var oActionDeltaItem = oDeltaAction.AddExpressionItem(oCube + ".kine.global.posx",  "5*sin(" + oCone + ".kine.local.posx * 15)");
// Apply modification
oDelta.Apply();

See Also

ActionDelta.AddFCurveItem ActionDelta.AddConstraintItem ActionDelta.AddStaticValueItem