Microsoft DirectX 8.0 (Visual Basic)

DirectMusicComposer8.AutoTransition

パフォーマンスのプライマリ セグメント (または無音) 内部からほかのセグメントへのトランジションをアレンジし、演奏の目的でそのトランジションとセカンダリ セグメントを挿入する。

object.AutoTransition( _ 
    performance As DirectMusicPerformance8, _ 
    toSeg As DirectMusicSegment8, _ 
    lCommand As Long, _ 
    lFlags As Long, _ 
    chordmap As DirectMusicChordMap8 _ 
) As DirectMusicSegment8

指定項目

object
DirectMusicComposer8 オブジェクトを指定する。
performance
トランジションに関係する DirectMusicPerformance8 オブジェクト。
toSeg
移行先セクション。トランジションはこのセクションへ円滑に移行する。「注意」を参照すること。
lCommand
トランジションを作成するときに使われる装飾。「CONST_DMUS_COMMANDT_TYPES」を参照すること。この値が DMUS_COMMANDT_ENDANDINTRO の場合、メソッドは、プライマリ セグメントのエンディングと toSeg のイントロを含むセグメントをアレンジする。
lFlags
コンポーザ オプション。「CONST_DMUS_COMPOSEF_FLAGS」を参照すること。
chordmap
トランジションをアレンジするときに使用する DirectMusicChordMap8 オブジェクト。

戻り値

トランジション セグメントのアレンジに利用できるスタイルがほかにない場合に限り、DirectMusicSegment8 オブジェクトを返す。「注意」を参照すること。

エラー コード

失敗した場合はエラーが発生し、Err.Number が設定される。

注意

lFlags が DMUS_COMPOSEF_MODULATE を含んでいない場合、toSeg の値は NULL でもよい。toSeg が NULL またはスタイル トラックを含まないセグメントの場合、イントロの装飾は無効になる。演奏中のセグメントがない場合またはセグメントがスタイル トラックを含んでいない場合は、フィル、ブレーク、エンド、およびグルーブの装飾が無効になる。

演奏中のセグメントまたは segment1 のどちらも、NULL またはスタイル トラックを含まないセグメント (MIDI ファイルに基づくセグメントなど) を指定できる。その場合、すべての装飾は無効になり、演奏中のセグメントと segment1 の間でトランジションは行われない。メソッドは NULL を返すが、成功して、segment1 によって表されるセグメントを挿入する。

chordmap の値は NULL でもよい。値が NULL の場合、コード マップ トラックからコード マップを取得する試みが行われる。最初に segment1、次にパフォーマンスのプライマリ セグメントが試される。どのセグメントにもコード マップ トラックが含まれない場合は、現在のタイムにプライマリ セグメント内で発生するコードがトランジションのコードとして使われる。