インタフェース: nvpx
 
 
 

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

 

   

ダイナミクス - クイック ナビゲーション

   

コア インタフェース - クイック ナビゲーション

3ds Max 2012 の新機能: nvpx コア インタフェースは、nVidia PhysX テクノロジに基づく MassFX 物理的シミュレーション システムを MAXScript に対して公開します。

トピック ナビゲーション  

シーン書き出し

ワールドの設定

シミュレーション

ボディとコンストレイント

リジット ボディのコピーと貼り付け

リジット ボディ メッシュのアクセス

ノードの物理プロパティ

物理的マテリアルのロードと保存

物理的マテリアルのアクセス

バウンディング ジオメトリの作成

スリープ アクター

パラメータの取得/設定

コンタクト レポート

スキン アクセス

ボーン メソッド

ラグドール アクセス

Biped 統合

Physique 統合

ユーティリティ関数

間接的ドラッグ メソッド

ビジュアライザー メソッド

PhysX システム

プロファイラ メソッド

マルチ スレッディングとハードウェア アクセラレーション

UnitTest メソッド

   

 Interface: nvpx

プロパティ:

プロパティは公開されていません。

シーン書き出し

メソッド:

<integer>nvpx.ExportPhysXScene <string>filename <string>extension

2 番目の引数で指定されたファイル形式を使用して、シーン シミュレーション データを外部ファイルに書き出します。成功した場合は 0 を、失敗した場合は -1 を返します。

有効な拡張子の値は次のとおりです。

「xml」 - 既定の XML ファイルを作成します。

「nxb」 - NxuStream BINARY ファイルを作成します。

「dae」 - COLLADA XML ファイルを作成します。

他の拡張子の値を指定すると MAXScript リスナーに警告が出力され、書き出しでは XML ファイル形式が使用されます。

filename 引数で使用される実際のファイル拡張子はファイル タイプと一致する必要がないため、たとえば「collada.xml」という名前のファイルを「dae」という extension 引数を使用して保存できます。

nvpx.ExportPhysXScene "c:\\temp\\physxtest.xml" "xml"
--> 0
nvpx.ExportPhysXScene "c:\\temp\\physxtest.nxb" "nxb"
--> 0
nvpx.ExportPhysXScene "c:\\temp\\physxtest.dae" "dae"
--> 0
nvpx.ExportPhysXScene "c:\\temp\\physxtest.abc" "abc"
--> SDK does not support exporting format, abc. It will be exported with default format.
--> 0

   

ワールドの設定

メソッド:

<point3 by value>nvpx.GetGravity()

重力ベクトルを標準単位/秒の二乗で表された Point3 値として返します。システム単位が 1GU = 1 インチに設定されている場合、重力の既定値は[0,0,-386.221]で、これは[0,0,-9.81]メートル/秒の二乗に相当します(地球の加速度)。

<integer>nvpx.SetGravity <point3 byvalue>gravity

重力ベクトルを指定された Point3 値に設定します。

   

<float>nvpx.GetGeometryScale()

ジオメトリ スケール係数を返します。既定値は 1.0 です。

<float>nvpx.SetGeometryScale <float>scaleRate

ジオメトリ スケール係数を Float 引数に設定します。

   

<boolean>nvpx.CreateGround <float>position <&point3>normal

normal is In and Out parameter

position 引数によって指定され、2 番目の引数によって指定された normal ベクトルに合わせて方向を設定した Z の高さにグラウンド平面を作成します。

シミュレーションで使用できるグラウンド平面は 1 つだけです。

   

<boolean>nvpx.RemoveGround()

シミュレーションからグラウンド平面を削除します。

   

<boolean>nvpx.ReadSystemUnit <integer>type <float>scale

   

<float>nvpx.GetMeterToSystemUnit()

メートルと現在のシステム単位の間のスケール係数を返します。システム単位が 1GU = 1 インチに設定されている場合、値は 1 メートルのインチ数である 39.3701 になります。

<float>nvpx.SetMeterToSystemUnit <float>newValue

メートルとシステム単位の間のスケール係数をユーザ値に設定し、新しいワールド スケールを定義します。

   

<void>nvpx.SetCCDMotionThreshold <float>ccdMotionThreshold

持続衝突検出モーションのスレッショルド値を、指定された浮動小数点値パラメータに設定します。

   

<integer>nvpx.GetSolverIterations()

ソルバの反復回数を返します。

<integer>nvpx.SetSolverIterations <integer>count

ソルバの反復回数を integer 引数に設定します。新しい値を返します。

   

[シミュレーション]

メソッド:

<integer>nvpx.Simulate <float>deltat

指定された時間ステップを使用してシミュレーションを開始します。

   

<boolean>nvpx.IsSimulating()

シミュレーションが現在実行中の場合は true を返し、実行中でない場合は false を返します。

   

<integer>nvpx.SetSimulationSubSteps <integer>numSteps

シミュレーションのサブステップを指定された値に設定します。

   

<integer>nvpx.SimulationReset()

シミュレーションをリセットします。

   

<void>nvpx.SetSimulationState <boolean>simulating

実際のシミュレーションを実行しないで、シミュレーションの状態を指定された boolean 引数に設定します。引数が true の場合、 nvpx.IsSimulating() は true を返します。

   

ボディとコンストレイント

メソッド:

<integer>nvpx.AddRigidbody <node>inode

引数として渡されたノードを、リジット ボディとしてシミュレーションに追加します。成功した場合は 1 を、失敗した場合は 0 を返します。失敗した場合は、メッセージも MAXScript リスナーに出力されます。

<integer>nvpx.RemoveRigidbody <node>inode

指定されたノードからリジット ボディ データを削除します。

<integer>nvpx.RemoveAll()

すべてのシーン ノードからリジット ボディ データを削除します。

   

<integer>nvpx.AddConstraint <node>node

コンストレイントを指定されたノードに追加します。

   

<integer>nvpx.AddDistanceJoint <node>node

距離接続を指定されたノードに追加します。

   

<integer>nvpx.SetRigidbodyShapeFlag <node>inode <TSTR by value>flagname <boolean>value

1 番目の引数で指定されたノード内にある、2 番目の引数で指定された名前のリジット ボディ シェイプ フラグを、3 番目の引数として渡されたブール値に設定します。

   

<boolean>nvpx.RBBroken <node>inode

指定されたノードのリジット ボディが壊れている場合は true を返し、それ以外の場合は false を返します。

   

<integer>nvpx.ClearInvalidNodes()

無効なノードをクリアします。

   

<integer>nvpx.PrintNodeParams <node>inode

指定されたノードについての詳細情報を出力します。

nvpx.PrintNodeParams  $Teapot001
 print Node param blocks:
totally 0 Param Blocks
 print modifier param blocks:
