vrdPhysicsConvexConfig

クラス vrdPhysicsConvexConfig

(vrdPhysicsHullConfig を継承)

凸型分解によって生成される物理オブジェクトの設定クラスです。

この設定クラスは、凸型分解によって生成される物理オブジェクトのプロパティを指定するために使用されます。凸型分解とは、複雑なメッシュを取り込み、元のメッシュの近似となる一連の凸型ハルに分解するプロセスのことです。これは、単純な凸型ハルよりも精度の高い非凸型メッシュから物理オブジェクトを作成する場合に便利です。可能であれば、三角形メッシュを使用するよりも、この方法を使用することを推奨します。

凸型分解に使用されるライブラリは、v-hacd ライブラリ(階層構造の近似凸型分解)です(https://github.com/kmammou/v-hacd)。このドキュメントには、この設定クラスで設定できるパラメータに関する詳細が記載されています。ほとんどすべてのパラメータがここに記載されており、分解プロセスを微調整するためにこのクラスで設定できます

概要

関数:

関数

vrdPhysicsConvexConfig.getAsync()

非同期実行が有効になっているかどうかを確認します。

戻り値:非同期実行が有効な場合は true、それ以外の場合は false。
戻り値の型:bool

vrdPhysicsConvexConfig.getFillMode()

塗り潰しモードを取得します。

戻り値:塗り潰しモード。
戻り値の型:integer

vrdPhysicsConvexConfig.getMaxNumberOfConvexHulls()

許可される凸型ハルの最大数を取得します。

戻り値:凸型ハルの最大数。
戻り値の型:integer

vrdPhysicsConvexConfig.getMaxNumVerticesPerHull()

凸型ハルごとの頂点の最大数を取得します。

戻り値:凸型ハルごとの頂点の最大数。
戻り値の型:integer

vrdPhysicsConvexConfig.getMaxRecursionDepth()

最大反復深度を取得します。

戻り値:最大反復深度。
戻り値の型:integer

vrdPhysicsConvexConfig.getMinEdgeLength()

最小エッジ長を取得します。

戻り値:最小エッジ長。
戻り値の型:integer

vrdPhysicsConvexConfig.getMinimumVolumePercentErrorAllowed()

許容される最小ボリューム エラー率を取得します。

戻り値:最小ボリューム エラー率。
戻り値の型:float

vrdPhysicsConvexConfig.getResolution()

ボクセル解像度を取得します。

戻り値:ボクセル解像度。
戻り値の型:integer

vrdPhysicsConvexConfig.getShrinkWrap()

シュリンクラップが有効かどうかを確認します。

戻り値:シュリンクラップが有効な場合は true、それ以外の場合は false。
戻り値の型:bool

vrdPhysicsConvexConfig.setAsync(mode)

非同期的に実行するかどうかを設定します。

既定値は true です。

パラメータ:mode (bool): 非同期的に実行するかどうかを示す状態。

vrdPhysicsConvexConfig.setFillMode(mode)

塗り潰しモードを設定します。

塗り潰しモードは、ボクセル化されたメッシュの内部を塗り潰すために v-hacd ライブラリで使用されるアルゴリズムを指定します。有効な値(v-hacd ドキュメントに記載)は、次のとおりです。0: 塗り潰しモード。既定の動作です。ボクセル化手順を実行した後に塗り潰しを使用して、「外側」から「内側」を決定します。ただし、メッシュに穴が開いている場合は失敗し、中空の結果が作成されることがあります。1: サーフェス専用モード。「サーフェス」のみを考慮し、中央が空洞になっている「スキン」を作成します。2: レイキャスト塗り潰しモード。レイキャスティングを使用して外側から内側を決定します。

既定値は 0 です。

パラメータ:mode (integer): 塗り潰しモード。

vrdPhysicsConvexConfig.setMaxNumberOfConvexHulls(numHulls)

アルゴリズムによって生成される凸型ハルの最大数を設定します。

このアルゴリズムでは、この数よりも多くのハルは生成されません。実際に生成されるハルの数は、この上限しきい値よりも小さくなる場合があります。

既定値は 64 です。

パラメータ:numHulls (integer): 凸型ハルの最大数。

vrdPhysicsConvexConfig.setMaxNumVerticesPerHull(numVertices)

凸型ハルごとの頂点の最大数を設定します。

凸型ハルごとの頂点数は PhysX によって 256 に制限されるため、値は 4 ~ 256の間である必要があります。未調整の場合は、最も近い有効な値に調整されます。

既定値は 64 です。

パラメータ:numVertices (integer): 凸型ハルごとの頂点の最大数。

vrdPhysicsConvexConfig.setMaxRecursionDepth(depth)

最大反復深度を設定します。

これは、凸型分解アルゴリズムの最大再帰深度を設定します。既定値は 10 です。

パラメータ:depth (integer): 最大反復深度。

vrdPhysicsConvexConfig.setMinEdgeLength(length)

最小エッジ長を設定します。

v-hacd ドキュメントに記載: 「ボクセル パッチのエッジ長が 3 つのすべての側面で 4 未満になると、反復は続行されなくなります。」

既定値は 2 です。

パラメータ:length (integer): 最小エッジ長。

vrdPhysicsConvexConfig.setMinimumVolumePercentErrorAllowed(percent)

許容される最小ボリューム エラー率を設定します。

v-hacd ドキュメントに記載: 「ボクセルがハルのボリュームの 1% 以内に収まっている場合は、十分近い近似であると見なされます。」

既定値は 1.0 です。

パラメータ:percent (float): 最小ボリューム エラー率。

vrdPhysicsConvexConfig.setResolution(resolution)

使用するボクセル解像度を設定します。

既定値は 400000 です。

パラメータ:resolution (integer): ボクセル解像度。

vrdPhysicsConvexConfig.setShrinkWrap(enable)

ボクセルの位置をソース メッシュにシュリンクラップするかどうかを設定します。

v-hacd ドキュメントに記載: 「出力時にボクセル位置をソース メッシュにシュリンクラップするかどうかを示します。」

既定値は true です。

パラメータ:enable (bool): シュリンクラップするかどうかを示す状態。