Microsoft DirectX 8.0 (C++)

DMUS_IO_TRANSITION_DEF

Not implemented in DirectX 8.0.

Describes a transition. Used in the Song Form.

typedef struct _DMUS_IO_TRANSITION_DEF {
    DWORD  dwSegmentID;
    DWORD  dwTransitionID;
    DWORD  dwPlayFlags;
} DMUS_IO_TRANSITION_DEF;

Members

dwSegmentID
Segment after the transition, or one of the following constants:
DMUS_SONG_ANYSEG
Any segment.
DMUS_SONG_NOFROMSEG
No preceding segment; the transition is an intro.
DMUS_SONG_NOSEG
No following segment; the transition is an ending.
dwTransitionID
Template segment to use for the transition.
dwPlayFlags
Flags that control how the transition is played. See DMUS_SEGF_FLAGS.

Remarks

This structure describes a valid transition from another segment to this segment. When a song segment is played with the DMUS_SEGF_AUTOTRANSITION flag, a transition segment is composed and played. To find the appropriate transition segment, the performance looks at the currently playing segment and sees if it is a segment in the song. If it is, it gets the ID of that segment and then searches for it in the transition table of the destination segment. When it finds a match in dwSourceSegment, the performance composes dwTransitionSegment and plays it, using the dwPlayFlags.

Requirements

  Header: Declared in dmusicf.h.