Microsoft DirectX 8.0 (Visual Basic)

DirectMusicComposer8.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.

object.ComposeSegmentFromShape(style As DirectMusicStyle8, _
    numberOfMeasures As Integer, _
    shape As Integer, _
    activity As Integer, _
    bIntro As Boolean, _
    bEnd As Boolean, _
    chordmap As DirectMusicChordMap8 _
) As DirectMusicSegment8

Parts

object
Resolves to a DirectMusicComposer8 object.
style
DirectMusicStyle8 object that specifies the 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
DirectMusicChordMap8 object from which to create the segment.

Return Values

Returns a DirectMusicSegment8 object.

Error Codes

If the method fails, it raises an error, and Err.Number is set.

See Also

DirectMusicComposer8.ComposeSegmentFromTemplate, DirectMusicComposer8.ComposeTemplateFromShape