Platform SDK: DirectX

DirectMusicComposer.ComposeSegmentFromTemplate

DirectMusicComposer.ComposeSegmentFromTemplate メソッドは、スタイル、コード マップ、およびテンプレートからオリジナルのセクション セグメントを作成する。

object.ComposeSegmentFromTemplate( _ 
    style As DirectMusicStyle, _
    templateSeg As DirectMusicSegment, _
    activity As Integer, _
    chordmap As DirectMusicChordMap) 
    As DirectMusicSegment

パラメータ

object
DirectMusicComposer オブジェクトを表すオブジェクト式。
style
セクション セグメントの作成に使用する DirectMusicStyle オブジェクト。
templateSeg
セクション セグメントの作成に使用するテンプレートを表す DirectMusicSegment オブジェクト。
activity
和音進行のレート。有効な値は 0 〜 3。値が低いと、コード チェンジが増える。
chordmap
セクション セグメントの作成に使用するコード マップを表す DirectMusicChordmap オブジェクト。

戻り値

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

エラー コード

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

DMUS_E_INVALIDARG

注意

style が NULL ではない場合、このスタイルはセグメントのアレンジに使用される。NULL の場合、templateSeg で指定されたテンプレートから取り出したスタイルをセグメントのアレンジに使用する。同様に、chordmap が NULL ではない場合、このコード マップはセグメントのアレンジに使用される。NULL の場合、テンプレートから取り出したコード マップをセグメントのアレンジに使用する。

style が NULL でテンプレート内にスタイル トラックが存在しない場合や、chordmap が NULL でコード マップ トラックが存在しない場合、このメソッドは DMUS_E_INVALIDARG を返す。

セクション セグメントの長さは、渡されたテンプレート セクションの長さと等しくなる。

参照

DirectMusicComposer.ComposeSegmentFromShapeDirectMusicComposer.ComposeTemplateFromShape