IMVVMRMixerControl

IMVVMRMixerControl Interface wrapps the IVMRMixerControl and IVMRMixerControl9 interface from the VMR-7 and VMR-9 direct show filter.

Look at the DirectShow SDK documentation for more details about the VMRs and these interfaces and methods.

Method IMVVMRMixerControl::GetAlpha

Declaration: Function GetAlpha(StreamID As Long) As Single

The GetAlpha method retrieves the constant alpha value that is applied to this video stream.

Parameter:

StreamID

Stream index.

Prototype:

HRESULT GetAlpha(LONG StreamID, float* value);

Method IMVVMRMixerControl::GetBackgroundClr

Declaration: Function GetBackgroundClr As Long

Gets the current background colour on the output rectangle.

Prototype:

HRESULT GetBackgroundClr(LONG* value);

Method IMVVMRMixerControl::GetMixingPrefs

Declaration: Function GetMixingPrefs As Long

Retrieves the mixing preferences for the stream.

Prototype:

HRESULT GetMixingPrefs(LONG* value);

Method IMVVMRMixerControl::GetOutputRect

Declaration: Sub GetOutputRect(StreamID As Long, NormLeft As Single, NormTop As Single, NormRight As Single, NormBottom As Single)

The GetOutputRect method retrieves the position of this stream's video rectangle within the composition rectangle.

Parameter:

	StreamID	Stream index.
	NormLeft	Normalised left position.
	NormTop	Normalised top position.
	NormRight	Normalised right position.
	NormBottom	Normalised bottom position.

Prototype:

HRESULT GetOutputRect(LONG StreamID, float* NormLeft, float* NormTop, float* NormRight, float* NormBottom);

Method IMVVMRMixerControl::GetProcAmpControl

Declaration: Sub GetProcAmpControl(StreamID As Long, Flags As Long, Contrast As Single, Brightness As Single, Hue As Single, Saturation As Single)

The GetProcAmpControl method retrieves the current image adjustment settings for the VMR-9. Image adjustment includes brightness, contrast, hue, and saturation, and is performed by the graphics device.

Parameter:

	StreamID	Stream index.
	Flags	Flags.
	Contrast	Contrast value.
	Brightness	Brightness value.
	Hue	Hue value.
	Saturation	Saturation value.

Prototype:

HRESULT GetProcAmpControl(LONG StreamID, LONG Flags, float* Contrast, float* Brightness, float* Hue, float* Saturation);

Method IMVVMRMixerControl::GetProcAmpControlRange

Declaration: Sub GetProcAmpControlRange(StreamID As Long, Flags As Long, MinValue As Single, MaxValue As Single, DefaultValue As Single, StepSize As Single)

The GetProcAmpControlRange method retrieves the range of values for an image adjustment setting, such as brightness, contrast, hue, or saturation. Image adjustment is performed by the graphics device, so the valid range depends on the graphics driver.

Parameter:

	StreamID	Stream index.
	Flags	Flags
	MinValue	Min value.
	MaxValue	Max value.
	DefaultValue	Default value
	StepSize	Step size.

Prototype:

HRESULT GetProcAmpControlRange(LONG StreamID, LONG Flags, float* MinValue, float* MaxValue, float* DefaultValue, float* StepSize);

Method IMVVMRMixerControl::GetZOrder

Declaration: Function GetZOrder(StreamID As Long) As Long

The GetZOrder method retrieves this video stream's position in the Z order.

Parameter:

StreamID

stream index.

Prototype:

HRESULT GetZOrder(LONG StreamID, LONG* value);

Method IMVVMRMixerControl::SetAlpha

Declaration: Sub SetAlpha(StreamID As Long, Alpha As Single)

The SetAlpha method sets a constant alpha value that is applied to this video stream.

Parameter:

	StreamID	Stream index.
	Alpha	Alpha value.

Prototype:

HRESULT SetAlpha(LONG StreamID, SINGLE Alpha);

Method IMVVMRMixerControl::SetBackgroundClr

Declaration: Sub SetBackgroundClr(ClrBkg As Long)

Sets the background colour of the output rectangle.

Parameter:

ClrBkg

Background colour

Prototype:

HRESULT SetBackgroundClr(LONG ClrBkg);

Method IMVVMRMixerControl::SetMixingPrefs

Declaration: Sub SetMixingPrefs(MixerPrefs As Long)

Sets the mixing preferences for the stream.

Parameter:

MixerPrefs

Mixer preferences.

Prototype:

HRESULT SetMixingPrefs(LONG MixerPrefs);

Method IMVVMRMixerControl::SetOutputRect

Declaration: Sub SetOutputRect(StreamID As Long, NormLeft As Single, NormTop As Single, NormRight As Single, NormBottom As Single)

The SetOutputRect method sets the position of this stream within the composition rectangle

Parameter:

	StreamID	Stream it
	NormLeft	Normalised left position.
	NormTop	Normalised top position.
	NormRight	Normalised right position.
	NormBottom	Normalised bottom position.

Prototype:

HRESULT SetOutputRect(LONG StreamID, float NormLeft, float NormTop, float NormRight, float NormBottom);

Method IMVVMRMixerControl::SetProcAmpControl

Declaration: Sub SetProcAmpControl(StreamID As Long, Flags As Long, Contrast As Single, Brightness As Single, Hue As Single, Saturation As Single)

The SetProcAmpControl method sets the image adjustment for the VMR-9. Image adjustment includes brightness, contrast, hue, and saturation, and is performed by the graphics device.

Parameter:

	StreamID	Stream index.
	Flags	Flags.
	Contrast	Contrast value.
	Brightness	Brightness value.
	Hue	Hue value.
	Saturation	Saturation value.

Prototype:

HRESULT SetProcAmpControl(LONG StreamID, LONG Flags, SINGLE Contrast, SINGLE Brightness, SINGLE Hue, SINGLE Saturation);

Method IMVVMRMixerControl::SetZOrder

Declaration: Sub SetZOrder(StreamID As Long, ZOrder As Long)

The SetZOrder method sets this video stream's position in the Z-order; larger values are further away.

Parameter:

	StreamID	Stream index.
	ZOrder	Z-Order value.

Prototype:

HRESULT SetZOrder(LONG StreamID, LONG ZOrder);