Object List

An object list is a string that identifies objects, components, and parameters.

A object list can identify a single object. For example, the following string identifies the local X translation of the cube object:

   "cube.kine.local.posx"

An object list can also identify many objects. For example, the following string identifies the local X, Y, and Z translations:

   "cube.kine.local.posx, cube.kine.local.posy, cube.kine.local.posz"

Syntax
keyword

Description

,

Separates items in a list. For example:

   "cube.kine.local.posx, cube.kine.local.posy, cube.kine.local.posz"

{}

Specifies a list of objects. For example, the following selects the posx local transfo parameter of the cube and sphere objects:

   "{cube, sphere}.kine.local.posx"

*

Matches one or more characters. For example:

"Views.ViewA.*Camera" matches all cameras of view A.

"Passes.MyPass.*" matches all partitions under "MyPass".

"Layers.MyLayer.*" matches all objects in "MyLayer".

"cube*" matches all objects whose names begin with "cube".

"Cone.pnt[*]" matches all the points on the object. This is the same as "Cone.point[0-LAST]".

/

A marking list for a command. Separates a list of objects and a list of animatable parameters. For example, the following command adds fcurves to the local position parameters of all objects whose names begin with the letters "cone":

   AddFCurve "cone*/kine.local.pos" 

#

Used to reference types of objects:

SelectObj "*.#override" selects all overrides in the scene.

SelectObj "#model" selects all models in the scene.

SelectObj "*.#3dobject" selects all 3D objects in the scene.

SelectObj "*.#pass" selects all passes in the scene.

SelectObj "*.#group" selects all groups in the scene.

A collection can be used in place of a string to represent a object list. For example, both of the following LogMessage commands log a string that is a comma-separated list of object names. For example, if the objects "cone", "cube", and "sphere" are selected, then list is equivalent to the string "cube, cone, sphere":

   dim list
   set list = GetValue( "SelectionList" )

   LogMessage cstr(list)
   LogMessage list



Autodesk Softimage 2011