XACT3 への移行ガイド
既存の XACT コードは、ここでの説明と変更指示に従うことで、XACT3 を使用するように簡単に更新できます。
注 これまでに非推奨となった XACT のすべての項目が廃止されています。
ヘッダー
| XACT ヘッダー | XACT3 ヘッダー |
|---|---|
| Xact.h | Xact3.h |
| Xact3d.h | Xact3d3.h |
インターフェイス
| XACT インターフェイス | XACT3 インターフェイス |
|---|---|
| IXACTEngine | IXACT3Engine |
| IXACTWaveBank | IXACT3WaveBank |
| IXACTSoundBank | IXACT3SoundBank |
| IXACTCue | IXACT3Cue |
| IXACTWave | IXACT3Wave |
メソッド
| XACT メソッド | XACT3 メソッド |
|---|---|
| IXACTCue::GetChannelMap | 同等のメソッドはありません。 チャンネル マップとチャンネル ボリュームは、1 つの行列に結合されました。行列値を参照する必要がある場合は、IXACT3Cue::SetMatrixCoefficients に渡された引数をキャッシュすることを検討してください。 |
| IXACTCue::SetChannelMap | IXACT3Cue::SetMatrixCoefficients チャンネル マップとチャンネル ボリュームを操作する IXACTCue メソッドは、IXACT3Cue::SetMatrixCoefficients メソッドに置き換えられています。SetMatrixCoefficients メソッドは、IXACTCue::SetChannelMap メソッドと IXACTCue::SetChannelVolume メソッドに渡されていたチャンネル マップとチャンネル ボリュームの組み合わせとなる行列係数テーブルを受け取ります。この行列係数テーブルは、各デスティネーション チャンネルにある各ソース チャンネルのボリューム レベルを表す配列です。ソース チャンネルがテーブルの列インデックスになり、デスティネーション チャンネルが行インデックスになります。テーブルには、少なくとも uSrcChannelCount × uDstChannelCount 個の要素が必要です。 |
| IXACTCue::GetChannelVolume | 同等のメソッドはありません。 チャンネル マップとチャンネル ボリュームは、1 つの行列に結合されました。行列値を参照する必要がある場合は、IXACT3Cue::SetMatrixCoefficients に渡された引数をキャッシュすることを検討してください。 |
| IXACTCue::SetChannelVolume | IXACT3Cue::SetMatrixCoefficients チャンネル マップとチャンネル ボリュームを操作する IXACTCue メソッドは、IXACT3Cue::SetMatrixCoefficients メソッドに置き換えられています。SetMatrixCoefficients メソッドは、IXACTCue::SetChannelMap メソッドと IXACTCue::SetChannelVolume メソッドに渡されていたチャンネル マップとチャンネル ボリュームの組み合わせとなる行列係数テーブルを受け取ります。この行列係数テーブルは、各デスティネーション チャンネルにある各ソース チャンネルのボリューム レベルを表す配列です。ソース チャンネルがテーブルの列インデックスになり、デスティネーション チャンネルが行インデックスになります。テーブルには、少なくとも uSrcChannelCount × uDstChannelCount 個の要素が必要です。 |
| IXACTCue::SetVoiceOutput | 同等のメソッドはありません。 |
| IXACTCue::SetVoiceOutputVolume | 同等のメソッドはありません。 |
関数
| XACT 関数 | XACT3 関数 |
|---|---|
| XACTCreateEngine | XACT3CreateEngine |
構造体
インターフェイス ポインターを含むすべての XACT 構造体は、インターフェイスのセクションに記載されているように、XACT3 インターフェイスへのポインターを使用するように更新されています。
また、XACT3 XACT_RUNTIME_PARAMETERS 構造体に、2 つの新しいメンバー、pXAudio2 と pMasteringVoice が追加されました。これらの新しいメンバーは、XACT3 で使用する XAudio2 および MasteringVoice オブジェクトを指定し、これらが NULL の場合は新しいオブジェクトが作成されます。