Microsoft DirectX 8.0 (C++)

IDirectMusicComposer8::ComposeSegmentFromShape

あらかじめ定義されたシェイプに基づいて、スタイルとコード マップからオリジナルのセクション セグメントを作成する。このシェイプは、セクション全体で時間の経過に伴ってコードと装飾を発生させる方法を表す。

HRESULT ComposeSegmentFromShape(
  IDirectMusicStyle* pStyle, 
  WORD wNumMeasures, 
  WORD wShape,
  WORD wActivity,
  BOOL fIntro,
  BOOL fEnd,
  IDirectMusicChordMap* pChordMap,
  IDirectMusicSegment** ppSegment
);

パラメータ

pStyle
セクション セグメントのアレンジに使うスタイル。
wNumMeasures
アレンジするセクション セグメントの長さ。小節単位で指定する。
wShape
アレンジするセクション セグメントのシェイプ。DMUS_SHAPET_TYPES 列挙型のいずれかの値を指定する。
wActivity
和音進行のレート。有効な値は 0 〜 3 である。値が低いと、コード チェンジが増える。
fIntro
セクション セグメントのイントロをアレンジしたい場合は TRUE を設定する。
fEnd
セクション セグメントのエンディングをアレンジしたい場合は TRUE を設定する。
pChordMap
セグメント作成の元となる、コード マップの IDirectMusicChordMap8 インターフェイスへのポインタ。
ppSegment
作成されたセグメントへのポインタを受け取る変数のアドレス。

戻り値

成功した場合は S_OK を返す。

失敗した場合は E_POINTER を返す。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicComposer8::ComposeSegmentFromTemplateIDirectMusicComposer8::ComposeTemplateFromShape