DirectMusicComposer.ComposeSegmentFromShape
The DirectMusicComposer.ComposeSegmentFromShape 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.
object.ComposeSegmentFromShape(style As DirectMusicStyle, _
numberOfMeasures As Integer, _
shape As Integer, _
activity As Integer, _
bIntro As Boolean, _
bEnd As Boolean, _
chordmap As DirectMusicChordMap) As DirectMusicSegment
Parameters
- object
- Object expression that resolves to a DirectMusicComposer object.
- style
- Style from which to compose the segment.
- numberOfMeasures
- Length, in measures, of the segment to be composed.
- shape
- Shape of the segment to be composed, based on changes in the groove level. Possible values are of the CONST_DMUS_SHAPET_TYPES enumeration.
- activity
- Rate of harmonic motion. Valid values are from 0 through 3. Lower values mean more chord changes.
- bIntro
- True if an introduction is to be composed for the segment, False otherwise.
- bEnd
- True if an ending is to be composed for the segment, False otherwise.
- chordmap
- DirectMusicChordmap from which to create the segment.
Return Values
If the method succeeds, it returns a DirectMusicSegment object.
Error Codes
If the method fails, it raises an error, and Err.Number is set.
See Also
DirectMusicComposer.ComposeSegmentFromTemplate, DirectMusicComposer.ComposeTemplateFromShape