Platform SDK: DirectX

DirectMusicComposer.ComposeTemplateFromShape

DirectMusicComposer.ComposeTemplateFromShape メソッドは、あらかじめ定義されたシェイプに基づいて新しいテンプレート セグメントを作成する。

object.ComposeTemplateFromShape(numMeasures As Integer, _
    shape As Integer, _
    bIntro As Boolean, _
    bEnd As Boolean, _
    endLength As Integer) As DirectMusicSegment

パラメータ

object
DirectMusicComposer オブジェクトを表すオブジェクト式。
numMeasures
アレンジするセクション セグメントの長さ。小節単位で指定する。0 より大きい値でなければならない。
shape
アレンジするテンプレート セグメントのシェイプ。グルーブ レベルに基づく。CONST_DMUS_SHAPET_TYPES 列挙型のいずれかを指定する。
bIntro
テンプレート セグメントの導入部をアレンジしたい場合は True。それ以外の場合は False。
bEnd
テンプレート セグメントの終了部をアレンジしたい場合は True。それ以外の場合は False。
endLength
終了部を作成したい場合は、終了部の長さ。小節単位で指定する。bEnd が True の場合、この値は 0 より大きく、利用できる小節数以下でなければならない (つまり、導入部で使われない)。「注意」も参照すること。

戻り値

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

エラー コード

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

DMUS_E_INVALIDARG
DMUS_E_OUTOFMEMORY

注意

endLength の値は、任意のスタイル内で利用できる最長の終了部の長さを超えてはならない。この場合のスタイルとは、DirectMusicComposer.ComposeSegmentFromTemplate メソッドを使ってこのテンプレートに関連付けられる可能性のあるものを指す。終了部の演奏は、セグメントが終わる前の endLength の小節から開始される。終了部が endLength の小節の長さより短い場合、音楽は基本グルーブ レベルに戻る。

参照

DirectMusicComposer.ComposeSegmentFromShapeDirectMusicComposer.ComposeSegmentFromTemplate