Platform SDK: DirectX

DMUS_IO_CURVE_ITEM

DMUS_IO_CURVE_ITEM 構造体は、トラック内の曲線イベントに関する情報を保持する。この構造体は、シーケンス トラック リスト内で使われる。

typedef struct _DMUS_IO_CURVE_ITEM {
    MUSIC_TIME  mtStart;
    MUSIC_TIME  mtDuration;
    MUSIC_TIME  mtResetDuration;
    DWORD       dwPChannel;
    short       nOffset;
    short       nStartValue;
    short       nEndValue;
    short       nResetValue;
    BYTE        bType;
    BYTE        bCurveShape;
    BYTE        bCCData;
    BYTE        bFlags;
} DMUS_IO_CURVE_ITEM;
mtStart
曲線の開始タイム。
mtDuration
曲線の持続時間。
mtResetDuration
曲線が終了した後、リセット値を設定するまでの時間。
dwPChannel
イベントのパフォーマンス チャンネル。
nOffset
曲線が発生するグリッド境界からのオフセット。ミュージック タイムで表される。MIDI 曲線はロード時に最も近いグリッドに関連付けられるため、この値は正または負でもよい。
nStartValue
開始値。
nEndValue
終了値。
nResetValue
曲線のリセット値。mtResetDuration の経過後、またはフラッシュ (解放) や無効化の際に設定される。
bType
曲線のタイプ。次のタイプが定義されている。
DMUS_CURVET_CCCURVE
コンティニュアス コントローラ曲線 (MIDI Control Change チャンネル発音メッセージ。ステータス バイトは &HBnn はチャンネル番号を表す)。
DMUS_CURVET_MATCURVE
モノフォニック アフタータッチ曲線 (MIDI Channel Pressure チャンネル発音メッセージ。ステータス バイトは &HDn)。
DMUS_CURVET_PATCURVE
ポリフォニック アフタータッチ曲線 (MIDI Poly Key Pressure チャンネル発音メッセージ。ステータス バイトは &HDn)。
DMUS_CURVET_PBCURVE
ピッチベンド曲線 (MIDI Pitch Bend チャンネル発音メッセージ。ステータス バイトは &HEn)。
bCurveShape
曲線のシェイプ。次のシェイプが定義されている。
DMUS_CURVES_EXP
指数曲線シェイプ。
DMUS_CURVES_INSTANT
即時曲線シェイプ (曲線の開始と終了がほとんど同時に発生する)。
DMUS_CURVES_LINEAR
線状曲線シェイプ。
DMUS_CURVES_LOG
対数曲線シェイプ。
DMUS_CURVES_SINE
正弦曲線シェイプ。
bCCData
コントロール チェンジ タイプの場合は、CC 番号を指定する。
bFlags
デフォルトのタイムに達したとき、または移行部が原因で無効化が発生したときに nResetValue を設定しなければならない場合は、この値を 1 に設定する。この値を 0 に設定した場合は、曲線は新しい値に永続的にとどまる。他のすべてのビットは予約されている。

動作環境

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

参照

DMUS_IO_SEQ_ITEM