Platform SDK: DirectX

DMUS_PLAYMODE_FLAGS

DMUS_PLAYMODE_FLAGS は、基本的な演奏モードのさまざまな構造体で使われる。演奏モードは、ミュージック値を MIDI 音符にどのように転調するかを決定する。

typedef enum enumDMUS_PLAYMODE_FLAGS {
    DMUS_PLAYMODE_KEY_ROOT          = 1,
    DMUS_PLAYMODE_CHORD_ROOT        = 2,
    DMUS_PLAYMODE_SCALE_INTERVALS   = 4,
    DMUS_PLAYMODE_CHORD_INTERVALS   = 8,
    DMUS_PLAYMODE_NONE              = 16,
} DMUS_PLAYMODE_FLAGS;
DMUS_PLAYMODE_KEY_ROOT
キーのルート音上に転調する。
DMUS_PLAYMODE_CHORD_ROOT
コードのルート音上に転調する。
DMUS_PLAYMODE_SCALE_INTERVALS
スケール パターンのスケールの音程を使う。
DMUS_PLAYMODE_CHORD_INTERVALS
コード パターンのコードの音程を使う。
DMUS_PLAYMODE_NONE
モードなし。親パートのモードを使う必要があることを示す。

注意

以下に示す定義済みの値は、演奏モード フラグの組み合わせを表す。

DMUS_PLAYMODE_ALWAYSPLAY
DMUS_PLAYMODE_SCALE_INTERVALS、DMUS_PLAYMODE_CHORD_INTERVALS、および DMUS_PLAYMODE_CHORD_ROOT の組み合わせ。コードの最高音より高い音符を演奏することが望ましい場合、このモードは、スケールの音程を使うことによって音符の位置を検索する。つまり、このモードは通常の演奏モードと旋律系の演奏モードの組み合わせであり、通常モードで失敗すると 2 度目の試行が旋律系モードで強制的に行われる。
DMUS_PLAYMODE_FIXED
ミュージック値を MIDI 値として解釈する。これは 0 として定義され、その他のフラグがないことを意味する。このフラグは、ドラム、サウンド エフェクト、およびコードまたはスケールによって転調してはならない、シーケンス化された音符について使われる。
DMUS_PLAYMODE_FIXEDTOCHORD
DMUS_PLAYMODE_CHORD_ROOT と同じ。ミュージック値は固定の MIDI 値であるが、コードのルート音上に転調される。
DMUS_PLAYMODE_FIXEDTOKEY
DMUS_PLAYMODE_KEY_ROOT と同じ。ミュージック値は固定の MIDI 値であるが、キーのルート音上に転調される。
DMUS_PLAYMODE_MELODIC
DMUS_PLAYMODE_CHORD_ROOT と DMUS_PLAYMODE_SCALE_INTERVALS の組み合わせ。コードのルート音は使われるが、音符はスケール内の音程だけを追う。キーのルート音とコードの音程は無視される。これは、コードのルート音を基準にして演奏される旋律系のラインにとって便利である。
DMUS_PLAYMODE_NORMALCHORD
DMUS_PLAYMODE_CHORD_ROOT と DMUS_PLAYMODE_CHORD_INTERVALS の組み合わせ。これは一般的な再生モードである。音符はコード内の音程を追う。コードはコードのルート音に基づいている。ミュージック値にスケール要素がある場合、ほかの音程はスケールから取り出され、追加される。コードがミュージック値のコード要素と一致する音程を持っていない場合、音符は無音である。
DMUS_PLAYMODE_PEDALPOINT
DMUS_PLAYMODE_KEY_ROOT と DMUS_PLAYMODE_SCALE_INTERVALS の組み合わせ。キーのルート音は使われるが、音符はスケール内の音程だけを追う。コードのルート音と音程は無視される。これは、キーのルート音を基準にして演奏される旋律系のラインにとって便利である。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicPerformance::MIDIToMusicIDirectMusicPerformance::MusicToMIDIDMUS_NOTE_PMSGDMUS_IO_STYLENOTEDMUS_IO_STYLEPARTミュージック値と MIDI 音符