ReorderSceneItem
 
 
 

ReorderSceneItem

Introduced

v7.0

Description

Moves a scene item (such as object, model group or cluster) to a different position in its parent's list of children. You can move the input object directly to the first or last position, or you can pick a specific point by designating a sibling as a reference object and indicating whether the input object should be moved before or after the reference object in the list.

A sibling is another scene item on the same hierarchical level: an immediate child of the input object's parent.

Scripting Syntax

ReorderSceneItem( Parent, InputObj, MoveAction, [Marker] );

Parameters

Parameter Type Description
Parent String Specifies the parent item under which you are modifying the position of a child item.
InputObj String Specifies the scene item to be reordered.
MoveAction Integer Specifies where the scene item will be moved: first child, before/after the reference item, or last child.

Default Value: 0

Possible Values:

Description:

0 Move to become the first child.
1 Move just before the marker item.
2 Move just after the marker item.
3 Move to become the last child.
Marker String Specifies the marker item. This parameter is ignored if MoveAction=0 or 3.

Examples

JScript Example

//
// This JScript example creates several objects and then changes
// their child order using several of the ReorderSceneItem options.
//
NewScene(null, false);
GetPrim("Null");
NullMarker = GetPrim("Null");
GetPrim("Null");
GetPrim("Null");
NullToMove = GetPrim("Null");
// If you open the Explorer and change the "General Sort" option to "None (creation)"
// you'll see that we have null, null1, null2, null3, null4.
// Move "null4" after "null1".
ReorderSceneItem("Scene_Root", NullToMove, 2, NullMarker);
// Now make "null4" the first child.
ReorderSceneItem("Scene_Root", NullToMove, 0);

See Also

MoveOperator MoveOperatorBefore MoveOperatorAfter