IDirectMusicComposer::ComposeSegmentFromShape
This method creates an original segment from a style and a chord map, 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
Chord map from which to create the segment. - ppSegment
Address of a variable to receive 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.
Requirements
OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.
See Also
DMUS_SHAPET_TYPES | IDirectMusicComposer::ComposeSegmentFromTemplate | IDirectMusicComposer::ComposeTemplateFromShape
Last updated on Monday, April 12, 2004
© 1992-2002 Microsoft Corporation. All rights reserved.