summaryrefslogtreecommitdiffstats
path: root/dxsdk/Include/DShowIDL/medparam.idl
diff options
context:
space:
mode:
authoraap <aap@papnet.eu>2019-06-02 10:25:55 +0200
committerGitHub <noreply@github.com>2019-06-02 10:25:55 +0200
commit9c26e46e17b421288f7653f4c9cff81b4b6cdfb0 (patch)
treec1b34122ddd4be0461a5310c964e8218b9f5781e /dxsdk/Include/DShowIDL/medparam.idl
parentimplemented splashes; fixed zones (diff)
parentMerge branch 'master' into master (diff)
downloadre3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar.gz
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar.bz2
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar.lz
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar.xz
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.tar.zst
re3-9c26e46e17b421288f7653f4c9cff81b4b6cdfb0.zip
Diffstat (limited to 'dxsdk/Include/DShowIDL/medparam.idl')
-rw-r--r--dxsdk/Include/DShowIDL/medparam.idl228
1 files changed, 228 insertions, 0 deletions
diff --git a/dxsdk/Include/DShowIDL/medparam.idl b/dxsdk/Include/DShowIDL/medparam.idl
new file mode 100644
index 00000000..b45eab97
--- /dev/null
+++ b/dxsdk/Include/DShowIDL/medparam.idl
@@ -0,0 +1,228 @@
+//------------------------------------------------------------------------------
+// File: MedParam.idl
+//
+// Desc: Definition of the IMediaParams and associated interfaces. These
+// interfaces are designed to allow communication of curve-following
+// behaviors for parameters of objects which require dynamic changes
+// to their parameters at run time. All changes are specified by
+// timestamp and curve type to ensure the parameters can be set
+// at sufficient accuracy with predictable behavior on subsequent
+// playback of the same curves.
+//
+// Copyright (c) 1999 - 2002, Microsoft Corporation. All rights reserved.
+//------------------------------------------------------------------------------
+
+
+import "oaidl.idl";
+import "ocidl.idl";
+import "strmif.idl";
+
+
+//------------------------------------------------------------------------------
+// Define the semantic type to be used for each parameter. All values passed
+// into this interface are 32-bit floats, but the interface can specify that
+// the values must be integer, booleans, or enumerated types
+//------------------------------------------------------------------------------
+typedef float MP_DATA; // All data is 32-bit floats
+
+typedef enum _MP_Type {
+ MPT_INT, // data is signed 23 bit integer (mantissa)
+ MPT_FLOAT, // data is 32bit IEEE float
+ MPT_BOOL, // data is true or false (using ANSI C++ definition)
+ MPT_ENUM, // data is a set (represented by consecutive integers)
+ MPT_MAX,
+} MP_TYPE;
+
+const MP_DATA MPBOOL_TRUE = 1.0; // Value of true
+const MP_DATA MPBOOL_FALSE = 0.0; // Value of false
+
+
+//------------------------------------------------------------------------------
+// Define the types of curves which are supported
+//------------------------------------------------------------------------------
+typedef enum _MP_CURVE_TYPE {
+ MP_CURVE_JUMP = 0x0001, // No interpolation, just jump to next point
+ MP_CURVE_LINEAR = 0x0002, // Linear interpolation (y follows x from 0.0 to 1.0)
+ MP_CURVE_SQUARE = 0x0004, // y follow x^2 from 0.0 to 1.0
+ MP_CURVE_INVSQUARE = 0x0008, // y follows 1-(x^2) from 0.0 to 1.0
+ MP_CURVE_SINE = 0x0010, // y follows sin(x) from -pi/2 to pi/2
+} MP_CURVE_TYPE;
+
+
+//------------------------------------------------------------------------------
+// Capability bits. Used by the object to specify what capabilities it has.
+//------------------------------------------------------------------------------
+typedef DWORD MP_CAPS;
+// Curve capabilities - If the cap bit is set, that type of curve is supported
+const MP_CAPS MP_CAPS_CURVE_JUMP = MP_CURVE_JUMP;
+const MP_CAPS MP_CAPS_CURVE_LINEAR = MP_CURVE_LINEAR;
+const MP_CAPS MP_CAPS_CURVE_SQUARE = MP_CURVE_SQUARE;
+const MP_CAPS MP_CAPS_CURVE_INVSQUARE = MP_CURVE_INVSQUARE;
+const MP_CAPS MP_CAPS_CURVE_SINE = MP_CURVE_SINE;
+
+
+//------------------------------------------------------------------------------
+// Structure used to return information about the type and limits of a parameter
+//------------------------------------------------------------------------------
+typedef struct _MP_PARAMINFO {
+ MP_TYPE mpType; // One of MP_TYPE_xxx codes
+ MP_CAPS mopCaps; // A collection of MP_CAPS flags
+
+ // Minimum and maximum values
+ MP_DATA mpdMinValue; // minimum legal value
+ MP_DATA mpdMaxValue; // maximum legal value
+ MP_DATA mpdNeutralValue; // default or 'center' value
+
+ // Defualt Unit and Label text. These strings will ALWAYS be English
+ // strings in the UNICODE character set. For international text
+ // use the GetParamText member function
+ WCHAR szUnitText[32]; // units of the parameter
+ WCHAR szLabel[32]; // name of the parameter
+
+} MP_PARAMINFO;
+
+
+//------------------------------------------------------------------------------
+// Parameter Index types
+//------------------------------------------------------------------------------
+typedef DWORD DWORD;
+const DWORD DWORD_ALLPARAMS = -1; // Apply this operation to all params
+
+
+//------------------------------------------------------------------------------
+// Defined list of timestamp types
+//------------------------------------------------------------------------------
+typedef DWORD MP_TIMEDATA; // Extra data to further define type
+
+// REFERENCE_TIME (1 tick = 100 nanoseconds, MP_TIMEDATA ignored)
+cpp_quote("DEFINE_GUID(GUID_TIME_REFERENCE,")
+cpp_quote("0x93ad712b, 0xdaa0, 0x4ffe, 0xbc, 0x81, 0xb0, 0xce, 0x50, 0xf, 0xcd, 0xd9);")
+
+// Music Time (MP_TIMEDATA = parts/quarter note)
+cpp_quote("DEFINE_GUID(GUID_TIME_MUSIC,")
+cpp_quote("0x574c49d, 0x5b04, 0x4b15, 0xa5, 0x42, 0xae, 0x28, 0x20, 0x30, 0x11, 0x7b);")
+
+// Time is measures in samples. MP_TIMEDATA = Samples/sec)
+cpp_quote("DEFINE_GUID(GUID_TIME_SAMPLES,")
+cpp_quote("0xa8593d05, 0xc43, 0x4984, 0x9a, 0x63, 0x97, 0xaf, 0x9e, 0x2, 0xc4, 0xc0);")
+
+
+//------------------------------------------------------------------------------
+// The value of a given parameter at a specific point in time
+//------------------------------------------------------------------------------
+typedef DWORD MP_FLAGS;
+const MP_FLAGS MPF_ENVLP_STANDARD = 0x0000; // Use all data provided
+const MP_FLAGS MPF_ENVLP_BEGIN_CURRENTVAL = 0x0001;
+ // Ignore valStart value, use current value as the staring point
+const MP_FLAGS MPF_ENVLP_BEGIN_NEUTRALVAL = 0x0002;
+ // Ignore valStart value, use neutral value as the staring point
+
+typedef struct _MP_ENVELOPE_SEGMENT {
+ REFERENCE_TIME rtStart; // Start time in current time format
+ REFERENCE_TIME rtEnd; // End time in current time format
+ MP_DATA valStart; // Initial Value
+ MP_DATA valEnd; // Final Value
+ MP_CURVE_TYPE iCurve; // One of MP_CURVE_TYPE codes
+ MP_FLAGS flags; // Special cases
+} MP_ENVELOPE_SEGMENT;
+
+//------------------------------------------------------------------------------
+// Define flags for Punch-in timing
+//------------------------------------------------------------------------------
+const MP_FLAGS MPF_PUNCHIN_REFTIME = 0; // Use the reference time as the PI time
+const MP_FLAGS MPF_PUNCHIN_NOW = 0x0001; // Punch in at the current clock time
+const MP_FLAGS MPF_PUNCHIN_STOPPED = 0x0002; // Return change notifications during
+ // author time
+
+//------------------------------------------------------------------------------
+// IMediaParamInfo - Interface used to determine the names, data types and
+// units of the parameters which are exposed by the object. This interface
+// is used at discovery time, and is not required during run-time since the
+// objects parameters are a fixed set and this data can be cached by the
+// calling applicaiton.
+//------------------------------------------------------------------------------
+[
+object,
+uuid(6d6cbb60-a223-44aa-842f-a2f06750be6d),
+version(1.0)
+]
+interface IMediaParamInfo : IUnknown
+{
+ HRESULT GetParamCount (
+ [out] DWORD * pdwParams
+ );
+ HRESULT GetParamInfo (
+ [in] DWORD dwParamIndex,
+ [out] MP_PARAMINFO * pInfo
+ );
+ // returns a series of null terminated strings. strings are in the
+ // following order:
+ // Param Label, Units Text, 1st Enum Text, 2nd Enum Text, etc...
+ HRESULT GetParamText (
+ [in] DWORD dwParamIndex, // which param to get text for
+ [out] WCHAR **ppwchText // returns ptr to CoTaskMemAlloc'd string
+ );
+
+ // Returns the number of diffrent time formats this object understands
+ HRESULT GetNumTimeFormats (
+ [out] DWORD * pdwNumTimeFormats
+ );
+
+ // Returns the GUID for the ith supported time format
+ HRESULT GetSupportedTimeFormat(
+ [in] DWORD dwFormatIndex,
+ [out] GUID *pguidTimeFormat
+ );
+
+ // Returns the current time format
+ HRESULT GetCurrentTimeFormat (
+ [out] GUID *pguidTimeFormat,
+ [out] MP_TIMEDATA *pTimeData
+ );
+}
+
+//------------------------------------------------------------------------------
+// IMediaParams - Interfaes used to actually set the media params and the
+// envelopes to follow
+//------------------------------------------------------------------------------
+[
+object,
+uuid(6d6cbb61-a223-44aa-842f-a2f06750be6e),
+version(1.0)
+]
+interface IMediaParams : IUnknown
+{
+ // Single param Get/Set methods
+ HRESULT GetParam (
+ [in] DWORD dwParamIndex,
+ [out] MP_DATA *pValue
+ );
+ HRESULT SetParam (
+ [in] DWORD dwParamIndex,
+ [in] MP_DATA value
+ );
+
+ // Envelope methods (param change over time)
+ HRESULT AddEnvelope (
+ [in] DWORD dwParamIndex,
+ [in] DWORD cSegments,
+ [in] MP_ENVELOPE_SEGMENT * pEnvelopeSegments
+ );
+
+ // Flush all of the envelope information for the given paramter between
+ // the timestamps specified
+ HRESULT FlushEnvelope (
+ [in] DWORD dwParamIndex,
+ [in] REFERENCE_TIME refTimeStart,
+ [in] REFERENCE_TIME refTimeEnd
+ );
+
+ // Change the time format being used by the object
+ HRESULT SetTimeFormat (
+ [in] GUID guidTimeFormat,
+ [in] MP_TIMEDATA mpTimeData
+ );
+}
+
+
+