totally 1 Param Blocks
 PBlock version 9, local name: ??, flag: 0x226, 60 Params
  Param 0 (type): TYPE_INT, flag: 0x920020, value: 1
  Param 54 (switchType): TYPE_BOOL, flag: 0x820020, value: false
  Param 55 (switchTypeAtFrame): TYPE_INT, flag: 0x920020, value: 0
  Param 35 (EnableGravity): TYPE_BOOL, flag: 0x820020, value: true
  Param 53 (ContinuousCollisionDetection): TYPE_BOOL, flag: 0x820020, value: false
  Param 36 (SleepAtStart): TYPE_BOOL, flag: 0x820020, value: false
  Param 52 (CollideWithRigidBodies): TYPE_BOOL, flag: 0x820020, value: true
  Param 1 (): TYPE_INODE, flag: 0x810000, value: 0x0
  Param 2 (extraShapes): TYPE_STRING, flag: 0x800000, value: "(null)"
  Param 3 (manualSetup): TYPE_BOOL, flag: 0x820020, value: true
  Param 4 (materialId): TYPE_INT, flag: 0x820020, value: 0
  Param 6 (density): TYPE_FLOAT, flag: 0x820020, value: 0
  Param 5 (volume): TYPE_FLOAT, flag: 0x820020, value: 0
  Param 7 (mass): TYPE_FLOAT, flag: 0x820020, value: 0
  Param 8 (staticFriction): TYPE_FLOAT, flag: 0x820020, value: 1073741824
  Param 9 (dynamicFriction): TYPE_FLOAT, flag: 0x820020, value: 1073741824
  Param 10 (bounciness): TYPE_FLOAT, flag: 0x820020, value: 0
  Param 62 (EnableAdvancedSettings): TYPE_INT, flag: 0x820020, value: 0
  Param 56 (SkinWidth): TYPE_BOOL, flag: 0x820020, value: false
  Param 57 (SkinWidthValue): TYPE_FLOAT, flag: 0x20020, value: 0
  Param 58 (SolverIter): TYPE_BOOL, flag: 0x820020, value: false
  Param 59 (SolverIterValue): TYPE_INT, flag: 0x120020, value: 4
  Param 61 (InitialMotionStyle): TYPE_INT, flag: 0x820020, value: 1
  Param 39 (InitialVelocityX): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 40 (InitialVelocityY): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 41 (InitialVelocityZ): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 37 (velocitySpeed): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 42 (InitialSpinX): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 43 (InitialSpinY): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 44 (InitialSpinZ): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 38 (spinSpeed): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 45 (MassCenterX): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 46 (MassCenterY): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 47 (MassCenterZ): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 50 (LinearDamping): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 51 (AngularDamping): TYPE_FLOAT, flag: 0x920020, value: -2147483648
  Param 49 (baked): TYPE_BOOL, flag: 0x820020, value: false
  Param 14 (): TYPE_INT, flag: 0x820020, value: 0
  Param 15 (): TYPE_BOOL, flag: 0x820020, value: false
  Param 16 (): TYPE_BOOL, flag: 0x820020, value: false
  Param 17 (): TYPE_BOOL, flag: 0x820020, value: false
  Param 13 (meshType): TYPE_INT, flag: 0x920020, value: 4
  Param 28 (meshCustomMesh): TYPE_INODE, flag: 0x810000, value: 0x0
  Param 26 (meshVerticesLimit): TYPE_INT, flag: 0x820020, value: 32
  Param 27 (meshInflation): TYPE_FLOAT, flag: 0x820020, value: 0
  Param 60 (meshConvexStyle): TYPE_INT, flag: 0x820020, value: 0
  Param 31 (meshRadius): TYPE_FLOAT, flag: 0x920020, value: -2147483648
  Param 32 (meshLength): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 33 (meshWidth): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 34 (meshHeight): TYPE_FLOAT, flag: 0x920020, value: 0
  Param 29 (): TYPE_BOOL, flag: 0x40800000, value: false
  Param 30 (): TYPE_BOOL, flag: 0x820020, value: false
  Param 18 (meshOverrideMaterial): TYPE_BOOL, flag: 0x820020, value: false
  Param 19 (meshDensity): TYPE_FLOAT, flag: 0x40800000, value: 0
  Param 20 (meshMass): TYPE_FLOAT, flag: 0x40800000, value: 0
  Param 21 (meshStaticFriction): TYPE_FLOAT, flag: 0x40800000, value: 0
  Param 22 (meshDynamicFriction): TYPE_FLOAT, flag: 0x40800000, value: 0
  Param 23 (meshBounciness): TYPE_FLOAT, flag: 0x40800000, value: 0
  Param 24 (): TYPE_BOOL, flag: 0x40800000, value: false
  Param 25 (): TYPE_BOOL, flag: 0x40800000, value: false

Animatable[2] : Transform, classID = (2005, 0)
	Animatable[0]: Position, classID = (118f7e02, ffee238a)
	Animatable[1]: Rotation, classID = (2012, 0)
Animatable[3] : Modified Object, classID = (3, 0)
	Animatable[0]: MassFX Rigid Body, classID = (a750e, 6e6ba)
		Animatable[0]: no name, classID = (2005, 0)
			Animatable[0]: Position, classID = (118f7e02, ffee238a)
			Animatable[1]: Rotation, classID = (2012, 0)
		Animatable[1]: no name, classID = (2005, 0)
			Animatable[0]: Position, classID = (118f7e02, ffee238a)
			Animatable[1]: Rotation, classID = (2012, 0)
		Animatable[2]: no name, classID = (118f7e02, ffee238a)
		Animatable[3]: no name, classID = (2005, 0)
			Animatable[0]: Position, classID = (118f7e02, ffee238a)
			Animatable[1]: Rotation, classID = (2012, 0)
	Animatable[1]: Teapot (Object), classID = (acad13d3, acad26d9)
		Animatable[0]: Parameters, classID = (8, 0)
0

   

<boolean>nvpx.SetAsDynamic <node>inode <boolean>onoff

2 番目の引数として true が渡された場合は、1 番目の引数で渡されたノードをダイナミック リジット ボディに設定し、2 番目の引数が false の場合は、静止リジット ボディに設定します。

   

<integer>nvpx.PrintTM <node>inode

指定されたノードのさまざまな変換行列についての詳細情報を出力します。

