Platform SDK: DirectX

IDirectMusicComposer::ComposeSegmentFromShape

IDirectMusicComposer::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
セクション セグメントの作成に使うコード マップ。
ppSegment
作成されたセクション セグメントへのポインタを受け取る変数のアドレス。

戻り値

成功すれば S_OK を返す。

失敗すれば E_POINTER を返す。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicComposer::ComposeSegmentFromTemplateIDirectMusicComposer::ComposeTemplateFromShape