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