diff options
Diffstat (limited to 'sdk/dx8sdk/Include/mpconfig.h')
| -rw-r--r-- | sdk/dx8sdk/Include/mpconfig.h | 144 |
1 files changed, 144 insertions, 0 deletions
diff --git a/sdk/dx8sdk/Include/mpconfig.h b/sdk/dx8sdk/Include/mpconfig.h new file mode 100644 index 00000000..49f8cf10 --- /dev/null +++ b/sdk/dx8sdk/Include/mpconfig.h @@ -0,0 +1,144 @@ +//------------------------------------------------------------------------------ +// File: MPConfig.h +// +// Desc: +// +// Copyright (c) 1997-2001, Microsoft Corporation. All rights reserved. +//------------------------------------------------------------------------------ + + +#ifndef __IMPConfig__ +#define __IMPConfig__ + +#ifdef __cplusplus +extern "C" { +#endif + +typedef enum _AM_ASPECT_RATIO_MODE +{ + AM_ARMODE_STRETCHED, // don't do any aspect ratio correction + AM_ARMODE_LETTER_BOX, // letter box the video, paint background color in the excess region + AM_ARMODE_CROP, // crop the video to the right aspect ratio + AM_ARMODE_STRETCHED_AS_PRIMARY // follow whatever the primary stream does (in terms of the mode as well as pict-aspect-ratio values) +} AM_ASPECT_RATIO_MODE; + + +DECLARE_INTERFACE_(IMixerPinConfig, IUnknown) +{ + // this function sets the position of the stream in the display window, assuming + // that the window coordinates are {0, 0, 10000, 10000}. Thus giving arguments + // (0, 0, 5000, 5000) will put the stream in the top-left quarter. Any value greater + // than 10000 is invalid. + STDMETHOD (SetRelativePosition)(THIS_ + IN DWORD dwLeft, + IN DWORD dwTop, + IN DWORD dwRight, + IN DWORD dwBottom + ) PURE; + + // this function gets the position of the stream in the display window, assuming + // that the window coordinates are {0, 0, 10000, 10000}. Thus if the values returned + // are (0, 0, 5000, 5000), then it means that the stream is in the top-left quarter. + STDMETHOD (GetRelativePosition)(THIS_ + OUT DWORD *pdwLeft, + OUT DWORD *pdwTop, + OUT DWORD *pdwRight, + OUT DWORD *pdwBottom + ) PURE; + + // this function sets the ZOrder of the stream. The ZOrder of 0 is the closest + // to the eyes of the user, and increasing values imply greater distance. + STDMETHOD (SetZOrder)(THIS_ + IN DWORD dwZOrder + ) PURE; + + + // this function gets the ZOrder of the stream. The ZOrder of 0 is the closest + // to the eyes of the user, and increasing values imply greater distance. + STDMETHOD (GetZOrder)(THIS_ + OUT DWORD *pdwZOrder + ) PURE; + + // this function sets the colorkey being used by the stream. Setting this value on the + // primary stream sets the destination colorkey being used by the overlay surface. Setting + // this value on the secondary pin makes sense only if the stream is transparent. By default + // the destination colorkey is used as the colorkey for all transparent (secondary) streams. + STDMETHOD (SetColorKey)(THIS_ + IN COLORKEY *pColorKey + ) PURE; + + // this function gets the colorkey being used by the stream. Getting this value on the + // primary stream gets the destination colorkey being used by the overlay surface. Getting + // this value on the secondary pin returns the colorkey being used by that particular stream. + // When using this method, you are allowed to pass NULL for either pColorKey or pColor but + // not both. + STDMETHOD (GetColorKey)(THIS_ + OUT COLORKEY *pColorKey, + OUT DWORD *pColor + ) PURE; + + // this function sets the blending parameter which in turn defines, how the secondary stream + // is going to be blended with the primary stream. A value of 0 makes the secondary stream + // invisible, a value of 255 makes the primary stream invisible (in that region only ofcourse), + // and any value inbetween, say x, blends the secondary and primary streams in the ratio x : (255-x). + // If no value is set, the default is 255. + // Any value less than 0 or greater than 255 is invalid. Calling this function on the primary + // stream would result in a return value of E_UNEXPECTED. + STDMETHOD (SetBlendingParameter)(THIS_ + IN DWORD dwBlendingParameter + ) PURE; + + // this function gets the blending parameter which in turn defines, how the secondary stream + // is currently being blended with the primary stream. + STDMETHOD (GetBlendingParameter)(THIS_ + OUT DWORD *pdwBlendingParameter + ) PURE; + + + // this function is used to set the Aspect Ratio Correction mode on the pin. + // If the mode is set to letter box, black color is painted on the excess region + STDMETHOD (SetAspectRatioMode)(THIS_ + IN AM_ASPECT_RATIO_MODE amAspectRatioMode + ) PURE; + + // this function is used to get the Aspect Ratio Correction mode on the pin. + STDMETHOD (GetAspectRatioMode)(THIS_ + OUT AM_ASPECT_RATIO_MODE* pamAspectRatioMode + ) PURE; + + // this function sets the stream to be transparent. That means that the stream is not going + // to occupy the whole of the rectangle (specified by SetRelativePosition), some of the region + // is going to be transparent i.e. the stream underneath, is going to see through. + // Calling this function on the primary stream would result in a return value of E_UNEXPECTED. + STDMETHOD (SetStreamTransparent)(THIS_ + IN BOOL bStreamTransparent + ) PURE; + + // this function is used to tell whether the stream is transparent or not. + STDMETHOD (GetStreamTransparent)(THIS_ + OUT BOOL *pbStreamTransparent + ) PURE; +}; + + +DECLARE_INTERFACE_(IMixerPinConfig2, IMixerPinConfig) +{ + // this functions sets the color-controls, if the vga chip supports it. + STDMETHOD (SetOverlaySurfaceColorControls)(THIS_ + IN LPDDCOLORCONTROL pColorControl + ) PURE; + + // this functions gets the color-controls. It also returns the capability of the vga hardware + // in the dwFlags value of the struct. + STDMETHOD (GetOverlaySurfaceColorControls)(THIS_ + OUT LPDDCOLORCONTROL pColorControl + ) PURE; +}; + +#ifdef __cplusplus +} +#endif + + +#endif // #define __IMPConfig__ + |