SelectObj

導入

v1.0

詳細

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

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

スクリプト構文

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

パラメータ

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

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

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

デフォルト値: "ASITIS"

指定可能な値:

説明:

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

デフォルト値: 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 階層の扱い