Microsoft DirectX 8.1 (Visual Basic)

DirectMusicSegment8

An object of the DirectMusicSegment8 class represents a single piece of music or a template.

Segments are usually loaded by calling DirectMusicLoader8.LoadSegment and DirectMusicLoader8.LoadSegmentFromResource. They can also be composed from musical elements by using methods of the DirectMusicComposer8 object, or created from existing segments by using the DirectMusicSegment8.Clone method.

The DirectMusicSegment8 class has the following methods.

Timing and looping

Method Description
GetLength Retrieves the length of the segment.
GetLoopPointStart Retrieves the point in the segment at which a repeating section ends.
GetLoopPointEnd Retrieves the point in the segment at which a repeating section starts.
GetRepeats Retrieves the number of times that the looping portion of a segment is set to repeat.
GetStartPoint Retrieves the point within the segment at which it starts playing.
SetLength Sets the length of the segment.
SetLoopPoints Sets the start and end points of a repeating section in the segment.
SetRepeats Sets the number of times that the looping portion of the segment is to repeat.
SetStartPoint Sets the point within the segment at which it starts playing.

Instruments

Method Description
ConnectToCollection Associates a segment with a DLS instrument collection.
Download Downloads band and wave data to a performance or audiopath.
Unload Unloads instruments that were downloaded to the port.

Parameters

Method Description
SetAutoDownloadEnable Enables or disables automatic downloading and unloading of instruments in the collection associated with the segment.
SetStandardMidiFile Advises DirectMusic that the segment is based on a standard MIDI file, to ensure correct playback.
SetTempoEnable Enables or disables tempo messages for the segment.
SetTimeSigEnable Enables or disables time signature messages for the segment.

Miscellaneous

Method Description
Clone Ceates a copy of all or part of the segment.
GetAudioPathConfig Retrieves an object that represents the audiopath configuration for the segment.
GetChordMap Retrieves a chordmap.
GetName Retrieves the internal name of the segment.
GetStyle Retrieves a style.