nvpx.PrintTM $Teapot001
PivotTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [0.000000, 0.000000, 0.000000])
nodeTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [1.576996, -11.519989, 0.000000])
parentTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [0.000000, 0.000000, 0.000000])
objectTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [1.576996, -11.519989, 0.000000])
--pivot = [0.000000, 0.000000, 0.000000]
--nodeObjectTM <==> PhysicsNodeTM == PhysicsNodeScaleTM * PhysicsNodePivotTM * PhysicsNodePoseTM
PhysicsNodeScaleTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [0.000000, 0.000000, 0.000000])
PhysicsNodePivotTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [0.000000, 0.000000, 0.000000])
PhysicsPoseTM = (matrix3 [1.000000, 0.000000, 0.000000] [0.000000, 1.000000, 0.000000] [0.000000, 0.000000, 1.000000] [1.576996, -11.519989, 0.000000])
--Node Pos in Physics = [1.576996, -11.519989, 0.000000]

--Node is convex = 0
0
<class>nvpx.GetObjectClass <node>node

指定されたノードのクラスを返します。

   

リジット ボディのコピーと貼り付け

メソッド:

<boolean>nvpx.CopyRigidbody <node>fromNode <node>toNode

リジット ボディ モディファイヤを、1 番目の引数で指定されたノードから、2 番目の引数で指定されたノードにコピーします。成功した場合は true を、失敗した場合は false を返します。

   

<boolean>nvpx.ClipboardCopyRBMesh <node>inode <integer>meshIndex

2 番目の引数で指定されたインデックスのリジット ボディ メッシュを、1 番目の引数で指定されたノードからクリップボードにコピーします。成功した場合は true を、失敗した場合は false を返します。

<boolean>nvpx.ClipboardPasteRBMesh <node>inode

クリップボードから指定されたノードに、リジット ボディ メッシュを貼り付けます。成功した場合は true を、失敗した場合は false を返します。

   

リジット ボディ メッシュのアクセス

以下のメソッドは、ノードの MassFX_RBody モディファイヤの設定と対話します。これらのメソッドを使用してノードを反復処理し、モディファイヤ自体を操作する代わりに、リジット ボディの設定を変更できます。

メソッド:

<integer>nvpx.AddRBMesh <node>inode

指定されたノードにリジット ボディ メッシュを追加します。新しいメッシュのインデックスを返します。

   

<boolean>nvpx.DeleteRBMesh <node>inode <integer>meshIndex

2 番目の引数のインデックスで指定されたリジット ボディ メッシュを、1 番目の引数で指定されたノードから削除します。成功した場合は true を、失敗した場合は false を返します。

   

<integer>nvpx.GetRBMeshCount <node>inode

指定されたノードのリジット ボディ メッシュの数を返します。

   

<string>nvpx.GetRBMeshName <node>inode <integer>meshIndex

指定されたノードにある指定されたインデックスのリジット ボディ メッシュの名前を返します。

   

<integer>nvpx.SetRBMeshName <node>inode <integer>meshIndex <string>meshName

指定されたノードにある 2 番目のインデックス引数で指定されたリジット ボディ メッシュの名前を、3 番目の引数で指定された名前に変更します。

   

<integer>nvpx.GetRBMeshType <node>inode <integer>meshIndex

指定されたノードにある、2 番目のインデックス引数で指定されたリジット ボディ メッシュのタイプを返します。戻り値の意味については、次のメソッドの説明を参照してください。

<boolean>nvpx.SetRBMeshType <node>inode <integer>meshIndex <integer>meshType

指定されたノードにある、2 番目のインデックス引数で指定されたリジット ボディ メッシュのタイプを、次のタイプに設定します。

1 - 球

2 - ボックス

3 - カプセル

4 - 凸型

5 - 合成

6 - オリジナル

7 - カスタム

成功した場合は true を、失敗した場合は false を返します。

   

<&matrix3>nvpx.GetRBMeshTM <node>inode <integer>meshIndex

指定されたノードにある、2 番目の引数で指定されたインデックスのリジット ボディ メッシュの変換行列を返します。

<boolean>nvpx.SetRBMeshTM <node>inode <integer>meshIndex <&matrix3>pose

pose is In and Out parameter

指定されたノードにある、2 番目の引数で指定されたインデックスのリジット ボディ メッシュの変換行列を、3 番目の引数として渡された matrix3 値に設定します。成功した場合は true を、失敗した場合は false を返します。

   

<float>nvpx.GetRBMeshRadius <node>inode <integer>meshIndex

該当する場合、ノードの指定されたインデックスのリジット ボディ メッシュの半径を返します(リジット ボディ メッシュのタイプが球、ボックス、カプセルの場合など)。それ以外の場合は 0 を返します。

<boolean>nvpx.SetRBMeshRadius <node>inode <integer>meshIndex <float>radius

ノードの指定されたインデックスのリジット ボディ メッシュの半径を、3 番目の引数で指定された浮動小数点値に設定します。リジット ボディ メッシュのタイプが半径の値をサポートしている場合は true、サポートしていない場合は false を返します。

   

<float>nvpx.GetRBMeshLength <node>inode <integer>meshIndex

該当する場合、ノードの指定されたインデックスのリジット ボディ メッシュの長さを返します(リジット ボディ メッシュのタイプがボックスの場合など)。それ以外の場合は 0 を返します。

<boolean>nvpx.SetRBMeshLength <node>inode <integer>meshIndex <float>Length

ノードの指定されたインデックスのリジット ボディ メッシュの長さを、3 番目の引数で指定された浮動小数点値に設定します。リジット ボディ メッシュのタイプがボックスの場合は true、それ以外の場合は false を返します。

   

<float>nvpx.GetRBMeshWidth <node>inode <integer>meshIndex

該当する場合、ノードの指定されたインデックスのリジット ボディ メッシュの幅を返します(リジット ボディ メッシュの種類がボックスの場合など)。それ以外の場合は 0 を返します。

<boolean>nvpx.SetRBMeshWidth <node>inode <integer>meshIndex <float>Width

ノードの指定されたインデックスのリジット ボディ メッシュの幅を、3 番目の引数で指定された浮動小数点値に設定します。リジット ボディ メッシュのタイプがボックスの場合は true、それ以外の場合は false を返します。

   

<float>nvpx.GetRBMeshHeight <node>inode <integer>meshIndex

該当する場合、ノードの指定されたインデックスのリジット ボディ メッシュの高さを返します(リジット ボディ メッシュのタイプがボックスの場合など)。それ以外の場合は 0 を返します。

<boolean>nvpx.SetRBMeshHeight <node>inode <integer>meshIndex <float>Height

ノードの指定されたインデックスのリジット ボディ メッシュの高さを、3 番目の引数で指定された浮動小数点値に設定します。リジット ボディ メッシュのタイプがボックスの場合は true、それ以外の場合は false を返します。

   

<node>nvpx.GetRBMeshCustomNode <node>inode <integer>meshIndex

該当する場合、指定されたノードの指定されたインデックスのリジット ボディ メッシュのカスタム ノードを返します(リジット ボディ メッシュのタイプがカスタムに設定されている場合など)。それ以外の場合は undefined を返します。

