CreateModel

カテゴリ

ファイル

詳細

Scene に新しい Model を作成します。 新しいモデルに含まれるオブジェクト(他のモデルを含む)を特別に指定しない限り(InputObj パラメータを介して)、現在選択されているオブジェクトすべてが、作成されたノードの子になります。

新しいモデルの親になるノードを指定することもできます(InputObj パラメータを介して)。

このコマンドは、[モデル]ツールバーから[作成] > [モデル] > [新規モデル]を選択する操作と同等のスクリプトです。 このコマンドは、構文と動作が SICreateModel コマンドと似ていますが、新しいモデルを選択する点が異なります。

注: このコマンドは、出力引数を使用します。 C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。 ExecuteCommand は、出力引数を C# の System.Object (出力引数の配列を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

CreateModel( [InputObj], [Name], [Parent], [Value] );

パラメータ

パラメータ タイプ 詳細
InputObj 文字列 再び新しいモデルの子となるオブジェクト(他のモデルを含む)のリスト

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

Name 文字列 モデル名
Parent 文字列 新しいモデルの親として使用するオブジェクトまたはモデル
Model モデルを戻します。

VBScript の例

'---------------------------------------------------------
' This example demonstrates how to use the CreateModel 
' command.
'---------------------------------------------------------
NewScene , false
' First create a node off of the scene root.
dim Root_NodeObj
CreateModel , "Root_Node", , Root_NodeObj
Application.LogMessage "Created " & Root_NodeObj
DeselectAll
' Now create a sub-node, and make it the child of a new node. Notice that since 
' "Sub-node" is selected when "Another_Root" is created, it becomes a child.
dim Sub_NodeObj, Another_RootObj
CreateModel , "Sub-node", , Sub_NodeObj
Application.LogMessage "Created " & Sub_NodeObj
SelectObj "Sub-node"
CreateModel , "Another_Root", , Another_RootObj
Application.LogMessage "Created " & Another_RootObj
DeselectAll
' Now make another node, with parent "Another_Root", and child "Root_Node".
' Notice that now, "Another_Root" is the only top-level model, with children
' "Mid_Root" and "Sub-node", and "Mid_Root" has child "Root_Node"
dim Mid_RootObj
CreateModel "Root_Node", "Mid_Root", "Another_Root", Mid_RootObj
Application.LogMessage "Created " & Mid_RootObj
DeselectAll
'---------------------------------------------------------
' Output from this script:
'---------------------------------------------------------
'INFO : Created Root_Node
'INFO : Created Sub-node
'INFO : Created Another_Root
'INFO : Created Mid_Root

関連項目

SICreateModel