Introduced
1.0
Description
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.
Scripting Syntax
SelectObj( [SelectionList], [HierarchyLevel], [CheckObjectSelectability] )
Parameters
|
Parameter |
Type |
Description |
|
SelectionList |
List of elements to select. Default Value: Current selection |
|
|
HierarchyLevel |
Specifies how to select objects in a hierarchy. Default Value: "ASITIS" Possible Values: • ASITIS: Select the object as it is. • NODE: Select the object. • BRANCH: Select the object and its children. • TREE: Select the entire hierarchy of objects. • MODEL: Select the model and the hierarchy of objects. |
|
|
CheckObjectSelectability |
Specifies whether to select objects that marked as unselectable. Default Value: False Possible Values: • False: Select objects even if they are marked as unselectable. • True: Do not select objects if they are marked as unselectable. |
Examples
VBScript Example
' 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"
See Also
|
|
Autodesk Softimage v7.5