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