SelectObj
v1.0
Selects objects, property sets, and other elements using the
selection mode specified in the HierarchyLevel parameter.
Note: This command resets the Selection to only those items
specified in the SelectionList parameter. If you want to modify the
selection, use AddToSelection or
RemoveFromSelection.
SelectObj( [SelectionList], [HierarchyLevel], [CheckObjectSelectability] ); |
| Parameter | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SelectionList | String | List of elements to select.
Default Value: Current selection |
||||||||||||
| HierarchyLevel | String | Specifies how to select objects in a hierarchy.
Default Value: "ASITIS"
|
||||||||||||
| CheckObjectSelectability | Boolean | Specifies whether to select objects that marked as
unselectable.
Default Value: False
|
' Create objects for demonstration
NewScene , false
set cube = CreatePrim("Cube", "MeshSurface")
SelectObj "cube.poly[4]", , True
CreateCluster
ApplyShader
BlendInPresetsInsp , , , True, True
set cube1 = CreatePrim( "Cube", "MeshSurface",,cube )
Translate cube1, -2, 0.000, 0.000, siAbsolute, siParent, siObj, siXYZ
set cube2 = CreatePrim("Cube", "MeshSurface",,cube1 )
Translate cube2, -2, 0.000, 0.000, siAbsolute, siParent, siObj, siXYZ
set cube3 = CreatePrim( "Cube", "MeshSurface",,cube2 )
Translate cube3, -2, 0.000, 0.000, siAbsolute, siParent, siObj, siXYZ
CreateGroup
' Select the objects named "cube" and "cube1"
SelectObj "cube,cube1"
Application.LogMessage "select objects by name: " & Selection.GetAsText
' Select all models in the scene.
SelectObj "#model"
Application.LogMessage "select all models: " & Selection.GetAsText
' Select all 3D objects in the scene.
SelectObj "*#3dobject"
Application.LogMessage "select all objects: " & Selection.GetAsText
' Select all passes in the scene.
SelectObj "*.#pass"
Application.LogMessage "select all passes: " & Selection.GetAsText
' Select all groups in the scene.
SelectObj "#group"
Application.LogMessage "select all groups: " & Selection.GetAsText
' Select all materials
SelectObj "*.material"
Application.LogMessage "select all materials: " & Selection.GetAsText
' Select all polygon cluster material
SelectObj "*.polymsh.cls.Polygon.Material"
Application.LogMessage "select all polygon cluster materials: " & Selection.GetAsText
'***************************************************************************
' To process the selection list, use the Selection object
SelectObj "*.material"
Application.LogMessage "select all local object materials: " & Selection.GetAsText
'***************************************************************************
' When you branch, tree, or model select, only one object
' appears in the SelectionList. For example, given this
' hierarchy:
' cube > cube1 > cube2 > cube3
'
' Selecting in branch gives these results:
' - cube1 is selected (white highlight)
' - cube2 and cube3 have light grey highlight
' - cube1 is the only item in the selection list
SelectObj "cube1", "BRANCH"
Application.LogMessage "select cube1 in branch: " & Selection.GetAsText
'INFO : "select objects by name: cube,cube1"
'INFO : "select all models: Scene_Root"
'INFO : "select all objects: Camera,Camera_Interest,Camera_Root,cube,cube1,cube2,cube3,light"
'INFO : "select all passes: Passes.Default_Pass"
'INFO : "select all groups: Group"
'INFO : "select all materials: Camera.Scene_Material"
'INFO : "select all polygon cluster materials: cube.polymsh.cls.Polygon.Material"
'INFO : "select all local object materials: Camera.Scene_Material"
'INFO : "select cube1 in branch: cube1"
|
Selection AddToSelection RemoveFromSelection SelectBranch SelectTree SelectModel Dealing with Hierarchy