Softimage SDK Programmer's Guide > Script Development > Accessing Scene Elements > String Expressions >

# 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