<integer>nvpx.SetRBMeshCustomNode <node>inode <integer>meshIndex <node>CustomNode

ノードの指定されたインデックスのリジット ボディ メッシュのカスタム メッシュを、3 番目の引数で指定されたノードに設定します。リジット ボディ メッシュのタイプがカスタムの場合は true 、それ以外の場合は false を返します。

   

<integer>nvpx.GetRBMeshVertexLimit <node>inode <integer>meshIndex

ノードの指定されたインデックスのリジット ボディ メッシュの頂点の制限値を返します。

<boolean>nvpx.SetRBMeshVertexLimit <node>inode <integer>meshIndex <integer>VerticeLimit

ノードの指定されたインデックスのリジット ボディ メッシュの頂点の制限値を、3 番目の引数で指定された整数値に設定します。リジット ボディ メッシュのタイプが頂点の制限をサポートしている場合(凸型など)は true を、サポートしていない場合は false を返します。

   

<float>nvpx.GetRBMeshInflation <node>inode <integer>meshIndex

ノードの指定されたインデックスのリジット ボディ メッシュのタイプが凸型の場合はその膨張値を返し、それ以外のタイプの場合は undefined を返します。

<boolean>nvpx.SetRBMeshInflation <node>inode <integer>meshIndex <float>Inflation

ノードの指定されたインデックスのリジット ボディ メッシュの膨張値を、3 番目の引数で指定された浮動小数点値に設定します。リジット ボディ メッシュのタイプが膨張をサポートしている場合(凸型など)は true を、サポートしていない場合は false を返します。

   

<mesh>nvpx.GetRBMeshShape <node>inode <integer>meshIndex

ノードの指定されたインデックスのリジット ボディ メッシュのタイプが凸型またはカスタムの場合はその TriMesh 値を返し、それ以外のタイプの場合は undefined を返します。

<boolean>nvpx.SetRBMeshShape <node>inode <integer>meshIndex <mesh>newMesh

ノードの指定されたインデックスのリジット ボディ メッシュのシェイプを、3 番目の引数で指定された TriMesh 値に設定します。リジット ボディ メッシュのタイプにメッシュがある場合(凸型、カスタムなど)は true を、ない場合は false を返します。

   

<boolean>nvpx.GetRBMeshOverrideMasterMat <node>inode <integer>meshIndex

指定されたノードのリジット ボディ メッシュの[物理的マテリアルを上書き]オプションの状態を返します。

<boolean>nvpx.SetRBMeshOverrideMasterMat <node>inode <integer>meshIndex <boolean>overrideIt

指定されたノードのリジット ボディ メッシュの[物理的マテリアルを上書き]オプションの状態を、3 番目の引数で指定された値に設定します。成功した場合は true を返し、失敗した場合は false を返します(たとえば、ノードにリジット ボディ モディファイヤがない場合や、meshIndex が無効な場合など)。

   

ノードの物理プロパティ

メソッド:

<&point3>nvpx.GetGlobalPosition <node>inode

指定されたノードのグローバル位置の値を返します。値を報告できない場合は[0,0,0]を返します。

<integer>nvpx.SetGlobalPosition <node>inode <&point3>position

position is In and Out parameter

指定されたノードのグローバル位置を、2 番目の引数として参照で渡された Point3 の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

<&point3>nvpx.GetLinearVelocity <node>inode

指定されたノードの線形速度の値を返します。値を取得できない場合は[0,0,0]を返します。

<integer>nvpx.SetLinearVelocity <node>inode <&point3>linearvelocity

linearvelocity is In and Out parameter

指定されたノードの線形速度を、2 番目の引数として参照で渡された Point3 の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

 <&point3>nvpx.GetAngularVelocity <node>inode

指定されたノードの矩形速度の値を返します。値を取得できない場合は[0,0,0]を返します。

<integer>nvpx.SetAngularVelocity <node>inode <&point3>angularvelocity

angularvelocity is In and Out parameter

指定されたノードの線形速度を、2 番目の引数として参照で渡された Point3 の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

<&matrix3>nvpx.GetGlobalPose <node>inode

指定されたノードのグローバル ポーズの値を返します。値を報告できない場合は恒等行列を返します。

 <integer>nvpx.SetGlobalPose <node>inode <&matrix3>pose

pose is In and Out parameter

指定されたノードのグローバル ポーズを、2 番目の引数として参照で渡された matrix3 の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

<float>nvpx.GetMass<node>inode

指定されたノードの質量の値を返します。値を取得できない場合は 0.0 を返します。

<float>nvpx.SetMass <node>inode <float>value

指定されたノードの質量を 2 番目の引数として渡された Float の値に設定します。新しい質量を返します。設定が失敗した場合は 0.0 を返します。

   

<float>nvpx.GetDynamicFriction <node>inode

指定されたノードの動的摩擦係数の値を返します。値を取得できない場合は 0.0 を返します。

<integer>nvpx.SetDynamicFriction <node>inode <float>value

指定されたノードの動的摩擦係数を 2 番目の引数として渡された Float の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

<float>nvpx.GetStaticFriction <node>inode

指定されたノードの静止摩擦係数の値を返します。値を取得できない場合は 0.0 を返します。

<integer>nvpx.SetStaticFriction <node>inode <float>value

指定されたノードの静止摩擦係数を 2 番目の引数として渡された Float の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

<float>nvpx.GetRestitution <node>inode

指定されたノードの反発の値を返します。値を取得できない場合は 0.0 を返します。

<integer>nvpx.SetRestitution <node>inode <float>value

指定されたノードの反発を 2 番目の引数として渡された Float の値に設定します。成功した場合は 0 を、失敗した場合は -1 を返します。

   

物理的マテリアルのロードと保存

メソッド:

<boolean>nvpx.SaveMaterial <string>filename <float>staticFriction <float>dynamicFriction <float>bounciness <integer>density

物理的マテリアルの XML ファイルを、1 番目の引数で指定されたファイル名に保存します。2 番目、3 番目、4 番目、5 番目の引数では、物理的マテリアルの静止摩擦係数、動的摩擦係数、弾力性、および密度の値を指定します。成功した場合は true を、失敗した場合は false を返します。

   

<float>nvpx.LoadMaterialStaticFric <string>filename

静止摩擦係数の値を指定された物理的マテリアル XML ファイルからロードし、Float として返します。

   

<float>nvpx.LoadMaterialDynFric <string>filename

動的摩擦係数の値を指定された物理的マテリアル XML ファイルからロードし、Float として返します。

   

<float>nvpx.LoadMaterialBounciness <string>filename

弾力性の値を指定された物理的マテリアル XML ファイルからロードし、Float として返します。

   

<integer>nvpx.LoadMaterialDensity <string>filename

