Microsoft DirectX 8.1 (C++)

DMUS_IO_TRANSITION_DEF

Not implemented in DirectX 8.1.

The DMUS_IO_TRANSITION_DEF structure describes a transition. Used in the Song Form.

Syntax

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 constants shown in the following table.

Constant	Description
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.