Platform SDK: DirectX

スタイルの使い方

DirectMusicStyle オブジェクトは、音楽パターンの集まりを表す。通常は、装飾とモチーフ、拍子記号、テンポ、およびバンドが含まれる。基本的なリズムと、各音色パートで演奏される音符が定義される。

DirectMusicStyle オブジェクトは、スタイル ファイルかセクション ファイル、またはリソースから取得できる。詳細については、「DirectMusic ローダー」および「アレンジ用のミュージック ファイル」を参照すること。

スタイル単独では、実行時にミュージック セグメントを作成するのに十分な情報を備えていない。スタイルのほかに、コード マップ (コード進行のマップ) と、演奏時にグルーブ レベルと装飾を設定するコマンド トラックの、2 つのコンポーネントが必要となる。コマンド トラックはテンプレートから取り出すか、実行時にシェイプから生成する。コード マップは、通常はコード マップ ファイルかリソースから取得する。

[C++]

テンプレートに基づき、コマンド トラックを使ってセグメントを作成するには、IDirectMusicComposer::ComposeSegmentFromTemplate メソッドを呼び出す (「テンプレートの使い方」を参照すること)。

シェイプに基づいてセグメントを作成するには、IDirectMusicComposer::ComposeSegmentFromShape メソッドを呼び出す。スタイルへのポインタとコード マップへのポインタ、および作成されたセグメントへのポインタを受け取る変数を指定する。また、コード変更の頻度を制御する和音進行のレート、およびグルーブ レベルと装飾の進行を決定するシェイプ定数も指定する。

[Visual Basic]

テンプレートに基づき、コマンド トラックを使ってセグメントを作成するには、DirectMusicComposer.ComposeSegmentFromTemplate メソッドを呼び出す (「テンプレートの使い方」を参照すること)。

シェイプに基づいてセグメントを作成するには、DirectMusicComposer.ComposeSegmentFromShape メソッドを呼び出す。スタイルとコード マップへのポインタ、および作成されたセグメントへのポインタを受け取る変数を指定する。また、コード変更の頻度を制御する和音進行のレート、およびグルーブ レベルと装飾の進行を決定するシェイプ定数も指定する。