Microsoft DirectX 8.0 (Visual Basic) |
パフォーマンスのプライマリ セグメント (または無音) 内部からほかのセグメントへのトランジションをアレンジし、演奏の目的でそのトランジションとセカンダリ セグメントを挿入する。
object.AutoTransition( _ performance As DirectMusicPerformance8, _ toSeg As DirectMusicSegment8, _ lCommand As Long, _ lFlags As Long, _ chordmap As DirectMusicChordMap8 _ ) As DirectMusicSegment8
トランジション セグメントのアレンジに利用できるスタイルがほかにない場合に限り、DirectMusicSegment8 オブジェクトを返す。「注意」を参照すること。
失敗した場合はエラーが発生し、Err.Number が設定される。
lFlags が DMUS_COMPOSEF_MODULATE を含んでいない場合、toSeg の値は NULL でもよい。toSeg が NULL またはスタイル トラックを含まないセグメントの場合、イントロの装飾は無効になる。演奏中のセグメントがない場合またはセグメントがスタイル トラックを含んでいない場合は、フィル、ブレーク、エンド、およびグルーブの装飾が無効になる。
演奏中のセグメントまたは segment1 のどちらも、NULL またはスタイル トラックを含まないセグメント (MIDI ファイルに基づくセグメントなど) を指定できる。その場合、すべての装飾は無効になり、演奏中のセグメントと segment1 の間でトランジションは行われない。メソッドは NULL を返すが、成功して、segment1 によって表されるセグメントを挿入する。
chordmap の値は NULL でもよい。値が NULL の場合、コード マップ トラックからコード マップを取得する試みが行われる。最初に segment1、次にパフォーマンスのプライマリ セグメントが試される。どのセグメントにもコード マップ トラックが含まれない場合は、現在のタイムにプライマリ セグメント内で発生するコードがトランジションのコードとして使われる。