Mixer_AddToMixer
method
function Mixer_AddToMixer (SourceUniqueID: LongInt; SourceVideoInput: LongInt; MosaicLine: LongInt; MosaicColumn: LongInt; AlternatedGroup: LongInt; AlternatedTimeIntervalInMs: LongInt; ReplacePreviouslyAdded: Boolean; CanEraseBackground: Boolean): LongInt;
System::LongInt __fastcall Mixer_AddToMixer(System::LongInt SourceUniqueID, System::LongInt SourceVideoInput, System::LongInt MosaicLine, System::LongInt MosaicColumn, System::LongInt AlternatedGroup, System::LongInt AlternatedTimeIntervalInMs, bool ReplacePreviouslyAdded, bool CanEraseBackground);
public int Mixer_AddToMixer(int SourceUniqueID, int SourceVideoInput, int MosaicLine, int MosaicColumn, int AlternatedGroup, int AlternatedTimeIntervalInMs, bool ReplacePreviouslyAdded, bool CanEraseBackground);
Public Function Mixer_AddToMixer(SourceUniqueID As Integer, SourceVideoInput As Integer, MosaicLine As Integer, MosaicColumn As Integer, AlternatedGroup As Integer, AlternatedTimeIntervalInMs As Integer, ReplacePreviouslyAdded As Boolean, CanEraseBackground As Boolean) As Integer
int Mixer_AddToMixer (int SourceUniqueID, int SourceVideoInput, int MosaicLine, int MosaicColumn, int AlternatedGroup, int AlternatedTimeIntervalInMs, BOOL ReplacePreviouslyAdded, BOOL CanEraseBackground);
Used to associate 2 TVideoGrabber components in Mixer mode. This function is invoked on the mixer component to associate a source TVideoGrabber component in Mixer mode (the mixer component must have been set in this mode by setting VideoSource = vs_Mixer). You will find sample code of this function in the "How to mix several video sources into one a single one" chapter.
Parameters:
SourceUniqueID: UniqueID of the source component.
SourceVideoInput: not used yet, set it to 0.
MosaicLine: line where the source video must be placed when displaying several sources on a mosaic layout (set to 0 if the mosaic layout is not used).
MosaicColumn: column where the source video must be placed when displaying several sources on a mosaic layout (set to 0 if the mosaic layout is not used).
AlternatedGroup: group in which the source video will be displayed alternatively. You can specify any number. The rule is: all sources associated to this mixer with this group number will be displayed at the same time, and never displayed at the same time as other sources associated to this mixer with other group numbers.
AlternatedTimeIntervalInMs: duration of display of the sources having this group number in the mixer, expressed in milliseconds. Remark: if several sources are associated to a mixer with the same group number but not the same duration, only one of these durations will be taken into account when this group is displayed; therefore, to prevent confusion, each source of a given group should logically be associated to a mixer with the same duration.
ReplacePreviouslyAdded: specifies if invoking Mixer_AddToMixer on a given video source replaces any previous Mixer_AddToMixer setting already set. Recommended value: TRUE.
EraseBackground: specifies if the background must be erased on the mixer when Mixer_AddToMixer is invoked while the mixer is running. Recommended value: TRUE.
Return value: an identifier that may be used to remove the current Mixer_AddToMixer setting by invoking Mixer_RemoveFromMixer.