SIInstantiate

導入

v3.0

カテゴリ

edit

詳細

指定したモデルをインスタンス化します。 モデルをインスタンス化すると、その「レンダ インスタンス」が作成されます。 レンダ インスタンスはクローンとは異なり、ジオメトリを保存しません。 レンダ インスタンスは「マスタ」へのライトウェイト リファレンスであり、変換のみが変更されます。

スクリプト構文

oReturn = SIInstantiate( InputObjs, [NbItems], [Name] );

戻り値

インスタンスのリストを含むXSICollectionオブジェクトを戻します。

パラメータ

パラメータ タイプ 詳細
InputObjs 文字列 インスタンス化するオブジェクト

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

NbItems Long 作成するインスタンスの数。

デフォルト値: 1

Name 文字列 新しいインスタンスに使用する名前。

デフォルト値: ""

VBScript の例

'
' This example creates 4 render instances of the "Man" preset model
' and then moves them so that they are surrounding the original model.
'
' Add the "Man" preset model to the scene
set oMan = GetPresetModel( "Man", "Horatio", ActiveSceneRoot )
' Create 4 instantiations of the "Man" model. The command returns
' a collection of the new instantiations
set oWraiths = SIInstantiate( oMan, 4 )
' For each member of the collection, change its position so that the
' original master model is flanked by the render instances
Translate oWraiths(0), 5.0, 0.0, 5.0, siRelative, siView, siObj, siXYZ
Translate oWraiths(1), 5.0, 0.0, -5.0, siRelative, siView, siObj, siXYZ
Translate oWraiths(2), -5.0, 0.0, -5.0, siRelative, siView, siObj, siXYZ
Translate oWraiths(3), -5.0, 0.0, 5.0, siRelative, siView, siObj, siXYZ

関連項目

Instantiate