Platform SDK: DirectX

DirectMusicComposer.ComposeTransition

DirectMusicComposer.ComposeTransition メソッドは、あるセクション セグメントからほかのセクション セグメントへの移行部をアレンジする。

object.ComposeTransition(fromSeg As DirectMusicSegment, _
    toSeg As DirectMusicSegment, _
    mtTime As Long, _
    lCommand As Long, _
    lFlags As Long, _
    chordmap As DirectMusicChordMap) _
    As DirectMusicSegment 

パラメータ

object
DirectMusicComposer オブジェクトを表すオブジェクト式。
fromSeg
移行部の作成に使用するセクション セグメントを表す DirectMusicSegment オブジェクト。
toSeg
移行先セクション。移行部はこのセクションへ円滑に移行する。lFlags が DMUS_COMPOSEF_MODULATE を含んでいない場合、NULL でもよい。
mtTime
fromSeg のセクション内で移行部のアレンジを開始するタイム。
lCommand
移行部を作成するときに使われる装飾。「CONST_DMUS_COMMANDT_TYPES」を参照すること。この値が DMUS_COMMANDT_ENDANDINTRO の場合、メソッドは、fromSeg の終了部と toSeg の導入部を含むセグメントをアレンジする。
lFlags
コンポーザ オプション。このパラメータは、CONST_DMUS_COMPOSEF_FLAGS 列挙型の 1 つまたは複数の値を保持していてもよい。
chordmap
移行部のアレンジに使用するコード マップを表す DirectMusicChordmap オブジェクト。「注意」を参照すること。

戻り値

成功すれば DirectMusicSegment オブジェクトを返す。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_INVALIDARG
DMUS_E_OUTOFMEMORY

注意

chordmap の値は NULL でもよい。値が NULL の場合、コード マップ トラックからコード マップを取得する試みが行われる。最初に toSeg、次に fromSeg が試される。どのセグメントにもコード マップ トラックが含まれない場合は、mtTimefromSeg 内で発生するコードが移行部のコードとして使用される。

コンポーザは、最初に fromSeg 内、次に toSeg 内でテンポを探す。どのセグメントにもテンポ トラックがない場合、移行部セグメントのテンポはスタイルから取得される。

参照

DirectMusicComposer.AutoTransition