マトリックスを使用してノード データを設定および取得する

手順 1. データ ブロックを構築します

16 バイトでアラインされたメモリ バッファに、HIKCharacterState の各ノードに対して、変換配列で紹介されているフォーマットに従うマトリックスを格納します。このマトリックスは各ノードに必要な情報のみであるため、各マトリックスは通常は自身のデータ ブロックを表します。

データ セット内の各マトリックスのオフセットは、16 バイトでアラインされる必要があります。

例:

// first Node 
{-45.95f, 87.81f, -205.81f, 0.0f, 
 -0.54f, 0.0f, -0.05f, 0.83f,
 0.16f, 0.16f, 0.16f, 1.0f,
 -36.91f, 85.10f, -203.83f, 0.0f},
// second Node 
{-36.91f, 85.10f, -203.83f, 0.0f,
 -0.39f, 0.57f, -0.40f, 0.58f,
 0.16f, 0.16f, 0.16f, 1.0f
 -37.17f, 47.86f, -218.01f, 0.0f},
// third Node 
...

手順 2. データ説明を構築します

このデータ説明は、HIKDataDescriptionMatrix 構造のインスタンスである必要があります。データ説明のために、次の項目を指定する必要があります。

• マトリックスがグローバル スペースで提供されるか、ローカル スペースで提供されるかを示す列挙値。この値は、HIKGlobalSpace と HIKLocalSpace のいずれかにすることができます。
• データ ブロック内の各マトリックスのオフセット。各データ ブロックに各マトリックスの前に HumanIK によって使用されないカスタム情報が含まれる場合を除き、この値は通常は 0 です。
• ストライド、または各データ ブロックのサイズ。各マトリックスは 16 の浮動小数点数であるため、この値は通常は sizeof(float) * 16 と同等です。
• マトリックスがデータ セットに格納されるすべてのノードの一意のノード ID を含む配列であり、それらのマトリックスが格納される順になります。この配列の最後の要素は、特別な列挙値 HIKLastNode である必要があります。

  この配列には特別な値 HIKNotUsed も含めることができ、この値は HumanIK に指示して、対応するデータ ブロックをスキップします。

例:

int myUsedNodes[] = {HipsNodeId, 
                     LeftHipNodeId,
                     RightHipNodeId,
                     ...
                     RightFootPinkyDNodeId,
                     HIKLastNode
                     };
HIKDataDescriptionMatrix myDescription = {HIKGlobalSpace,
                                          0,
                                          sizeof(float)*16,
                                          myUsedNodes
                                          };

手順 3. データを HumanIK に渡します

HIKSetCharacterStateTransform()関数を呼び出し、データ セットに含まれる変換マトリックスをHIKCharacterに適用します。

例:

HIKSetCharacterStateTransform(lCharacter,
                              lCharacterState,
                              &myDescription,
                              (void *)gSrcAnimTQS[frameId]);