弾力性の値を指定された物理的マテリアル XML ファイルからロードし、Float として返します。

   

物理的マテリアルのアクセス

メソッド:

<integer>nvpx.MaterialGetCount()

シーン内の物理的マテリアルの数を返します。

   

<integer>nvpx.MaterialGetId <integer>matIndex

指定された 0 から始まるマテリアル インデックス(マテリアル 1 のインデックスは 0、マテリアル 2 のインデックスは 1、など)に対し、マテリアルの整数 ID を返します。または、インデックスが範囲外の場合は 0 を返します。

   

<integer>nvpx.MaterialGetType <integer>matId

nvpx.MaterialGetId() メソッドによって返されたマテリアル ID を受け取り、マテリアルのタイプを返します。

   

<boolean>nvpx.MaterialIsLocked <integer>matId

   

<integer>nvpx.MaterialFind <string>ParamName

   

<integer>nvpx.MaterialCreate <integer>type

指定されたタイプの新しい名前のない物理的マテリアル プリセットを作成します。マテリアル ID を整数で返します。

   

<boolean>nvpx.MaterialRemove <integer>matId

指定された ID の物理的マテリアル プリセットを削除します。成功した場合は true を、失敗した場合は false を返します。

   

<string>nvpx.MaterialGetParam <integer>matId <string>ParamName

指定された ID の物理的マテリアルのパラメータを文字列として返します。

2 番目の引数はパラメータ名であり、次のいずれかです。

<boolean>nvpx.MaterialSetParam <integer>matId <string>ParamName <string>ParamValue

1 番目の引数で指定された物理的マテリアルの、2 番目の引数で指定された名前のパラメータを、3 番目の引数で提供された文字列値に設定します。

成功した場合は true を返し、失敗した場合は false を返します(パラメータ名がサポートされていない場合など)。

   

<integer>nvpx.GetPMVisibleForRigidBodies()

物理的マテリアルがリジット ボディに対して表示される場合は 1 を返し、表示されない場合は 0 を返します。

<void>nvpx.SetPMVisibleForRigidBodies <integer>visible

リジット ボディに対する物理的マテリアルの表示を、整数引数(1 は表示、0 は非表示)に設定します。

   

<boolean>nvpx.SetRBDisplayMaterial <material>dynamicMat <material>kinematicMat <material>staticMat

3ds Max の 3 つのマテリアルを、ダイナミクス オブジェクト、キネマティクス オブジェクト、およびリジット ボディ オブジェクトの表示用に使用するように設定します。成功した場合は true を、失敗した場合は false を返します。

   

バウンディング ジオメトリの作成

以下のメソッドは任意のシーン ノードで動作し、ノードがリジット ボディ メッシュまたはジオメトリ オブジェクトである必要はありません。

メソッド:

<node>nvpx.CreateBoundingBox <node>inode

指定されたノードのオブジェクトで位置合わせされたバウンディング ボックスと一致する nv_Box ジオメトリ プリミティブを作成します。

   

<node>nvpx.CreateBoundingSphere <node>inode

指定されたノードに対して位置合わせされ、ノードのバウンディング ボックスの球体バウンディングを表している、nv_Sphere ジオメトリ プリミティブを作成します。

   

<node>nvpx.CreateBoundingCapsule <node>inode

ノードのバウンディング ボックスを囲む nv_Capsule ジオメトリ プリミティブを作成します。

   

<node>nvpx.CreateBoundingCapsuleFromPoints <matrix3>poseTransform <&float array>points

points is In and Out parameter

ポーズ変換行列と、カプセルの内部に含まれる点の配列に基づいて、nv_Capsule ジオメトリ プリミティブを作成します。

   

<node>nvpx.CreateBoundingShapeConvex <node>inode <integer>vertLimit <float>inflation

指定されたノードを囲む編集可能メッシュ ノードを作成します。2 番目の引数は、結果のメッシュに含まれる頂点の数を制限します。3 番目の引数は、バウンディング サーフェスからのオフセットを適用する膨張を定義します。

   

<mesh>nvpx.CreateBoundingConvex <node>inode <integer>vertLimit <float>inflation

指定されたノードの凸型のバウンディング シェイプを表す TriMesh 値を返します。2 番目の引数は、結果のメッシュに含まれる頂点の数を制限します。3 番目の引数は、バウンディング サーフェスからのオフセットを適用する膨張を定義します。このメソッドは nvpx.CreateBoundingShapeConvex() と似ていますが、シーン ノードを作成するのではなく、メモリ内にメッシュを生成します。

   

<mesh>nvpx.CreateBoundingConvexFromNodes <&node array>inodes <integer>vertLimit <float>inflation

inodes is In and Out parameter

指定されたすべてのノードの凸型のバウンディング シェイプを表す TriMesh 値を返します。2 番目の引数は、結果のメッシュに含まれる頂点の数を制限します。3 番目の引数は、バウンディング サーフェスからのオフセットを適用する膨張を定義します。このメソッドは nvpx.CreateBoundingConvex() と似ていますが、複数のノードを同時に処理します。

   

<mesh>nvpx.CreateConvexHull <mesh>mesh <integer>vertlimit <float>inflation

指定された TriMesh 値の凸型のバウンディング シェイプを表す TriMesh 値を返します。2 番目の引数は、結果のメッシュに含まれる頂点の数を制限します。3 番目の引数は、バウンディング サーフェスからのオフセットを適用する膨張を定義します。このメソッドは nvpx.CreateBoundingConvex() と似ていますが、シーン ノードではなく、メモリ内の TriMesh 値に対して動作します。

   

<mesh>nvpx.CreateConvexFromPoints <&float array>points <integer>vertlimit <float>inflation

points is In and Out parameter

浮動小数点値の配列で指定される点を囲む凸型のバウンディング シェイプを表す TriMesh 値を返します。配列の要素の数は、空間の Point3 値の数の 3 倍である必要があります。連続する 3 つの浮動小数点値が 1 つの Point3 値の X、Y、Z コンポーネントとして使用されます。

2 番目の引数は、結果のメッシュに含まれる頂点の数を制限します。3 番目の引数は、バウンディング サーフェスからのオフセットを適用する膨張を定義します。

このメソッドは nvpx.CreateBoundingConvex() と似ていますが、ジオメトリの頂点ではなくユーザ定義の点に対して動作します。

   

スリープ アクター

メソッド:

<boolean>nvpx.SetSleepState <node>inode <boolean>onoff

指定されたノードのスリープ状態を、2 番目の引数で提供されるブール値に設定します。

   

<integer>nvpx.FindSleepingActors()

シーン内のスリープ アクターの数を返します。

   

<node>nvpx.GetSleepingActor <integer>index

