| Microsoft DirectX 8.1 (Visual Basic) |
The ComposeSegmentFromTemplate method creates an original segment from a
object.ComposeSegmentFromTemplate( _
style As DirectMusicStyle8, _
templateSeg As DirectMusicSegment8, _
activity As Integer, _
chordmap As DirectMusicChordMap8 _
) As DirectMusicSegment8
Parts
object
Resolves to a DirectMusicComposer8 object.
style
DirectMusicStyle8 object from which to create the segment.
templateSeg
DirectMusicSegment8 object representing the template from which to create the segment.
activity
Rate of harmonic motion. Valid values are from 0 through 3. Lower values mean more chord changes.
chordmap
DirectMusicChordMap8 object representing the chordmap 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 can be set to DMUS_E_INVALIDARG.
Remarks
If style is not Nothing, it is used in composing the segment; if it is Nothing, a style is retrieved from the template specified in templateSeg. Similarly, if chordmap is not Nothing, it is used in composing the segment; if it is Nothing, a chordmap is retrieved from the template.
If style is Nothing and there is no style track in the template, or chordmap is Nothing and there is no chordmap track, the method returns DMUS_E_INVALIDARG.
The length of the segment is equal to the length of the template passed in.
See Also