Attribute Name

Description

Supports

allownodeexpansion

This attribute controls whether you can expand the nodes in the explorer by providing a + (plus) sign (therefore making them expandable).

See the View.BeginEdit method for an example using this attribute.

Possible Values:

• 'true' (Default) Nodes are expandable (plus signs appear). Note: Use the string "true", not the binary true.

• 'false' Nodes are not expandable (no plus signs). Note: Use the string "false", not the binary false.

• Get

• Set

scope

The currently displayed scope.

See the View.SetAttributeValue, View.BeginEdit and View.GetAttributeValue methods for an example using this attribute.

Possible Values:

• Project Project (Application) scope.

• Preferences Preferences scope.

• Scene (Default) Scene (Scene root) scope.

• Layers Layers scope.

• Passes Passes scope.

• Environments Environments scope.

• Particle Types Particle Types (ParTypes) scope.

• Selection Selection scope.

• Custom Custom scope.

• Current Layer Current Layer scope.

• Current Pass Current Pass scope.

• Current Environment Current Environment scope.

• Current Particle Type Current Particle Type scope.

• Sources and Clips Sources and Clips (combined) scope.

• Animation Sources Animation sources scope.

• Audio Sources and Clips Audio sources and clips scope.

• Image Sources and Clips Image sources and clips scope.

• Material Sources Material sources scope.

• Commands Commands scope.

• Get

• Set

localselection

Determines whether the explorer maintains its own local selection. If this option is on, elements selected in the explorer do not affect the global selection in the scene. Locally selected elements are highlighted in pale blue rather than white.

Possible Values:

• 'false' (Default) Selected elements affect the global selection in the scene. Note: Use the string "false", not the binary false.

• 'true' Selected elements do not affect the global selection in the scene. Note: Use the string "true", not the binary true.

• Get

• Set

targetcontent

The node(s) to display in the Explorer. This attribute is only available when the scope is set to either "Selection" or "Custom".

Possible Values:

• <node name> The object name or parameter name to focus on.

• Set

select

The node(s) to select (either global or local selection) in the Explorer.

Possible Values:

• <node name> The object name or parameter name to select.

• Set

supportmarking

Determines whether the explorer will mark or select parameter nodes. If this option is on, parameter nodes selected in the explorer are "marked" rather than selected. Marked elements are highlighted in yellow rather than white.

Possible Values:

• 'true' (Default) Selected parameter nodes are marked rather than selected.

• 'false' Parameter nodes will be selected.

Note: Use the strings "true" and "false", not the binary true and false.

• Get

• Set

scriptnames

Determines whether the explorer will use the script name instead of regular name for node labels.

See the View.BeginEdit method for an example using this attribute.

Possible Values:

• 'false' (Default) Node labels will use the regular name.

• 'true' Node labels will use the script name.

Note: Use the strings "true" and "false", not the binary true and false.

• Get

• Set

flattenstate

Controls how the hierarchy is compacted initially.

Possible Values:

• 'None' None of the hierarchy is compacted.

• 'Parameters' Compacts hierarchy display by removing intermediate nodes and renaming the nodes at the ends of branches. For example, the Global Transform > Pos > X node is shortened to Global Transform > Pos.X.

• 'All' Compacts hierarchy display by removing intermediate nodes (properties, primitives, materials, and so on) and displaying parameters in a flat list. For example, the Global Transform > Pos > X node is shortened to Global Transform.Pos.X

• Get

• Set

generalsort

Sorts objects, sources, clips, and other basic elements.

Possible Values:

• 'None' Uses the default order, based on when an element was created or parented.

• 'Alphabetical' Sorts the elements alphabetically. Any numeric suffix is sorted in correct numerical order, so Object2 comes before Object10. The children of an object are always listed after any parameter sets of the object.

• 'Used + Alphabetical' Sorts the elements into used and unused groups, and then sorts alphabetically within each group. This option is available only with the Sources/Clips scopes.

• 'Type + Alphabetical' Sorts the elements by type first, and then alphabetically within each type. The types depend on the scope. For example with the Scene Root scope, the explorer lists all the cameras in alphabetical order, then all the lights, models, referenced models, nulls, chains, curves, polygon meshes, NURBS surfaces, text, particle clouds, hair objects, control objects, forces, dynamic constraints, implicits, and geoshaders, each in alphabetical order. If the scope contains only one type of element, this option is equivalent to Alphabetical.

• Get

• Set

parametersort

Sorts parameters according to various criteria.

Possible Values:

• 'None' Uses the default order, based on when an element was created or parented.

• 'Alphabetical' Sorts the parameters alphabetically. Any numeric suffix is sorted in correct numerical order, so Param2 comes before Param10.

• 'Layout' Uses the order in which the parameters appear in their property editor. If a parameter does not appear in the corresponding property editor, it is not listed.

• Get

• Set

FilterMask

Determines which types of nodes are displayed in the explorer. This is the scripting equivalent of changing the selection in the Filter menu. This is a kind of a string mask, so to set the value, you can pass a pipe-delimited ('|') list of options or specify a single value from the siSEFilterMask enum. For example:

// Show only animated nodes
myView.SetAttribute("FilterMask", siSEFilterAnimatedNodes); 

// Show objects, models and groups
myView.SetAttribute("FilterMask", "Group|Object|Model");

• Get

• Set