0 から始まるインデックス引数に対応するスリープ ノードを返します。インデックスは、0 から (nvpx.FindSleepingActors())-1 の範囲である必要があります。

インデックスが範囲外の場合は、 undefined を返します。

   

パラメータの取得/設定

メソッド:

<string>nvpx.GetRBParam <node>inode <string>paramName

指定されたリジット ボディの指定された名前のパラメータの文字列値を返します。

<boolean>nvpx.SetRBParam <node>inode <string>paramName <string>paramValue

指定されたリジット ボディの指定された名前のパラメータの値を、3 番目の引数として指定された文字列値に設定します。

   

<boolean>nvpx.GetRBShapeParam <node>inodeRB <node>inodeShape <string>paramName

指定されたリジット ボディおよびシェイプ ノードの指定されたパラメータのブール値を返します。

<boolean>nvpx.SetRBShapeParam <node>inodeRB <node>inodeShape <string>paramName <string>paramValue

指定されたリジット ボディおよびシェイプ ノードの指定されたパラメータの文字列値を、4 番目の引数として指定された文字列値に設定します。

   

<boolean>nvpx.GetConstraintParam <node>inode <string>paramName

指定されたノードのコンストレイント プロパティの値を返します。2 番目の引数はプロパティの名前です。

<boolean>nvpx.SetConstraintParam <node>inode <string>paramName <string>paramValue

指定されたノードのコンストレイントの指定されたプロパティの値を設定します。3 番目の引数はプロパティの名前です。成功した場合は true を、失敗した場合は false を返します。

   

<float>nvpx.GetSDKParameter <TSTR byvalue>paramName

指定された名前の SDK パラメータの値を返します。

サポートされる SDK パラメータの名前のリストを取得するには、シーンを XML ファイルに書き出し、<NxParameterDesc param="ABC"> タグのファイルの内容を参照します。「ABC」はパラメータの名前です。

パラメータの名前がサポートされていない場合、戻り値は -3.40282e+038 (最小の浮動小数点値)になります。

<integer>nvpx.SetSDKParameter <TSTR byvalue>paramName <float>value

指定された名前の SDK パラメータを、2 番目の引数で指定された値に設定します。詳細は前のメソッドを参照してください。

<integer>nvpx.SetSDKDefaultParameter <TSTRby value>paramName

指定された名前の SDK パラメータを、既定値に設定します。

   

コンタクト レポート

コンタクト レポートは、物理的シミュレーションの間に記録された衝突に関する情報を提供し、フォース、位置、および関係するノードが含まれます。フォースの大きさのスレッショルドを使用してコンタクトをフィルタ処理し、軽い衝突を除外できます。

メソッド:

<boolean>nvpx.SetUseContactReport <boolean>OnOff

コンタクト レポートの有効状態を true または false に設定します。

   

<integer>nvpx.GetContactsCount()

記録されたコンタクトの数を返します。

   

<boolean>nvpx.GetNextContact()

次のコンタクトの内部ポインタを設定します。コンタクトのフォース、ポイント、ノードを取得するための以降のメソッドに影響します。

   

<point3 byvalue>nvpx.GetContactForce()

現在のコンタクト レコードのコンタクト フォースを Point3 値として返します。

   

<point3 byvalue>nvpx.GetContactPoint()

現在のコンタクト レコードのコンタクト ポイントを Point3 値として返します。

   

<node>nvpx.GetContactNode0()

現在のコンタクト レコードの 1 番目のノードを返します。

<node>nvpx.GetContactNode1()

現在のコンタクト レコードの 2 番目のノードを返します。

   

<float>nvpx.GetContactFilter()

現在のコンタクト フィルタの値を返します。フォースのベクトルの長さ(大きさ)がこの値より小さいコンタクトは記録されません。

<float>nvpx.SetContactFilter <float>force

コンタクトのフィルタを浮動小数点のスレッショルド値に設定します。フォースのベクトルの長さがこの値より小さいコンタクトは記録されません。

   

スキン アクセス

以下のメソッドは、3ds Max のスキン データへのアクセスを提供します。

メソッド:

<boolean>nvpx.ParseSkinInfo <node>inode <float>weightThreshold

2 番目の引数を重みのスレッショルドとして使用して、指定されたノードからスキンの情報を収集します。重みがスレッショルド値より小さい頂点についてのデータは収集されません。成功した場合は true を返し、失敗した場合は false を返します(ノードがスキン オブジェクトではない場合など)。

   

<integer>nvpx.GetVerticesCountFromSkinnedBone <node>inode

nvpx.ParseSkinInfo() メソッドで収集されるときに指定されたボーンによって影響を受ける頂点の数を返します。

   

<float by value array>nvpx.GetVerticesFromSkinnedBone <node>inode

指定されたボーンによって影響を受ける頂点の X、Y、Z コンポーネントを表す浮動小数点値の配列を返します。座標はボーンのローカル スペースのものです。ワールド スペースの位置を生成するには、配列の 3 つの浮動小数点値から作成される Point3 値に、ボーンの変換行列を乗算する必要があります。

   

<boolean>nvpx.ReleaseSkinInfo()

nvpx.ParseSkinInfo() によって収集されたスキン情報データをクリアします。

   

ボーン メソッド

メソッド:

<boolean>nvpx.HaveBoneFloatLimitControl <node>inode <string>block

ボーンに実数リミット コントロールがある場合は true を返します。

   

<string>nvpx.GetBoneFloatLimitValue <node>inode <string>block <string>param

ボーンの実数リミットの値を返します。

   

<boolean>nvpx.IsBone <node>inode

指定されたノードがボーンである場合は true を返し、ボーンではない場合は false を返します。

   

<matrix3 by value>nvpx.GetBonePose <node>inode

指定されたボーンのポーズ変換行列を返します。

   

ラグドール アクセス

メソッド:

<node>nvpx.RagdollGetRootBone <node>inode

指定されたラグドールのルート ボーンを返します。

   

<boolean>nvpx.IsRagdollNode <node>inode

指定されたノードがラグドール ノードである場合、true を返します。

   

<boolean>nvpx.LoadRagdollHelperMesh <meshby value>mesh

ラグドール ヘルパー メッシュの値をロードします。成功した場合は true を、失敗した場合は false を返します。

   

<node>nvpx.CreateRagdollHelper()

ラグドール ヘルパーを作成します。

   

<void>nvpx.RagdollRegenerate <node>ragdoll <&node array>bones 

bones is In and Out parameter

2 番目の引数で指定されたボーン ノードの配列を使用して、指定されたラグドール ノードを再生成します。

   

<void>nvpx.RagdollAddBone <node>ragdoll <node>boneNode

2 番目の引数で指定されたボーン ノードを、1 番目の引数で指定されたラグドール ノードに追加します。

   

<void>nvpx.RagdollRemoveBone <node>ragdoll <node>boneNode

