インタフェース: SceneExplorerManager

インタフェース > コアインタフェース > SceneExplorerManager

SceneExplorerManager コアインタフェースは、MAXScript にシーンエクスプローラを公開します。

3ds Max 2008 以降 で使用可能です。

Interface: SceneExplorerManager

メソッド:

<boolean>SceneExplorerManager.CreateExplorerFromDefault <&TSTR>explorerName
explorerName is In parameter

3ds Max 2016 の新機能 : 指定された既定の設定を使用して新しいローカルのシーンエクスプローラを作成します。

成功した場合は True を返します。

失敗した場合は False を返します。たとえば指定された既定の設定が存在しない場合などです。

例:

SceneExplorerManager.CreateExplorerFromDefault "Test"
-->False
SceneExplorerManager.CreateExplorerFromDefault "Light Explorer"
-->True
-- A new Light Explorer will be created.

<boolean>SceneExplorerManager.IsExplorerInViewport <&TSTR>explorerName
explorerName is In parameter

3ds Max 2016 の新機能 : 指定されたシーンエクスプローラがビューポートに表示される場合は True を返します。

指定されたシーンエクスプローラがフローティングの場合、表示されない場合、または存在しない場合は False を返します。

<enum>SceneExplorerManager.ExplorerPersistenceType <&TSTR>explorerName
ExplorerPersistenceType enums: {#Global|#Local|#Workspace}
explorerName is In parameter

3ds Max 2016 の新機能 : 指定したシーンエクスプローラの持続性のタイプを返します。

有効な戻り値は次のとおりです。

#Global: シーンエクスプローラがグローバルであるか、エクスプローラ名が存在しません。

#Local: シーンエクスプローラは現在のシーンにローカルです。

#Workspace: シーンエクスプローラはワークスペースエクスプローラです。

<boolean>SceneExplorerManager.CreateADefaultExplorer <&String>explorerName   

explorerName is In parameter

既定値の設定を使用して、指定された名前の新しいシーンエクスプローラを作成します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<void>SceneExplorerManager.CreateExplorer <string>explorerName <value>visibleColumns

指定された名前で、2 番目の引数として渡されたプロパティ名の配列によって指定される可視列を持った新しいシーンエクスプローラを作成します。

3ds Max 2010 以降 で使用可能です。

<void>SceneExplorerManager.SetExplorerVisibleColumns <string>explorerName <value>visibleColumns

名前で指定されたシーンエクスプローラの列の可視性を、2 番目の引数で指定された可視列名の配列を使用して設定します。

名前が既存の列フィルタに一致しない場合、その列はスキップされエラーは発生しません。

3ds Max 2010 以降 で使用可能です。

例:

--This will createa default Explorer first, then set its
--columns to show Name, Type and Color only:
SceneExplorerManager.CreateADefaultExplorer "Object Colors"
SceneExplorerManager.SetExplorerVisibleColumns "Object Colors" #("Name","Type","Color")
 
--This will create only columns for Name, Type and Faces
--unless Bananas is a custom filter registered via MAXScript
SceneExplorerManager.CreateExplorer "Geometry Counts" #("Name","Type","Faces","Bananas")

<integer>SceneExplorerManager.GetExplorerCount()

シーンエクスプローラの数を返します。

<Interface>SceneExplorerManager.GetExplorer <string>explorerName

指定された名前を持つシーンエクスプローラが存在する場合、このシーンエクスプローラの MixinInterface:SceneExplorerInterface を返します。

指定された名前を持つシーンエクスプローラが存在しない場合は undefined を返します。

3ds Max 2015 以降で使用可能です。

<Stringby value>SceneExplorerManager.GetExplorerName <index>explorerIndex

インデックスで指定されたシーンステートの名前を返します。

インデックス引数の有効な値は、1 から SceneExplorerManager.GetExplorerCount() です。

<boolean>SceneExplorerManager.ExplorerExists <&String>explorerName

explorerName is In parameter

指定された名前を持つシーンエクスプローラが既に存在する場合は True、その名前のシーンエクスプローラがまだ作成されていない場合は False を返します。

<boolean>SceneExplorerManager.ExplorerIsOpen <&String>explorerName

explorerName is In parameter

指定された名前を持つシーンエクスプローラが開いている場合は True、開いていない場合は False を返します。

<boolean>SceneExplorerManager.OpenExplorer <&String>explorerName

explorerName is In parameter

指定された名前のシーンエクスプローラを開きます。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean>SceneExplorerManager.CloseExplorer <&String>explorerName

explorerNameis In parameter

指定された名前のシーンエクスプローラを閉じます。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean>SceneExplorerManager.ClearAllExplorers()

すべてのシーンエクスプローラを閉じ、[ツール](Tools) > [保存されたシーンエクスプローラ](Saved Scene Explorers)メニューリストをクリアします。

3ds Max 2010 以降では、成功した場合は True を返し、成功しなかった場合は False を返します。

<point2 by value>SceneExplorerManager.GetExplorerPosition <&String>explorerName

explorerName is In parameter

名前で指定されたシーンエクスプローラの、デスクトップの左上コーナーからの相対位置を、Point2 値として返します。

<boolean>SceneExplorerManager.SetExplorerPosition <&String>explorerName <point2 by value>position

explorerName is In parameter

名前で指定されたシーンエクスプローラの、デスクトップの左上コーナーからの相対位置を、指定された Point2 値に設定します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<point2 by value>SceneExplorerManager.GetExplorerSize <&String>explorerName

explorerName is In parameter

名前で指定されたシーンエクスプローラのサイズを Point2 値で返します。

<boolean>SceneExplorerManager.SetExplorerSize <&String>explorerName <point2 by value>size

explorerName is In parameter

名前で指定されたシーンエクスプローラのサイズを指定された Point2 値に設定します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean>SceneExplorerManager.ConfigureExplorer <&String>explorerName <&String>configurationFile 

explorerName is In parameter 
configurationFile is In parameter

名前で指定されたシーンエクスプローラを 2 番目の引数で指定された設定ファイルを使用して設定します。

成功した場合は True を返し、成功しなかった場合は False を返します。

シーンエクスプローラマネージャ

<void>SceneExplorerManager.OpenManageInstancesDialog()

[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスを開きます。

<void>SceneExplorerManager.CloseManageInstancesDialog()

[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスを閉じます。

<boolean>SceneExplorerManager.LoadExplorerConfiguration <&String>configurationFile

configurationFile is In parameter

以前に保存されたシーンエクスプローラ設定を、指定された設定ファイルからロードします。

[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスの[ロード](Load)ボタンを押して、ロードするファイルを選択する操作に相当します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean>SceneExplorerManager.SaveExplorerConfiguration <&String>explorerName <&String>outputConfigurationFile

explorerName is In parameter 
outputConfigurationFile is In parameter

指定されたシーンエクスプローラの設定を 2 番目の引数で指定された設定ファイルに保存します。

指定されているシーンエクスプローラが選択された状態で[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスの[保存](Save)ボタンを押し、保存先のファイルを指定する操作に相当します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean> SceneExplorerManager.DeleteExplorer <&String>explorerName 

explorerName is In parameter

指定された名前のシーンエクスプローラを削除します。

指定されているシーンエクスプローラが選択された状態で、[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスの[削除](Delete)ボタンを押す操作に相当します。

成功した場合は True を返し、成功しなかった場合は False を返します。

<boolean>SceneExplorerManager.RenameExplorer <&String>oldExplorerName <&String>newExplorerName 

oldExplorerName is In parameter 
newExplorerName is In parameter

1 番目の引数で指定された名前のシーンエクスプローラの名前を 2 番目の引数で指定された名前に変更します。

指定されたシーンエクスプローラが選択された状態で[シーンエクスプローラをマネージ](Manage Scene Explorer)ダイアログボックスの[名前変更](Rename)ボタンを押し、新しい名前を入力する操作に相当します。

成功した場合は True を返し、成功しなかった場合は False を返します。

カスタムプロパティフィルタの追加

<value>SceneExplorerManager.AddProperty <string>propertyName <value>getFunction <value>setFunction

シーンエクスプローラに列として表示する新しいプロパティフィルタを追加します。

1 番目の引数は、追加するプロパティの名前です。

2 番目の引数は、プロパティの値を取得するために呼び出す関数です。

3 番目の引数は、プロパティの値を設定するために呼び出す関数です。

定義が終了すると、プロパティフィルタは[カラム選択機能](Column Chooser)の末尾に表示されるようになります。

<void>SceneExplorerManager.AddLocalizableProperty <string>propertyName <string>displayName <value>getFunction <value>setFunction

シーンエクスプローラに列として表示する新しいプロパティフィルタを追加します。

このメソッドは、上の SceneExplorerManager.AddProperty メソッドに似ていますが、シーンエクスプローラに表示する代替の表示名を定義する displayName 引数を持つ点が異なります。これは、ローカリゼーションの目的に役立ちます。

3ds Max 2010 以降 で使用可能です。

<value>SceneExplorerManager.AddReadOnlyProperty <string>propertyName <value>getFunction

シーンエクスプローラに表示する新しい読み取り専用プロパティフィルタを追加します。

1 番目の引数はプロパティの名前です。

2 番目の引数は、プロパティの値を取得するために呼び出す関数です。

定義が終了すると、プロパティフィルタは[カラム選択機能](Column Chooser)の末尾に表示されるようになります。

<void>SceneExplorerManager.AddLocalizableReadOnlyProperty <string>propertyName <string>displayName <value>getFunction

シーンエクスプローラに列として表示する新しい読み込み専用のプロパティフィルタを追加します。

このメソッドは、上の SceneExplorerManager.AddReadOnlyProperty メソッドに似ていますが、シーンエクスプローラに表示する代替の表示名を定義する displayName 引数を持つ点が異なります。これは、ローカリゼーションの目的に役立ちます。

3ds Max 2010 以降 で使用可能です。

<value>SceneExplorerManager.RemoveProperty <string>propertyName

指定されたプロパティ名で以前に追加されたプロパティを削除します。

使用例:

--Define a getter function which returns the radius property
--if it exists or implicitly undefined when no such property
fn getRad theNode = (
if isProperty theNode "Radius" then theNode.Radius )
 
--Define asetter function which sets the radius property
--if it exists otherwise does nothing
fn setRad theNode theValue = (
if isProperty theNode "Radius" then theNode.Radius = theValue)
 
--Add a Property filter to the Scene Explorer Manager with the name
--"Radius" and the two functions as second and third argument
SceneExplorerManager.addProperty "Radius" getRad setRad
 
--Define a getter function which returns the class of the node
fn getClass theNode = (classof theNode)
--Add aRead-OnlyProperty filter to the Scene Explorer Manager
--which can only get properties but cannot set them
SceneExplorerManager.addReadOnlyProperty "Class" getClass

評価すると、[カラム選択機能](Column Chooser)ダイアログボックスの末尾に新しいプロパティが表示されます。

新しい列をシーンエクスプローラにドラッグすると、すべてのシーンノードのクラスと、.radius プロパティを持つシーンノードの半径の値が表示されます。

これらの追加プロパティを、今後も 3ds Max セッションのシーンエクスプローラで使用できるようにするには、カスタムプロパティフィルタ定義を Scripts¥Startup フォルダのスクリプトファイルに保存します。

インタフェース: SceneExplorerInterface

この MixinInterface は SceneExplorerManager.GetExplorer() メソッドによって返され、単一の名前で指定されたシーンエクスプローラのプロパティとメソッドを公開します。

3ds Max 2015 以降で使用可能です。

プロパティ:

.Name : string : Read|Write

シーンエクスプローラの名前を取得/設定します。

メソッド:

<fpvalue by value array>SelectedItems()

選択された項目によって表されるオブジェクトの配列を返します。

<void>CollapseAll()

すべての項目の子サブツリー表示を折りたたみます。

<void>CollapseSelected()

選択された項目の子サブツリー表示を折りたたみます。

<void>ExpandAll()

すべての項目の子サブツリー表示を展開します。

<void>ExpandSelected()

選択された項目の子サブツリー表示を展開します。

<void>InvertDisplay()

すべての表示フィルタの状態を反転します。

<void>Rename()

選択された項目を名前変更モードに切り替えます。

複数の項目が選択されている場合、最後に選択された項目を名前変更モードにします。

このメソッドを正常に実行するには、シーンエクスプローラを開いておく必要があります。

<void>Unlink()

選択された子オブジェクトのリンクをその親オブジェクトから解除します。

<void>SelectChildren()

親の選択を保持したまま、選択された項目の子を選択します。

<void>FocusAndRename <maxObject>layer

指定されたシーンオブジェクトを表す項目を選択して、名前変更モードにします。

オブジェクトが存在しない場合は何も行いません。

関連項目

コアインタフェース:

インタフェース: SceneExplorerManager

シーン エクスプローラ マネージャ

カスタム プロパティ フィルタの追加

インタフェース: SceneExplorerInterface

シーンエクスプローラマネージャ

カスタムプロパティフィルタの追加