GetPrim

カテゴリ

primitive

詳細

ロー プリミティブ(まっさらなプリミティブ)を作成します。 このコマンドは、ジオメトリ オブジェクトに対しインプリシット ジオメトリ オブジェクトを作成します。 また、カメラ、ライト、ヌル、コントロール オブジェクト、ラティス、ジオメトリ シェーダなど、他の種類のプリミティブを作成することも可能です。 作成されたプリミティブは選択されます。

GetPrim はプリミティブを作成します。 GetPrim という名前は、Softimage の Get-Primitive- メニューから取られています。.

注: このコマンドは、出力引数を使用します。 C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。 通常、出力引数は XSIApplication.ExecuteCommand メソッド(C#)または ISIVTCollection (スクリプト言語)を介して取得できますが、このコマンドはすでに値を返しています。

この場合の唯一の回避策は、出力引数と戻り値の両方を 1 つの配列で戻す VBScript のカスタム コマンドを作成することです。 詳細については、「関数がすでに値を戻している場合の処理について」を参照してください。

スクリプト構文

oReturn = GetPrim( PresetObj, [Name], [Parent], [Primitive] );

戻り値

プリミティブに対して作成された3Dオブジェクト(通常はX3DObjectオブジェクト)を戻します。

パラメータ

パラメータ タイプ 詳細
PresetObj 文字列 またはプリセット オブジェクト(「SIGetPreset」を参照) プリミティブ プリセットの名前。 サポートされているプリセット名のリストについては、「インプリシット プリミティブ」および「ジオメトリ プリミティブ」を参照してください。
Name 文字列 新しいプリミティブの名前
Parent 文字列 既存のオブジェクトの名前。新しいプリミティブの親として使用されます。
Primitive Primitive インプリシット プリミティブを戻します。

例

VBScript の例

'This example creates two primitives
newscene
dim preset, object, primitive
'Create an implicit sphere. Name it.
set object = GetPrim( "Sphere", "MySphere" , , primitive )
'Logged information:
'INFO : "Sphere information"
'INFO : "X3DObject, MySphere"
'INFO : "Primitive, Sphere"
LogMessage "Sphere information"
LogMessage TypeName( object ) & ", " & object.name
LogMessage TypeName( primitive ) & ", " & primitive.name
'Create an implicit cone. Name it and make it child of MySphere
set object = GetPrim( "Cone", "MyCone" ,"MySphere" , primitive )
'Logged information:
'INFO : "Cone information"
'INFO : "X3DObject, MyCone"
'INFO : "Primitive, Cone"
LogMessage "Cone information"
LogMessage TypeName( object ) & ", " & object.name
LogMessage TypeName( primitive ) & ", " & primitive.name
' Create primitive using preset selected by user (Will pop UI for selection)
set preset = SIGetPreset( "Primitives" )
set object = GetPrim( preset, , , primitive )
'Logged information, here we selected a square.
'INFO : "Your primitive's information"
'INFO : "X3DObject, square"
'INFO : "Primitive, Square"
LogMessage "Your primitive's information"
LogMessage TypeName( object ) & ", " & object.name
LogMessage TypeName( primitive ) & ", " & primitive.name

関連項目

CreatePrim SIGetPrim