Platform SDK: DirectX |
DirectMusicComposer.ComposeTemplateFromShape メソッドは、あらかじめ定義されたシェイプに基づいて新しいテンプレート セグメントを作成する。
object.ComposeTemplateFromShape(numMeasures As Integer, _ shape As Integer, _ bIntro As Boolean, _ bEnd As Boolean, _ endLength As Integer) As DirectMusicSegment
成功すれば DirectMusicSegment オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DMUS_E_INVALIDARG |
DMUS_E_OUTOFMEMORY |
endLength の値は、任意のスタイル内で利用できる最長の終了部の長さを超えてはならない。この場合のスタイルとは、DirectMusicComposer.ComposeSegmentFromTemplate メソッドを使ってこのテンプレートに関連付けられる可能性のあるものを指す。終了部の演奏は、セグメントが終わる前の endLength の小節から開始される。終了部が endLength の小節の長さより短い場合、音楽は基本グルーブ レベルに戻る。
DirectMusicComposer.ComposeSegmentFromShape、DirectMusicComposer.ComposeSegmentFromTemplate