2 番目の引数で指定されたボーン ノードを、1 番目の引数で指定されたラグドールから削除します。

   

<boolean>nvpx.RagdollGroupBones <node>ragdoll <&node array>bones 

bones is In and Out parameter

1 番目の引数で指定されたラグドールのラグドール ボーンを、2 番目の引数として渡された参照の配列を使用して指定します。成功した場合は true を、失敗した場合は false を返します。

   

<boolean>nvpx.RagdollSave <node>ragdoll <string>filename

1 番目の引数で指定されたラグドールを、2 番目の引数で指定されたファイル名に保存します。成功した場合は true を、失敗した場合は false を返します。

   

<boolean>nvpx.RagdollLoad <node>ragdoll <string>filename

1 番目の引数で指定されたラグドールを、2 番目の引数で指定されたファイルからロードします。成功した場合は true を、失敗した場合は false を返します。

   

Biped 統合

メソッド:

<boolean>nvpx.IsBiped <node>inode

指定されたノードが Biped ノードである場合は true を返し、それ以外の場合は false を返します。

   

<boolean>nvpx.IsBipedRoot <node>inode

指定されたノードが Biped ルート ノードである場合は true を返し、それ以外の場合は false を返します。

   

<boolean>nvpx.IsBipedFootsteps <node>inode

指定されたノードが Biped 足跡ノードである場合は true を返し、それ以外の場合は false を返します。

   

<void>nvpx.BipedSetKeys <boolean>setKeys

引数が true の場合、選択されている Biped に対するキーを設定します。

   

Physique 統合

メソッド:

<boolean>nvpx.PhysiqueLoad <node>inode

指定されたノードの Physique データをロードします。

   

<integer>nvpx.PhysiqueGetNumBones <node>inode

指定されたノードの Physique モディファイヤに関連付けられているボーンの数を返します。

   

<node>nvpx.PhysiqueGetBone <node>inode <integer>boneIndex

指定されたノードの指定されたインデックスのボーン ノードを返します。

   

<integer>nvpx.PhysiqueGetNumBoneVertices <node>inode <node>boneNode

1 番目の引数で指定されたノード内にある、2 番目の引数で指定されたボーンによって影響を受ける頂点の数を返します。

   

<point3 by value>nvpx.PhysiqueGetBoneVertex <node>inode <node>boneNode <integer>verticeIndex

1 番目の引数で指定されたノード内にあり、2 番目の引数で指定されたボーンによって影響を受ける、インデックスで指定された頂点の位置を返します。

   

ユーティリティ関数

メソッド:

<boolean>nvpx.IsConvex <node>inode

指定されたノードが凸型の場合は true を返し、凹型の場合またはジオメトリ オブジェクトではない場合は false を返します。

   

<float>nvpx.CalcVolume <node>inode

指定されたノードのボリュームを一般的なキュービック単位で返します。

   

間接的ドラッグ メソッド

メソッド:

<boolean>nvpx.StartIndirectDrag <node>attach

シミュレーションの実行中に指定されたノードをマウスにアタッチすることで間接的ドラッグを開始します。成功した場合は true を返し、シミュレーションが実行されていない場合は false を返します。

   

<boolean>nvpx.OnIndirectDrag <&point3>mousepos

mousepos is In and Out parameter

間接的ドラッグが有効の場合は、 true を返し、マウスの位置を参照引数に格納します。それ以外の場合は false を返します。

   

<boolean>nvpx.EndIndirectDrag()

間接的ドラッグを終了します。成功した場合は true 、失敗した場合は false を返します。

   

ビジュアライザー メソッド

メソッド:

<boolean>nvpx.VisualizerGetEnabled()

ビジュアライザーの有効状態を返します。

<void>nvpx.VisualizerSetEnabled <boolean>flag

ビジュアライザーの有効状態を設定します。

   

<float>nvpx.VisualizerGetScale()

ビジュアライザーのスケール値を返します。既定値は 1.0 です。

<float>nvpx.VisualizerSetScale <float>newScale

ビジュアライザーのスケールを、指定された浮動小数点値に設定します。

   

<integer>nvpx.VisualizerGetPhysXParamCount()

ビジュアライザーがサポートしている PhysX パラメータの数を返します。

   

<string>nvpx.VisualizerGetPhysXParamName <integer>index

i 番目のパラメータの名前を返します。インデックスの基数は 1 です。

   

<integer>nvpx.VisualizerGetPhysXParam <string>paramName

指定されたビジュアライザー パラメータの値を返します。ブール値は整数で表され、0 は false、1 は true です。

<boolean>nvpx.VisualizerSetPhysXParam <string>paramName <boolean>flag

1 番目の引数で指定された名前のビジュアライザー パラメータを、2 番目の引数で指定されたブール値に設定します。成功した場合は true を返し、パラメータ名を認識できなかった場合は false を返します。有効なパラメータ名のリストについては、次の例を参照してください。

例:

for i = 1 to nvpx.VisualizerGetPhysXParamCount() do
(
  local theName= (nvpx.VisualizerGetPhysXParamName i)
  format "%: \"%\" = %\n" i theName (nvpx.VisualizerGetPhysXParam theName)
)

出力:

1: "Body Axis" = 0
2: "Body Mass Axes" = 0
3: "Body Linear Velocity" = 0
4: "Body Angular Velocity" = 0
5: "Joint Local Axes" = 0
6: "Joint World Axes" = 0
7: "Joint Limits" = 0
8: "Contact Point" = 0
9: "Contact Normal" = 0
10: "Contact Error" = 0
11: "Contact Force" = 1
12: "Actor Axes" = 0
13: "Collision AABBS" = 0
14: "Collision Shapes" = 0
15: "Collision Axes" = 0
16: "Collision Compounds" = 0
17: "Collision VNormals" = 0
18: "Collision FNormals" = 0
19: "Collision Edges" = 0
20: "Collision Spheres" = 0
21: "Collision Static" = 0
22: "Collision Free" = 0
23: "Collision CCD" = 0
24: "Collision Skeletons" = 0
OK

   

PhysX システム

メソッド:

<integer>nvpx.GetPhysXSDKVersion()

PhysX SKD のバージョンを整数として返します。

   

<integer>nvpx.GetApexSDKVersion()

Apex SDK のバージョンを整数として返します。

   

<integer>nvpx.InitializePhysX <value>stream

PhysX システムを初期化します。

   

<integer>nvpx.CreateToolbar()

MassFX シミュレーション ツールバーを作成します。

   

<void>nvpx.ShowToolbar <boolean>show

ブール引数として true が渡された場合は、MassFX シミュレーション ツールバーを表示します。

ブール引数として false が渡された場合は、MassFX シミュレーション ツールバーを表示しません。

   

