Obje ct 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 v7.5