Microsoft DirectX 8.1 (Visual Basic)

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

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