Share via


DMUS_COMPOSEF_FLAGS

The DMUS_COMPOSEF_FLAGS enumerated type is used in the dwFlags parameter of the IDirectMusicComposer8::ComposeTransition and IDirectMusicComposer8::AutoTransition methods.

Syntax

typedef enum enumDMUS_COMPOSEF_FLAGS { 
  DMUS_COMPOSEF_NONE                =       0,
  DMUS_COMPOSEF_ALIGN               =      0x1,
  DMUS_COMPOSEF_OVERLAP             =      0x2,
  DMUS_COMPOSEF_IMMEDIATE           =      0x4,
  DMUS_COMPOSEF_GRID                =      0x8,
  DMUS_COMPOSEF_BEAT                =     0x10,
  DMUS_COMPOSEF_MEASURE             =     0x20,
  DMUS_COMPOSEF_AFTERPREPARETIME    =     0x40,
  DMUS_COMPOSEF_VALID_START_BEAT    =     0x80,
  DMUS_COMPOSEF_VALID_START_GRID    =    0x100,
  DMUS_COMPOSEF_VALID_START_TICK    =    0x200,
  DMUS_COMPOSEF_SEGMENTEND          =    0x400,
  DMUS_COMPOSEF_MARKER              =    0x800,
  DMUS_COMPOSEF_MODULATE            =   0x1000,
  DMUS_COMPOSEF_LONG                =   0x2000,
  DMUS_COMPOSEF_ENTIRE_TRANSITION   =   0x4000,
  DMUS_COMPOSEF_1BAR_TRANSITION     =   0x8000,
  DMUS_COMPOSEF_ENTIRE_ADDITION     =  0x10000,
  DMUS_COMPOSEF_1BAR_ADDITION       =  0x20000,
  DMUS_COMPOSEF_VALID_START_MEASURE =  0x40000,
  DMUS_COMPOSEF_DEFAULT             =  0x80000,
  DMUS_COMPOSEF_NOINVALIDATE        = 0x100000,
  DMUS_COMPOSEF_USE_AUDIOPATH       = 0x200000,
  DMUS_COMPOSEF_INVALIDATE_PRI      = 0x400000 
}  DMUS_COMPOSEF_FLAGS;

Constants

DMUS_COMPOSEF_NONE

No flags. By default, the transition starts on a measure boundary.

DMUS_COMPOSEF_ALIGN

Align transition to the time signature of the currently playing segment.

DMUS_COMPOSEF_OVERLAP

Overlap the transition into pToSeg. Not implemented.

DMUS_COMPOSEF_IMMEDIATE

AutoTransition only. Start transition immediately.

DMUS_COMPOSEF_GRID

AutoTransition only. Start transition on a grid boundary.

DMUS_COMPOSEF_BEAT

AutoTransition only. Start transition on a beat boundary.

DMUS_COMPOSEF_MEASURE

AutoTransition only. Start transition on a measure boundary.

DMUS_COMPOSEF_AFTERPREPARETIME

AutoTransition only. Use the DMUS_SEGF_AFTERPREPARETIME flag when cueing the transition.

DMUS_COMPOSEF_VALID_START_BEAT

Allow the switch to occur on any beat. Used in conjunction with DMUS_COMPOSEF_ALIGN.

DMUS_COMPOSEF_VALID_START_GRID

Allow the switch to occur on any grid. Used in conjunction with DMUS_COMPOSEF_ALIGN.

DMUS_COMPOSEF_VALID_START_TICK

Allow the switch to occur at any time. Used in conjunction with DMUS_COMPOSEF_ALIGN.

DMUS_COMPOSEF_SEGMENTEND

Play the transition at the end of the current segment.

DMUS_COMPOSEF_MARKER

Play the transition at the next marker in the current segment.

DMUS_COMPOSEF_MODULATE

Compose a transition that modulates smoothly from pFromSeg to pToSeg, using the chord of pToSeg.

DMUS_COMPOSEF_LONG

Composes a long transition. If this flag is not set, the length of the transition is at most one measure unless the wCommand parameter of ComposeTransition or AutoTransition specifies an ending and the style contains an ending of greater than one measure. If this flag is set, the length of the transition increases by one measure.

DMUS_COMPOSEF_ENTIRE_TRANSITION

Include the entire transition pattern.

DMUS_COMPOSEF_1BAR_TRANSITION

Include one bar of the transition pattern.

DMUS_COMPOSEF_ENTIRE_ADDITION

Include the additional transition pattern in its entirety. Used in combination with DMUS_COMPOSEF_LONG.

DMUS_COMPOSEF_1BAR_ADDITION

Include one bar of the additional transition pattern. This is the default behavior when DMUS_COMPOSEF_LONG is specified.

DMUS_COMPOSEF_VALID_START_MEASURE

Allow the switch to occur on any bar.  Used in combination with DMUS_COMPOSEF_ALIGN.

DMUS_COMPOSEF_DEFAULT

Use the segment's default boundary.

DMUS_COMPOSEF_NOINVALIDATE

Do not invalidate segments that are playing.

DMUS_COMPOSEF_USE_AUDIOPATH

Use the audiopaths embedded in the segments.

DMUS_COMPOSEF_INVALIDATE_PRI

Invalidate only the primary segment when transitioning to a new segment.

Requirements

**  Header:** Dmusici.h

See Also

© 2004 Microsoft Corporation. All rights reserved.