IDirectMusicComposer8::ComposeSegmentFromShape
Creates an original segment from a style and a chordmap, based on a predefined shape. The shape represents the way chords and embellishments occur over time across the segment.
HRESULT ComposeSegmentFromShape(
IDirectMusicStyle* pStyle,
WORD wNumMeasures,
WORD wShape,
WORD wActivity,
BOOL fIntro,
BOOL fEnd,
IDirectMusicChordMap* pChordMap,
IDirectMusicSegment** ppSegment
);
Parameters
- pStyle
- Style from which to compose the segment.
- wNumMeasures
- Length, in measures, of the segment to be composed.
- wShape
- Shape of the segment to be composed. Possible values are of the DMUS_SHAPET_TYPES enumerated type.
- wActivity
- Rate of harmonic motion. Valid values are from 0 through 3. Lower values mean more chord changes.
- fIntro
- TRUE if an introduction is to be composed for the segment.
- fEnd
- TRUE if an ending is to be composed for the segment.
- pChordMap
- Pointer to the IDirectMusicChordMap8 interface of the chordmap from which to create the segment.
- ppSegment
- Address of a variable that receives a pointer to the created segment.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return E_POINTER.
Header: Declared in dmusici.h.
See Also
IDirectMusicComposer8::ComposeSegmentFromTemplate, IDirectMusicComposer8::ComposeTemplateFromShape