XMA2 エンコーダーツール

XMA2 コマンドラインエンコーダーツール (XMA2Encode) は、一連の Pulse Code Modulation (PCM) ファイルを XMA2 フォーマットに変換したり、XMA2 ファイルを PCM フォーマットに変換したりします。このツールは XBOX 360 と XBOX One の両方で使用できます。XBOX 360 の場合、ツールの出力を変更なしで使用できます。XBOX One の場合、seek テーブルをバイトスワップする必要があるかもしれません。これを行うコードは、このトピックの XBOX One フォーマットセクションにあります。

XMA2Encode の使用
XBOX One フォーマット
独自の XMA エンコーダーツールの作成

XMA2Encode の使用

以下のコードと表は、XMA2Encode の使用方法を説明しています。

列 1
`XMA2Encode file [/TargetFile xmafile][/PCMOutputFile pcmfile][/DecodeToPCM pcmfile][/BlockSize][/Quality value][/FilterHighFrequencies][/LoopWholeFile][/UseLoopPoints][/Speaker pos][/MeasureTime][/Verbose][/Help]`

オプション	説明
`file`	変換するファイルのファイル名を指定します。複数のファイル/スピーカー位置のペアを指定できます: `XMA2ENCODE pcmfile [/Speaker pos ...] [pcmfile [/Speaker pos ...] ...] [options]`。複数のファイルをエンコードする場合、XMA2Encode では、入力ファイルがすべてシングルチャネルであるか、すべてステレオで、最後のストリームがエンコードされるチャネル数に応じてモノラルまたはステレオのいずれかである必要があります。注意: XMA2Encode は、PCM フォーマットまたは XMA2 フォーマット (`/DecodeToPCM` あり) のオーディオファイルのみをサポートします。
`/TargetFile xmafile`	`xmafile` にエンコードします (許可されるターゲットファイルは 1 つのみ)。
`/PCMOutputFile pcmfile`	生成された XMA2 ファイルを `pcmfile` にデコードして戻します。このオプションを使用すると、ツールは 2 つの出力ファイル (XMA2 エンコードされたオーディオファイルと、作成したばかりの XMA2 ファイルをデコードした結果である PCM ファイル) を生成します。結果として得られる PCM ファイルは、新しい XMA2 ファイルと同じオーディオ品質を持ちます。Windows 上で XMA2 ファイルの品質をプレビューできます。
`/DecodeToPCM pcmfile`	既存の XMA2 ファイルを `pcmfile` にデコードします。
`/BlockSize`	使用する XMA2 圧縮ブロックサイズを指定します (2 KB から 8,190 KB)。既定のブロックサイズは 64 KB です。
`/Quality value`	使用する XMA2 圧縮品質レベルを指定します (1 から 100)。品質の既定値は 60 です。
`/FilterHighFrequencies`	ソースファイルの高周波数をフィルターアウトします。
`/LoopWholeFile`	ループポイントが既に存在していても、ファイル全体をループします。`LoopWholeFile` と `UseLoopPoints` は相互に排他的です。`LoopWholeFile` と `UseLoopPoints` の引数のいずれも指定されない場合、ループポイントが存在していてもファイルはループしません。
`/UseLoopPoints`	既存のループポイントがあればそれを使用します。ない場合はループしません。`LoopWholeFile` と `UseLoopPoints` は相互に排他的です。`LoopWholeFile` と `UseLoopPoints` の引数のいずれも指定されない場合、ループポイントが存在していてもファイルはループしません。
`/Speaker pos`	ソースファイルのチャネルのスピーカー割り当てを指定します。このオプションは、ファイル名の直後に配置する必要があります。`pos` は `L`、`R`、`C`、`LFE`、`LS`、`RS`、`LB`、または `RB` のいずれかです。`L` = フロント左、`R` = フロント右、`C` = フロントセンター、`LFE` = 低周波数、`LS` = 左サラウンド、`RS` = 右サラウンド、`LB` = 左バック、`RB` = 右バックを表します。注意: 入力ファイルにチャネルマスクがないか、ファイルのチャネル数と一致しない設定ビット数のチャネルマスクを持ち、`Speaker` オプションでスピーカー割り当てが指定されていない場合、結果として得られる XMA ファイルはチャネルマスク 0 を持ちます。
`/MeasureTime`	エンコードに費やした時間を表示します。
`/Verbose`	詳細出力を有効にします。
`/Help`	この使用情報を表示します。

備考

すべてのオプションは、その先頭の文字に省略できます。以下の表は、XMA2Encode がエンコードの問題を示すために出力できるエラーコードを一覧表示しています。

エラーコード	説明
0x88890001	指定されたループポイントが無効です。
0x88890002	指定されたフォーマットが無効です。
0x88890003	パラメーターが範囲外です。
0x88890004	読み取り操作が失敗しました。
0x88890005	無効な XMA フレームがありました。
0x88890006	不完全な XMA フレームがありました。
0x88890007	スタッフィングビットがゼロでした。
0x88890008	データの取得が失敗しました。

XBOX One フォーマット

XMA2Encode の出力は、XBOX One 用に ULONG バイトスワップする必要があります。入力が .wav ファイルの場合、出力は変更なしで使用できます。 seek テーブルをバイトスワップするには、次のコード行を使用します。

for(UINT32 i = 0;(i < xmaformat->BlockCount);i++)
    {
       rgpXMASeekTable[i] = _byteswap_ulong(rgpXMASeekTable[i]);
    }  

まずこのコード行をアプリに追加して機能をテストし、次にアプリで前処理が不要になるようにスワップを実行する別のツールを作成することを検討してください。

独自の XMA エンコーダーツールの作成

xmaencoder.h で定義され、xmaencoder.lib で実装されているメソッドを使用して、独自のエンコーダーツールを作成することが可能です。xmaencoder.h ファイルは既定で C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\include フォルダーにあります。xmaencoder.lib ファイルは既定で C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\lib\amd64 フォルダーにあります。ヘッダーとライブラリで利用可能な唯一のメソッドは XAudio2XMAEncoder です。ヘッダーで定義されている XMA2InMemoryEncoder および XMAInMemoryEncoder メソッド (レガシー) は使用しないでください。

このセクションの内容

XMA2 エンコーダーリファレンス xmaencoder.lib で使用可能な関数について説明します。

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

XMA2Encode の使用

備考

XBOX One フォーマット

独自の XMA エンコーダーツールの作成

このセクションの内容

関連項目

​XMA2Encode の使用

​備考

​XBOX One フォーマット

​独自の XMA エンコーダー ツールの作成

​このセクションの内容

​関連項目

XMA2Encode の使用

備考

XBOX One フォーマット

独自の XMA エンコーダーツールの作成

このセクションの内容

関連項目