Param eters

Properties and parameters are specified using a dot notation. For example, the following string is the local X position of the object named “myCube”:

       "aModel.myCube.kine.local.posx"

This string represents a path through the scene hierarchy where:

• "aModel" is the name of a model.

• "myCube" is the name of an object in aModel.

• "kine" is the scripting name of the Kinematics property.

• "kine.local" is the scripting name of the Local Transforms property.

• "posx" is the scripting name of the X position parameter.

A property (sometimes called a property set) is a container for a group of related parameters. For example, the Local Transforms (local) property contains the X, Y, and Z position parameters. A property can also contain other properties. For example, the Kinematics property contains the Local Transforms, Global Transforms, and Constraints property.

If an object is not part of a model, you can omit the model name. For example, write:

       "aCube"

instead of

       "Scene_Root.aCube"

If you are applying a command to the currently selected object, you can omit the object name. For example, the following is theglobal X position of the currently selected object:

       "kine.global.posx"

Local transforms are the default, so you do not have to explicity refer to it. For example, the following is the local X position of the currently selected object:

       "kine.posx"

You can also omit property names such as surfmsh, polymsh, and crvlist. For example:

This expression is the equivalent ... | to this expression ...
    "aBall.surfmsh.geom.subdivu"
    "aBall.geom.subdivu"
    "cube.polymsh.cls.Point.red"
    "cube.cls.Point.red"
    "circle.crvlist.geom.subdivu"
    "circle.geom.subdivu"

If there are multiple properties with the same name, you can reference them using square brackets:

       SelectObj "null1.kine.poscns[2]"

When separating a list of objects and a list of parameters, use a slash (/) character. For example, the following command saves a key on the local position of objects named “Fluffy” and “Sparky”:

       SaveKey "{Fluffy,Sparky}/kine.local.pos"

| To determine a parameter name, change the parameter value in a property editor and see what gets logged in the command history. Alternatively, set Show > Use Script Names in an explorer.

Autodesk Softimage v7.5