<void>nvpx.ShowMaterialEditor <boolean>show

ブール引数として true が渡された場合は、MassFX マテリアル エディタを表示します。

ブール引数として false が渡された場合は、MassFX マテリアル エディタを表示しません。

   

<boolean>nvpx.ShowValidateScene <boolean>automated

[シーンを検証]ダイアログを表示します。

ブール引数が true の場合は、テストも自動的に実行されます。

ブール引数が false の場合は、テストは実行されないので、[検証]ボタンをクリックする必要があります。

   

<boolean>nvpx.HwAvailable()

PhysX アクセラレーション ハードウェアが使用可能な場合は true を返し、それ以外の場合は false を返します。

   

<integer>nvpx.GetScreenHeight()

画面の高さをピクセル数で返します。

   

<float>nvpx.GetSimulationFPS()

シミュレーションのフレーム レートを、1 秒あたりのフレーム数の浮動小数点値で返します。

   

<boolean>nvpx.PrintSimulationFPS <boolean>onoff

ブール引数として true が渡された場合は、MAXScript リスナーに対する自動シミュレーション フレーム レートの出力を有効にします。

引数が false の場合は、フレーム レートの出力はオフになります。

   

<integer>nvpx.GetPhysXPluginCount()

インストールされている PhysX プラグインの数を返します。

   

<integer>nvpx.GetPhysXPluginVersion <integer>Index

指定されたインデックスの PhysX プラグインのバージョン番号を返します。インデックスが 1 未満の場合、または nvpx.GetPhysXPluginCount() で返される値より大きい場合は、0 が返されます。

   

<boolean>nvpx.UsePhysXPlugin <integer>Index

指定されたインデックスの PhysX プラグインに切り替えます。成功した場合は true を返し、失敗した場合(プラグインのインデックスが範囲外の場合など)は false を返します。さらに、MAXScript リスナーに「Switch PhysX SDK to XXX」というメッセージを出力します。XXX は、 nvpx.GetPhysXPluginCount() によって返される SDK のバージョンです。

   

<void>nvpx.DetachPhysX()

PhysX プラグインをデタッチします。

   

<void>nvpx.AttachPhysX()

PhysX プラグインをアタッチします。

   

<void>nvpx.DestroyPhysX()

PhysX プラグインを破棄します。

   

<void>nvpx.OpenHelpFile()

使用可能な場合は、MassFX ヘルプ ファイルを開きます。

   

<boolean>nvpx.IsApexAvailable()

APEX の布地シミュレーションが現在のプラグインで使用可能な場合は true を返し、それ以外の場合は false を返します。

   

<integer>nvpx.DebugPrint()

デバッグ テキストを MAXScript リスナーに出力します。PhysX エンジンの現在の状態、およびシーン内のシミュレーション オブジェクトについての情報が含まれます。

nvpx.DebugPrint()
-->
PhysX SDK version: 34079744, HW version: 0
   Number of PPUs: 0
   Number of Triangle meshes: 0
   Number of HeightFields: 0
   Number of Cloth meshes: 0
   Number of SoftBody meshes: 0
   Number of CCD skeletons: 0
   Number of Scenes: 1
   Scene object: 1013386992
      Number of NxActors: 0
Our Scene object: 1013386992
Cooking interface object: 970914512, initialized: true
---------------------------------------------------
0

   

<void>nvpx.DescribeMe()

nvpx インタフェースによって実装されているすべてのメソッドのリストを出力します。 showInterface nvpx を呼び出すのと似ています。

   

<void>nvpx.PhysXPanelTooltip()

   

<boolean>nvpx.ConnectPVD <string>hostName

   

<void>nvpx.SetButtonCheck <integer>id <boolean>value

   

<boolean>nvpx.SetNullCM()

PhysX ドラッグ モードを開始します。

   

<boolean>nvpx.RemoveNullCM()

PhysX ドラッグ モードを終了します。

   

プロファイラ メソッド

メソッド:

<void>nvpx.ProfilerBegin <string>name

プロファイリングを開始します。

   

<void>nvpx.ProfilerEnd <string>name

プロファイリングを終了します。

   

<void>nvpx.ProfilerDump()

開始と終了の呼び出しの間に収集されたプロファイリング情報をダンプします。定義されているプロファイラごとに行があり、平均時間、最小時間、最大時間、合計時間と、シミュレーションの実行回数に関する情報が含まれます。

nvpx.ProfilerBegin "Test" -- プロファイリングを開始します。
--> OK

-- MassFX シミュレーションを実行します([すべてをベイク]など)。

nvpx.ProfilerEnd "Test" -- プロファイリングを終了します。
--> OK
nvpx.ProfilerDump() -- 収集された情報をダンプします。
--> Test avg:37728ms min:37728 max:37728 count:1 total:37728ms
--> OK

   

マルチ スレッディングとハードウェア アクセラレーション

メソッド:

<boolean>nvpx.SupportMultiThread()

PhysX エンジンがマルチ スレッディングをサポートしている場合は true を返し、サポートしていない場合は false を返します。

   

<boolean>nvpx.IsMultiThreadOn()

マルチ スレッディングが有効である場合は true を返し、無効になっている場合は false を返します。既定値は false です。

   

<boolean>nvpx.UseMultiThread <boolean>onOff

引数が true の場合は、マルチ スレッディングを有効にします。引数が false の場合は、マルチ スレッディングを無効にします。

   

<boolean>nvpx.SupportHardwareScene()

ハードウェア アクセラレーションが現在サポートされている場合は true を返し、サポートされていない場合は false を返します。

   

<boolean>nvpx.IsHardwareSceneOn()

ハードウェア アクセラレーションが有効である場合は true を返し、無効になっている場合は false を返します。

   

<boolean>nvpx.UseHardwareScene <boolean>onOff

引数が true でハードウェア アクセラレーションがサポートされている場合は、ハードウェア アクセラレーションを有効にします。false の場合は、ハードウェア アクセラレーションを無効にします。成功した場合は true を返し、ハードウェア アクセラレーションがサポートされていない場合は false を返します。

   

UnitTest メソッド

以下のメソッドは内部的なユニット テストの実行に使用されるものなので、ユーザは呼び出さないでください。

メソッド:

<void>nvpx.UnitTest_MaterialCreate <integer>type <string>name
<boolean>nvpx.UnitTest_MaterialFind <string>name
<void>nvpx.UnitTest_MaterialDelete <string>type
<void>nvpx.UnitTest_MaterialAssign <node>node <string>name
<string>nvpx.UnitTest_MaterialPick <node>node
<void>nvpx.UnitTest_MaterialSetSelection <string>type
<string>nvpx.UnitTest_MaterialGetSelection()

   

アクション:

アクションは公開されません。

   

関連事項