SelectObj

導入

v1.0

カテゴリ

選択

詳細

HierarchyLevel パラメータで指定された選択モードを使用して、オブジェクト、プロパティ セット、および他のエレメントを選択します。

注: このコマンドは、SelectionList パラメータで指定された項目に対してのみ、選択をリセットします。 選択対象を修正する場合は、AddToSelectionまたはRemoveFromSelectionを使用します。

スクリプト構文

SelectObj( [SelectionList], [HierarchyLevel], [CheckObjectSelectability] );

パラメータ

パラメータ タイプ 詳細
SelectionList 文字列 選択するエレメントのリスト

デフォルト値: 現在選択されている値

HierarchyLevel 文字列 階層のオブジェクトを選択する方法を指定します。

デフォルト値: "ASITIS"

指定可能な値:

説明:

ASITIS オブジェクトをそのまま選択します。
NODE オブジェクトを選択します。
BRANCH オブジェクトとその子を選択します。
TREE オブジェクトの階層全体を選択します。
MODEL オブジェクトのモデルと階層を選択します。
CheckObjectSelectability ブール 選択不可としてマーキングされたオブジェクトを選択するかどうかを指定します。

デフォルト値: False

指定可能な値:

説明:

False 選択不可としてマーキングされたオブジェクトも選択します。
True 選択不可としてマーキングされたオブジェクトは選択しません。

VBScript の例

' 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 階層の扱い