Microsoft DirectX 8.0 (Visual Basic)

DirectMusicComposer8.ComposeTemplateFromShape

あらかじめ定義されたシェイプに基づいて新しいテンプレートを作成する。

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

指定項目

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

戻り値

DirectMusicSegment8 オブジェクトを返す。

エラー コード

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

DMUS_E_INVALIDARG
DMUS_E_OUTOFMEMORY

注意

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

参照

DirectMusicComposer8.ComposeSegmentFromShapeDirectMusicComposer8.ComposeSegmentFromTemplate