IDirectMusicComposer8::ComposeSegmentFromShape
The ComposeSegmentFromShape method 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.
Syntax
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 one of the error values shown in the following table.
| Return code |
| E_INVALIDARG |
| E_OUTOFMEMORY |
| E_POINTER |
Requirements
** Header:** Dmusici.h
Library: Dmcompos.dll, Dmcompod.dll
See Also