Microsoft DirectX 8.0 (Visual Basic)

DirectMusicComposer8.ComposeTransition

あるセクション セグメントから別のセクション セグメントへのトランジションをアレンジする。

object.ComposeTransition(fromSeg As DirectMusicSegment8, _
    toSeg As DirectMusicSegment8, _
    mtTime As Long, _
    lCommand As Long, _
    lFlags As Long, _
    chordmap As DirectMusicChordMap8 _
) As DirectMusicSegment8 

指定項目

object
DirectMusicComposer8 オブジェクトを指定する。
fromSeg
トランジションのアレンジ元として使用するセクション セグメントを表す DirectMusicSegment8 オブジェクト。
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
トランジションのアレンジに使用するコード マップを表す DirectMusicChordMap8 オブジェクト。「注意」を参照すること。

戻り値

DirectMusicSegment8 オブジェクトを返す。

エラー コード

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

DMUS_E_INVALIDARG
DMUS_E_OUTOFMEMORY

注意

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

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

参照

DirectMusicComposer8.AutoTransition