v1.0
selection
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" |