diff options
Diffstat (limited to 'dxsdk/Include/DShowIDL/qedit.idl')
| -rw-r--r-- | dxsdk/Include/DShowIDL/qedit.idl | 1734 |
1 files changed, 0 insertions, 1734 deletions
diff --git a/dxsdk/Include/DShowIDL/qedit.idl b/dxsdk/Include/DShowIDL/qedit.idl deleted file mode 100644 index b75a3e35..00000000 --- a/dxsdk/Include/DShowIDL/qedit.idl +++ /dev/null @@ -1,1734 +0,0 @@ -//------------------------------------------------------------------------------ -// File: QEdit.idl -// -// Copyright (c) 1992 - 2002, Microsoft Corporation. All rights reserved. -//------------------------------------------------------------------------------ - - -import "oaidl.idl"; -import "ocidl.idl"; -import "dxtrans.idl"; -import "amstream.idl"; -import "msxml.idl"; - -// -// forward declare -// -interface IAMTimelineGroup; -interface IAMTimelineObj; -interface IAMTimelineEffect; -interface IAMTimelineTrans; -interface IAMTimelineSrc; -interface IAMTimeline; -interface IAMErrorLog; -interface ISampleGrabber; -interface IPropertySetter; - -// used by DEXTER_VALUE's dwInterp var -typedef enum -{ - DEXTERF_JUMP, - DEXTERF_INTERPOLATE -} DEXTERF; - -// used to set values on the property setter -typedef struct -{ - BSTR Name; - DISPID dispID; - LONG nValues; -} DEXTER_PARAM; - -// used to set values on the property setter -typedef struct -{ - VARIANT v; - REFERENCE_TIME rt; - DWORD dwInterp; // one of the DEXTERF_ flags -} DEXTER_VALUE; - -// used by bMethod directly below -enum -{ - DEXTER_AUDIO_JUMP, - DEXTER_AUDIO_INTERPOLATE -}; - -// used to set volumes on the mixer and mixer pins -typedef struct -{ - REFERENCE_TIME rtEnd; //end Time - double dLevel; //end Volume Level - BOOL bMethod; //jump or interpolate -} DEXTER_AUDIO_VOLUMEENVELOPE ; - -// used in IAMTimeline::Get(Set)InsertMode -enum -{ - TIMELINE_INSERT_MODE_INSERT = 1, - TIMELINE_INSERT_MODE_OVERLAY = 2 -}; - -// -// define what main 'things' can be put into the timeline tree. -// these values are used quite a bit with timeline access -// (bitmap mask flags) -typedef enum -{ - TIMELINE_MAJOR_TYPE_COMPOSITE = 1, - TIMELINE_MAJOR_TYPE_TRACK = 2, - TIMELINE_MAJOR_TYPE_SOURCE = 4, - TIMELINE_MAJOR_TYPE_TRANSITION = 8, - TIMELINE_MAJOR_TYPE_EFFECT = 16, - TIMELINE_MAJOR_TYPE_GROUP = 128 -} TIMELINE_MAJOR_TYPE; - -// used in various IAMTimelineXXX "search" functions. Look in this -// file for "SearchDirection" to see where it's used. I didn't want -// to use an enum as an interface param type, so I used a long. -typedef enum -{ - DEXTERF_BOUNDING = -1, // finds any source whose start <= Time and stop > Time - DEXTERF_EXACTLY_AT = 0, // finds any source that starts exactly at Time - DEXTERF_FORWARDS = 1 // finds any source that starts at or after Time -} DEXTERF_TRACK_SEARCH_FLAGS; - -// right now, the media type in the group contains enough information about -// how we want to recompress. This might not be enough information in the -// future, so we define a structure we can get and set to the group. -// -typedef struct _SCompFmt0 -{ - long nFormatId; - AM_MEDIA_TYPE MediaType; -} SCompFmt0; - -// used in IAMTimelineSrc::Get(Set)StretchMode -// -enum -{ - RESIZEF_STRETCH, - RESIZEF_CROP, - RESIZEF_PRESERVEASPECTRATIO, - RESIZEF_PRESERVEASPECTRATIO_NOLETTERBOX -}; - -// used in IRenderEngine::SetDynamicReconnectLevel -// (bitmap mask flags) -enum -{ - CONNECTF_DYNAMIC_NONE = 0x00000000, - CONNECTF_DYNAMIC_SOURCES = 0x00000001, - CONNECTF_DYNAMIC_EFFECTS = 0x00000002 -}; - -// used in -// IMediaLocator::FindMediaFile -// IRenderEngine::SetSourceNameValidation -// IAMTimeline::ValidateSourceNames -// (bitmap mask flags) -enum -{ - SFN_VALIDATEF_CHECK = 0x00000001, // do a check. Without this set, no check will be done. - SFN_VALIDATEF_POPUP = 0x00000002, // should UI popup show if not found - SFN_VALIDATEF_TELLME = 0x00000004, // warn user about replaced files - SFN_VALIDATEF_REPLACE = 0x00000008, // should it replace names in the tldb if found - SFN_VALIDATEF_USELOCAL = 0x000000010, // use local media preferrably over networked media - SFN_VALIDATEF_NOFIND = 0x000000020, // never find filenames, always use UI popup to find., - // when used, _POPUP must be used as well - SFN_VALIDATEF_IGNOREMUTED = 0x000000040, // ignore muted files in the tldb - SFN_VALIDATEF_END -}; - -// key transitions types -enum -{ - DXTKEY_RGB, - DXTKEY_NONRED, - DXTKEY_LUMINANCE, - DXTKEY_ALPHA, - DXTKEY_HUE -}; - - -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// -// New Property setting Interfaces -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// - -// interface for objects which can save/load IDispatch-able properties -[ - object, - uuid(AE9472BD-B0C3-11D2-8D24-00A0C9441E20), - helpstring("IPropertySetter Interface"), - pointer_default(unique) -] -interface IPropertySetter : IUnknown // IPersist? -{ - // for loading and saving through XML - HRESULT LoadXML([in] IUnknown * pxml); - // !!! doesn't work HRESULT LoadXML([in] IXMLElement * pxml); - HRESULT PrintXML([out] char *pszXML, [in] int cbXML, [out] int *pcbPrinted,[in] int indent); - - // for cloning a portion of the props when splitting the object - //AUTOMATE - HRESULT CloneProps([out] IPropertySetter **ppSetter, - [in] REFERENCE_TIME rtStart, - [in] REFERENCE_TIME rtStop); - - // for loading and saving programmatically - // caller must call this in pre-sorted order, this time must be > all - // previous times - //AUTOMATE - HRESULT AddProp([in] DEXTER_PARAM Param, - [in] DEXTER_VALUE *paValue); - //AUTOMATE - HRESULT GetProps([out] LONG *pcParams, - [out] DEXTER_PARAM **paParam, - [out] DEXTER_VALUE **paValue); - // after calling GetProps, you must call FreeProps to free resources - //AUTOMATE - HRESULT FreeProps([in] LONG cParams, - [in] DEXTER_PARAM *paParam, - [in] DEXTER_VALUE *paValue); - // to empty to property setter, so you can start over again - HRESULT ClearProps(); - - // for persisting - HRESULT SaveToBlob([out] LONG *pcSize, [out] BYTE **ppb); - HRESULT LoadFromBlob([in] LONG cSize, [in] BYTE *pb); - - // to program the object that supports IDispatch with the props - // call with rtNow == -1 to set Static Props when your object instantiates - // errors will be logged, if a log is provided - //AUTOMATE - HRESULT SetProps([in] IUnknown *pTarget, - [in] REFERENCE_TIME rtNow); - - // unicode version - HRESULT PrintXMLW([out] WCHAR *pszXML, [in] int cchXML, [out] int *pcchPrinted,[in] int indent); -}; - -// supported by our DxtCompositor class, this allows us to draw whatever comes in -// upon only a portion of the output bitmap - -[ - object, - uuid(BB44391E-6ABD-422f-9E2E-385C9DFF51FC), - dual, - helpstring("IDxtCompositor Interface"), - pointer_default(unique) -] -interface IDxtCompositor : IDXEffect -{ - [propget, id(1), helpstring("property OffsetX")] HRESULT OffsetX([out, retval] long *pVal); - [propput, id(1), helpstring("property OffsetX")] HRESULT OffsetX([in] long newVal); - [propget, id(2), helpstring("property OffsetY")] HRESULT OffsetY([out, retval] long *pVal); - [propput, id(2), helpstring("property OffsetY")] HRESULT OffsetY([in] long newVal); - [propget, id(3), helpstring("property Width")] HRESULT Width([out, retval] long *pVal); - [propput, id(3), helpstring("property Width")] HRESULT Width([in] long newVal); - [propget, id(4), helpstring("property Height")] HRESULT Height([out, retval] long *pVal); - [propput, id(4), helpstring("property Height")] HRESULT Height([in] long newVal); - - [propget, id(5), helpstring("property SrcOffsetX")] HRESULT SrcOffsetX([out, retval] long *pVal); - [propput, id(5), helpstring("property SrcOffsetX")] HRESULT SrcOffsetX([in] long newVal); - [propget, id(6), helpstring("property SrcOffsetY")] HRESULT SrcOffsetY([out, retval] long *pVal); - [propput, id(6), helpstring("property SrcOffsetY")] HRESULT SrcOffsetY([in] long newVal); - [propget, id(7), helpstring("property SrcWidth")] HRESULT SrcWidth([out, retval] long *pVal); - [propput, id(7), helpstring("property SrcWidth")] HRESULT SrcWidth([in] long newVal); - [propget, id(8), helpstring("property SrcHeight")] HRESULT SrcHeight([out, retval] long *pVal); - [propput, id(8), helpstring("property SrcHeight")] HRESULT SrcHeight([in] long newVal); -}; - -[ - object, - uuid(4EE9EAD9-DA4D-43d0-9383-06B90C08B12B), - dual, - helpstring("IDxtAlphaSetter Interface"), - pointer_default(unique) -] -interface IDxtAlphaSetter : IDXEffect -{ - // set the alpha to a particular number - [propget, id(1), helpstring("property Alpha")] HRESULT Alpha([out, retval] long *pVal); - [propput, id(1), helpstring("property Alpha")] HRESULT Alpha([in] long newVal); - - // set the alpha to a percentage of it's full value - [propget, id(2), helpstring("property AlphaRamp")] HRESULT AlphaRamp([out, retval] double *pVal); - [propput, id(2), helpstring("property AlphaRamp")] HRESULT AlphaRamp([in] double newVal); -}; - -// Supported by our JPEG DXT, that can do any wipe based on a bitmap -// - -[ - object, - uuid(DE75D011-7A65-11D2-8CEA-00A0C9441E20), - dual, - helpstring("IDxtJpeg Interface"), - pointer_default(unique) -] -interface IDxtJpeg : IDXEffect -{ - [propget, id(1), helpstring("property MaskNum")] HRESULT MaskNum([out, retval] long *); - [propput, id(1), helpstring("property MaskNum")] HRESULT MaskNum([in] long); - [propget, id(2), helpstring("property MaskName")] HRESULT MaskName([out, retval] BSTR *pVal); - [propput, id(2), helpstring("property MaskName")] HRESULT MaskName([in] BSTR newVal); - [propget, id(3), helpstring("property ScaleX")] HRESULT ScaleX([out, retval] double *); - [propput, id(3), helpstring("property ScaleX")] HRESULT ScaleX([in] double); - [propget, id(4), helpstring("property ScaleY")] HRESULT ScaleY([out, retval] double *); - [propput, id(4), helpstring("property ScaleY")] HRESULT ScaleY([in] double); - [propget, id(5), helpstring("property OffsetX")] HRESULT OffsetX([out, retval] long *); - [propput, id(5), helpstring("property OffsetX")] HRESULT OffsetX([in] long); - [propget, id(6), helpstring("property OffsetY")] HRESULT OffsetY([out, retval] long *); - [propput, id(6), helpstring("property OffsetY")] HRESULT OffsetY([in] long); - [propget, id(7), helpstring("property ReplicateX")] HRESULT ReplicateX([out, retval] long *pVal); - [propput, id(7), helpstring("property ReplicateX")] HRESULT ReplicateX([in] long newVal); - [propget, id(8), helpstring("property ReplicateY")] HRESULT ReplicateY([out, retval] long *pVal); - [propput, id(8), helpstring("property ReplicateY")] HRESULT ReplicateY([in] long newVal); - [propget, id(9), helpstring("property BorderColor")] HRESULT BorderColor([out, retval] long *pVal); - [propput, id(9), helpstring("property BorderColor")] HRESULT BorderColor([in] long newVal); - [propget, id(10), helpstring("property BorderWidth")] HRESULT BorderWidth([out, retval] long *pVal); - [propput, id(10), helpstring("property BorderWidth")] HRESULT BorderWidth([in] long newVal); - [propget, id(11), helpstring("property BorderSoftness")] HRESULT BorderSoftness([out, retval] long *pVal); - [propput, id(11), helpstring("property BorderSoftness")] HRESULT BorderSoftness([in] long newVal); - HRESULT ApplyChanges(); - HRESULT LoadDefSettings(); -}; - - // key - [ - object, - uuid(3255de56-38fb-4901-b980-94b438010d7b), - dual, - helpstring("IDxtKey Interface"), - pointer_default(unique) - ] - interface IDxtKey : IDXEffect - { - [propget, id(1), helpstring("property KeyType")] HRESULT KeyType([out, retval] int *); - [propput, id(1), helpstring("property Keytype")] HRESULT KeyType([in] int); - [propget, id(2), helpstring("property Hue")] HRESULT Hue([out, retval] int *); - [propput, id(2), helpstring("property Hue")] HRESULT Hue([in] int ); - [propget, id(3), helpstring("property Luminance")] HRESULT Luminance([out, retval] int *); - [propput, id(3), helpstring("property Luminance")] HRESULT Luminance([in] int ); - [propget, id(4), helpstring("property RGB")] HRESULT RGB([out, retval] DWORD *); - [propput, id(4), helpstring("property RGB")] HRESULT RGB([in] DWORD ); - [propget, id(5), helpstring("property Similarity")] HRESULT Similarity([out,retval] int * ); - [propput, id(5), helpstring("property Similarity")] HRESULT Similarity([in] int ); - [propget, id(6), helpstring("property Invert")] HRESULT Invert([out, retval] BOOL *); - [propput, id(6), helpstring("property Invert")] HRESULT Invert([in] BOOL); - }; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // This little COM interface will look 'around' for the closest - // path match for a given file. If the file already exists, then - // this interface should hardly do anything. If it's not found, - // it will go look for it and if successful, return S_FALSE. If it - // cannot find the file, it will call the hook, if set and return - // it's return code. if the hook is not set, it is in a type of - // error condition. The Dexter-provided MediaLocator will bring up - // a dialog box asking you to browse for your file. Other COM - // objects may do something else. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(288581E0-66CE-11d2-918F-00C0DF10D434), - odl, - helpstring("IMediaLocator Interface"), - pointer_default(unique) -] -interface IMediaLocator : IUnknown -{ - // same flags as used by IRenderEngine's SetSourceNameValidation - HRESULT FindMediaFile( BSTR Input, BSTR FilterString, BSTR * pOutput, long Flags ); - HRESULT AddFoundLocation( BSTR DirectoryName ); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // This object provides caching of duration and stream type - // information for files that would produce a directshow source - // filter. It takes too long to figure this out in DShow right - // now, so this is one way around it. The way it works is that - // you first fill out the Filename property, then call and - // ask how many streams it has, or, set the CurrentStream prop - // and then ask for the per-stream properties, StreamType or - // StreamLength. They both reference the CurrentStream prop that - // you set. I also allowed you (for convenience) to just give - // it a IUnknown Filter that represents an IBaseFilter source - // filter that is NOT currently in a graph. It will use that - // instead. When using this, though, you will not get cached - // values. The cached values are stored in the system's ini file - // called DCBC2A70-70D8-4459-BFFA-E0D61DEA3FDF.INI. Nice, huh? :-) - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(65BD0710-24D2-4ff7-9324-ED2E5D3ABAFA), - odl, - helpstring("IMediaDet Interface"), - pointer_default(unique) -] -interface IMediaDet : IUnknown -{ - [propget, id(1), helpstring("property Filter")] HRESULT Filter([out, retval] IUnknown* *pVal); - [propput, id(1), helpstring("property Filter")] HRESULT Filter([in] IUnknown* newVal); - [propget, id(2), helpstring("property OutputStreams")] HRESULT OutputStreams([out, retval] long *pVal); - [propget, id(3), helpstring("property CurrentStream")] HRESULT CurrentStream([out, retval] long *pVal); - [propput, id(3), helpstring("property CurrentStream")] HRESULT CurrentStream([in] long newVal); - [propget, id(4), helpstring("property StreamType")] HRESULT StreamType([out, retval] GUID *pVal); - [propget, id(5), helpstring("property StreamTypeB")] HRESULT StreamTypeB([out, retval] BSTR *pVal); - [propget, id(6), helpstring("property StreamLength")] HRESULT StreamLength([out, retval] double *pVal); - [propget, id(7), helpstring("property Filename")] HRESULT Filename([out, retval] BSTR *pVal); - [propput, id(7), helpstring("property Filename")] HRESULT Filename([in] BSTR newVal); - [id(8), helpstring("method GetBitmapBits")] HRESULT GetBitmapBits(double StreamTime, long * pBufferSize, char * pBuffer, long Width, long Height); - [id(9), helpstring("method WriteBitmapBits")] HRESULT WriteBitmapBits(double StreamTime, long Width, long Height, BSTR Filename ); - [propget, id(10), helpstring("property StreamMediaType")] HRESULT StreamMediaType([out, retval] AM_MEDIA_TYPE * pVal); - [id(11), helpstring("method GetSampleGrabber")] HRESULT GetSampleGrabber( [out] ISampleGrabber ** ppVal ); - [propget, id(12), helpstring("property FrameRate")] HRESULT FrameRate([out, retval] double *pVal); - [id(13), helpstring("method EnterBitmapGrabMode")] HRESULT EnterBitmapGrabMode( double SeekTime ); -}; - - -// useless interface, don't use it! - -[ - object, - uuid(AE9472BE-B0C3-11D2-8D24-00A0C9441E20), - odl, - helpstring("IGrfCache Interface"), - pointer_default(unique) -] -interface IGrfCache : IDispatch -{ - [id(1), helpstring("method AddFilter")] - HRESULT AddFilter( - IGrfCache * ChainedCache, - LONGLONG ID, - const IBaseFilter * pFilter, - LPCWSTR pName); - - [id(2), helpstring("method ConnectPins")] - HRESULT ConnectPins( - IGrfCache * ChainedCache, - LONGLONG PinID1, - const IPin * pPin1, - LONGLONG PinID2, - const IPin * pPin2); - - [id(3), helpstring("method SetGraph")] - HRESULT SetGraph(const IGraphBuilder * pGraph); - - [id(4), helpstring("method DoConnectionsNow")] - HRESULT DoConnectionsNow(); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // The RenderEngin builds a graph from the timeline and gives - // you some simple positional commands. - // explained methods: - // SetTimelineObject - tell the render engine who to parse - // ConnectEverything - build up a graph based on the timeline - // ScrapIt - throw away graph and everything - // GetFilterGraph - get the graph that's built up, if any - // SetFilterGraph - allows you to preset the graph that's built up. - // cannot call this if there already is a graph. - - // !!! the following methods are unused/not implemented - - // SetInterestRange - discard COM objects and memory outside of this - // range, if possible. Used for scrubbing on a long timeline and - // freeing up resources - // SetRenderRange - pretend like a portion of the timeline IS the timeline - // and don't connect anything in the graph outside of that range. - // Commit - allocate what's necessary and get prepared to run - // Decommit - free anything possible - // GetCaps - find out some info about the render engine - // DoSmartRecompression - connect compressed sources if - // possible - // in the graph, this will RenderPin( ) on every switcher - // rendering pin. - // SetSourceNameValidation - allows you to set some flags which - // determine how source files are found, if they need to be found. - // FilterString is a list of extensions to find for the media - // files (see OPENFILENAME filters) - // pOverride is a media locator you would like to use instead - // of the built in one - // The flags are defined in the struct immediately below. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(6BEE3A81-66C9-11d2-918F-00C0DF10D434), - odl, - helpstring("IRenderEngine Interface"), - pointer_default(unique) -] -interface IRenderEngine : IUnknown -{ - HRESULT SetTimelineObject( IAMTimeline * pTimeline ); - HRESULT GetTimelineObject( [out] IAMTimeline ** ppTimeline ); - HRESULT GetFilterGraph( [out] IGraphBuilder ** ppFG ); - HRESULT SetFilterGraph( IGraphBuilder * pFG ); - HRESULT SetInterestRange( REFERENCE_TIME Start, REFERENCE_TIME Stop ); - HRESULT SetInterestRange2( double Start, double Stop ); - HRESULT SetRenderRange( REFERENCE_TIME Start, REFERENCE_TIME Stop ); - HRESULT SetRenderRange2( double Start, double Stop ); - HRESULT GetGroupOutputPin( long Group, [out] IPin ** ppRenderPin ); - HRESULT ScrapIt( ); - HRESULT RenderOutputPins( ); - HRESULT GetVendorString( [out,retval] BSTR * pVendorID ); - HRESULT ConnectFrontEnd( ); - HRESULT SetSourceConnectCallback( IGrfCache * pCallback ); - HRESULT SetDynamicReconnectLevel( long Level ); - HRESULT DoSmartRecompression( ); - HRESULT UseInSmartRecompressionGraph( ); - - HRESULT SetSourceNameValidation( BSTR FilterString, IMediaLocator * pOverride, LONG Flags ); - - // not implemented yet - HRESULT Commit( ); - HRESULT Decommit( ); - HRESULT GetCaps( long Index, long * pReturn ); -}; - -[ - object, - uuid(6BEE3A82-66C9-11d2-918F-00C0DF10D434), - odl, - helpstring("IRenderEngine2 Interface"), - pointer_default(unique) -] -interface IRenderEngine2 : IUnknown -{ - HRESULT SetResizerGUID( GUID ResizerGuid ); -} - -// used for the smart render engine when it needs to find a compressor -[ - object, - uuid(F03FA8DE-879A-4d59-9B2C-26BB1CF83461), - odl, - helpstring("IFindCompressorCB Interface"), - pointer_default(unique) -] -interface IFindCompressorCB : IUnknown -{ - HRESULT GetCompressor( AM_MEDIA_TYPE * pType, AM_MEDIA_TYPE * pCompType, [out] IBaseFilter ** ppFilter ); -} - -[ - object, - uuid(F03FA8CE-879A-4d59-9B2C-26BB1CF83461), - odl, - helpstring("ISmartRenderEngine Interface"), - pointer_default(unique) -] -interface ISmartRenderEngine : IUnknown -{ - HRESULT SetGroupCompressor( long Group, IBaseFilter * pCompressor ); - HRESULT GetGroupCompressor( long Group, IBaseFilter ** pCompressor ); - HRESULT SetFindCompressorCB( IFindCompressorCB * pCallback ); -} - -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// -// TIMELINE TIMELINE TIMELINE TIMELINE TIMELINE TIMELINE -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Every object on the timeline supports at least this interface. - // explained methods: - // Get/SetStartStop - the timeline times at which this object is - // active. Groups and Tracks have start times of zero. - // FixTimes - used by the render engine. Rounds the input times - // to the nearest FPS of the parent Group, for use in setting - // up the big switch. - // GetSubObject - get the sub-object which is associated with this - // timeline object. Each timeline object can carry around a - // pointer to 'something else'. For our Render Engine, this is - // a pointer to a filter that gets put into a graph. - // NOTE: Getting the subobject will FORCE it to load if it's possible - // to force this. If you don't want it to do this, don't call - // this function. - // SetSubObject - see GetSubObject - // SetSubObjectGUID - instead of giving the node a pointer, you can - // instead give it a GUID and see if this works instead. The - // sub-object will attempt to be instantiated when 'necessary' - // which is really when it's asked for with GetSubObject./ - // !!! a better way to do this perhaps? - // GetSubObjectLoaded - ask if the sub-object pointer is set - // Get/SetTimelineType - return the major type which is stored here, - // used by the API user and the render engine. - // Get/SetTimelineSubType - see above - // Get/SetUserID - get and set a number, any number - // GetGenID - every created object has a unique number to it. Used - // by the render engine. - // Get/SetUserName - a storable name, for users of the API - // Get/SetPropertySetter - the object that will set properties for this - // object (it will support IPropertySetter and it is created by - // CPropertySetter) - // Get/SetUserData - gets the persistant data used by the user of - // the API. - // Get/SetMuted - set whether this object should be active or not. - // Setting a parent of other objects off also turns off the - // sub-objects. - // Get/SetLocked - set whether you can edit this object or not. - // Note: the timeline doesn't enforce this, it just stores - // a value for convenience. - // Get/SetDirtyRange - - // RemoveAll - remove this object, and if in the tree already, all it's - // sub objects, including children - // Remove - remove this object, and if in the tree already, all it's - // sub objects, but not kids - // GetTimelineNoRef - called internally by the timeline. - // GetGroupIBelongTo - called internally by the timeline. - // GetEmbedDepth - find out how many tracks we are a part of - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - local, - uuid(78530B77-61F9-11D2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineObj Interface"), - pointer_default(unique) -] -interface IAMTimelineObj : IUnknown -{ - [helpstring("method GetStartStop")] - HRESULT GetStartStop(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method GetStartStop2")] - HRESULT GetStartStop2(REFTIME * pStart, REFTIME * pStop); - [helpstring("method FixTimes")] - HRESULT FixTimes(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method FixTimes2")] - HRESULT FixTimes2(REFTIME * pStart, REFTIME * pStop); - [helpstring("method SetStartStop")] - HRESULT SetStartStop(REFERENCE_TIME Start, REFERENCE_TIME Stop); - [helpstring("method SetStartStop2")] - HRESULT SetStartStop2(REFTIME Start, REFTIME Stop); - [helpstring("method GetPropertySetter")] - HRESULT GetPropertySetter([out,retval] IPropertySetter* *pVal); - [helpstring("method SetPropertySetter")] - HRESULT SetPropertySetter(IPropertySetter* newVal); - [helpstring("method GetSubObject")] - HRESULT GetSubObject([out,retval] IUnknown* *pVal); - [helpstring("method SetSubObject")] - HRESULT SetSubObject(IUnknown* newVal); - [helpstring("method SetSubObjectGUID")] - HRESULT SetSubObjectGUID(GUID newVal); - [helpstring("method SetSubObjectGUIDByBSTR")] - HRESULT SetSubObjectGUIDB(BSTR newVal); - [helpstring("method GetSubObjectGUID")] - HRESULT GetSubObjectGUID(GUID * pVal); - [helpstring("method GetSubObjectGUIDByBSTR")] - HRESULT GetSubObjectGUIDB([out,retval] BSTR * pVal); - [helpstring("method GetSubObjectLoaded")] - HRESULT GetSubObjectLoaded(BOOL * pVal); - [helpstring("method GetTimelineType")] - HRESULT GetTimelineType(TIMELINE_MAJOR_TYPE * pVal); - [helpstring("method SetTimelineType")] - HRESULT SetTimelineType(TIMELINE_MAJOR_TYPE newVal); - [helpstring("method GetUserID")] - HRESULT GetUserID(long * pVal); - [helpstring("method SetUserID")] - HRESULT SetUserID(long newVal); - [helpstring("method GetGenID")] - HRESULT GetGenID( long * pVal ); - [helpstring("method GetUserName")] - HRESULT GetUserName([out,retval] BSTR * pVal); - [helpstring("method SetUserName")] - HRESULT SetUserName(BSTR newVal); - [helpstring("method GetUserData")] - HRESULT GetUserData(BYTE * pData, long * pSize); - [helpstring("method SetUserData")] - HRESULT SetUserData(BYTE * pData, long Size); - [helpstring("method GetMuted")] - HRESULT GetMuted(BOOL * pVal); - [helpstring("method SetMuted")] - HRESULT SetMuted(BOOL newVal); - [helpstring("method GetLocked")] - HRESULT GetLocked(BOOL * pVal); - [helpstring("method SetLocked")] - HRESULT SetLocked(BOOL newVal); - [helpstring("method GetDirtyRange")] - HRESULT GetDirtyRange(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method GetDirtyRange")] - HRESULT GetDirtyRange2(REFTIME * pStart, REFTIME * pStop); - [helpstring("method SetDirtyRange")] - HRESULT SetDirtyRange(REFERENCE_TIME Start, REFERENCE_TIME Stop); - [helpstring("method SetDirtyRange")] - HRESULT SetDirtyRange2(REFTIME Start, REFTIME Stop); - [helpstring("method ClearDirty")] - HRESULT ClearDirty( ); - [helpstring("method Remove")] - HRESULT Remove(); - [helpstring("method RemoveAll")] - HRESULT RemoveAll(); - HRESULT GetTimelineNoRef( IAMTimeline ** ppResult ); - HRESULT GetGroupIBelongTo( [out] IAMTimelineGroup ** ppGroup ); - HRESULT GetEmbedDepth( long * pVal ); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Any object on the timeline that can have an effect put on it - // implements this interface. This includes sources, tracks, and - // compositions. - // explained methods: - // EffectInsBefore - insert an effect at the given priority onto - // this object. The effect's times will be clipped within - // this object's bounds. Use -1 to specify 'at the end' for priority. - // You cannot have two effects at the same priority. - // EffectSwapPriorities - swaparoo two effects. Makes undo easier to - // implement. - // EffectGetCount - get how many effects are applied to this object. - // GetEffect - get the nth effect applied to this object - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -[ - object, - uuid(EAE58537-622E-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineEffectable Interface"), - pointer_default(unique) -] -interface IAMTimelineEffectable : IUnknown -{ - [helpstring("method EffectInsBefore")] - HRESULT EffectInsBefore(IAMTimelineObj * pFX, long priority); - [helpstring("method EffectSwapPriorities")] - HRESULT EffectSwapPriorities(long PriorityA, long PriorityB); - [helpstring("method EffectGetCount")] - HRESULT EffectGetCount(long * pCount); - [helpstring("method GetEffect")] - HRESULT GetEffect([out] IAMTimelineObj ** ppFx, long Which); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Any effect on the timeline will support at least this interface. - // NOTE: The Start/Stop times on this object are RELATIVE to their - // parent's, as are all start/stop times. - // explained methods: - // EffectGetPriority - finds out this effect's priority related to the others. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(BCE0C264-622D-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineEffect Interface"), - pointer_default(unique) -] -interface IAMTimelineEffect : IUnknown -{ - [helpstring("method EffectGetPriority")] - HRESULT EffectGetPriority(long * pVal); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Any object on the timeline that can have a transition put on it - // implements this interface - // explained methods: - // TransAdd - add a transition on this object. Multiple trans's on - // the same object cannot overlap in time. Transitions' times - // must lie within the bounds of their parent. - // TransGetCount - get how many transitions are applied to this - // object. - // GetNextTrans - given a time, get the next transition that happens - // on this object after that time. On exit, the input time is - // set to the start time of the transition. - // GetTransAtTime - find a transition forwards or backwards from - // a given spot. See DEXTERF_TRACK_SEARCH_FLAGS enum. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(378FA386-622E-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineTransable Interface"), - pointer_default(unique) -] -interface IAMTimelineTransable : IUnknown -{ - [helpstring("method TransAdd")] - HRESULT TransAdd(IAMTimelineObj * pTrans); - [helpstring("method TransGetCount")] - HRESULT TransGetCount(long * pCount); - [helpstring("method GetNextTrans")] - HRESULT GetNextTrans([out] IAMTimelineObj ** ppTrans, REFERENCE_TIME * pInOut); - [helpstring("method GetNextTrans2")] - HRESULT GetNextTrans2([out] IAMTimelineObj ** ppTrans, REFTIME * pInOut); - [helpstring("method GetTransAtTime")] - HRESULT GetTransAtTime( - [out] IAMTimelineObj ** ppObj, - REFERENCE_TIME Time, - long SearchDirection ); - [helpstring("method GetTransAtTime2")] - HRESULT GetTransAtTime2([out] IAMTimelineObj ** ppObj, REFTIME Time, long SearchDirection ); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Any object on the timeline that can be split into two will - // implement this interface. Namely, source, effects, and transitions - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(A0F840A0-D590-11d2-8D55-00A0C9441E20), - odl, - helpstring("IAMTimelineSplittable Interface"), - pointer_default(unique) -] -interface IAMTimelineSplittable : IUnknown -{ - HRESULT SplitAt(REFERENCE_TIME Time); - HRESULT SplitAt2(REFTIME Time); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Any trans on the timeline will support at least this interface. - // NOTE: The Start/Stop times on this object are RELATIVE to their - // parent's, as are all start/stop times. - // explained methods: - // GetCutPoint - get where this transition should cut from A to B - // if the transition were not applied. - // GetA2B - get if this transition is to go from A->B or B->A. - // GetBackwards - get if this transition should run backwards. - // GetCutsOnly - force no transition, force doing a cut - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(BCE0C265-622D-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineTrans Interface"), - pointer_default(unique) -] -interface IAMTimelineTrans : IUnknown -{ - [helpstring("method GetCutPoint")] - HRESULT GetCutPoint(REFERENCE_TIME * pTLTime); - [helpstring("method GetCutPoint2")] - HRESULT GetCutPoint2(REFTIME * pTLTime); - [helpstring("method SetCutPoint")] - HRESULT SetCutPoint(REFERENCE_TIME TLTime); - [helpstring("method SetCutPoint2")] - HRESULT SetCutPoint2(REFTIME TLTime); - [helpstring("method GetSwapInputs")] - HRESULT GetSwapInputs( BOOL * pVal ); - [helpstring("method SetSwapInputs")] - HRESULT SetSwapInputs( BOOL pVal ); - [helpstring("method GetCutsOnly")] - HRESULT GetCutsOnly( BOOL * pVal ); - [helpstring("method SetCutsOnly")] - HRESULT SetCutsOnly( BOOL pVal ); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Sources represent any source media object on the timeline. - // They extend an IAMTimelineObj to include media start and stop - // times, a media name (which could represent darned near anything), - // and a StreamNumber, which defines which stream out of a potential - // many this stream represents from a source clip. - // explained methods: - // ModifyStopTime - like calling SetStartStop, but this method just - // adjusts the tail end of the clip. - // FixMediaTimes - called by the render engine to round times to - // this source clip's parent group's FPS. - // SpliceWithNext - if the next clip after this is the same source - // and this's stop time matches next's start time, the two - // will be joined. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(78530B79-61F9-11D2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineSrc Interface"), - pointer_default(unique) -] -interface IAMTimelineSrc : IUnknown -{ - [helpstring("method GetMediaTimes")] - HRESULT GetMediaTimes(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method GetMediaTimes2")] - HRESULT GetMediaTimes2(REFTIME * pStart, REFTIME * pStop); - [helpstring("method ModifyStopTime")] - HRESULT ModifyStopTime(REFERENCE_TIME Stop); - [helpstring("method ModifyStopTime2")] - HRESULT ModifyStopTime2(REFTIME Stop); - [helpstring("method FixMediaTimes")] - HRESULT FixMediaTimes(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method FixMediaTimes2")] - HRESULT FixMediaTimes2(REFTIME * pStart, REFTIME * pStop); - [helpstring("method SetMediaTimes")] - HRESULT SetMediaTimes(REFERENCE_TIME Start, REFERENCE_TIME Stop); - [helpstring("method SetMediaTimes2")] - HRESULT SetMediaTimes2(REFTIME Start, REFTIME Stop); - [helpstring("method SetMediaLength")] - HRESULT SetMediaLength(REFERENCE_TIME Length); - [helpstring("method SetMediaLength2")] - HRESULT SetMediaLength2(REFTIME Length); - [helpstring("method GetMediaLength")] - HRESULT GetMediaLength(REFERENCE_TIME * pLength); - [helpstring("method GetMediaLength2")] - HRESULT GetMediaLength2(REFTIME * pLength); - [helpstring("method GetMediaName")] - HRESULT GetMediaName([out,retval] BSTR * pVal); - [helpstring("method SetMediaName")] - HRESULT SetMediaName(BSTR newVal); - [helpstring("method SpliceWithNext")] - HRESULT SpliceWithNext(IAMTimelineObj * pNext); - [helpstring("method GetStreamNumber")] - HRESULT GetStreamNumber(long * pVal); - [helpstring("method SetStreamNumber")] - HRESULT SetStreamNumber(long Val); - HRESULT IsNormalRate( BOOL * pVal ); - - // If a source can't figure out its frames per second, this number - // will be used (eg: Dib sequences). AVI, MPEG, etc. will not need this - // Use 0 fps to prevent a filename like "ski4.jpg" from using a dib seq - [helpstring("method GetDefaultFPS")] - HRESULT GetDefaultFPS(double * pFPS); - [helpstring("method SetDefaultFPS")] - HRESULT SetDefaultFPS(double FPS); - - // !!! This is video specific.. new interface? - // what kind of stretching? Stretch, crop, or preserve aspect ratio? - [helpstring("method GetStretchMode")] - HRESULT GetStretchMode(int * pnStretchMode); - [helpstring("method SetStretchMode")] - HRESULT SetStretchMode(int nStretchMode); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Tracks are things that can contain media in them. You can add - // and remove sources, effects, and transitions from them. Sources - // are added according to the current insert mode of the timeline. - // If in OVERLAY mode, moving or adding a source to a time that's - // already occupied by another source will wipe out any overlapping - // portion of the underlying source. In InsertMode, everything at - // the insert point is moved down in time to make room for the - // new source. - // explained methods: - // SrcAdd - add the source to this track. The source's start/stop - // times must be set up first. - // GetNextSrc - pass a time in at which you wish to find a source - // and it will return the first source which occurs after the - // given time. - // MoveEverythingBy - bump a bunch of objects a certain direction - // on the track by a given time. - // GetSourcesCount - how many sources are on this track? - // AreYouBlank - do you contain anything at all? - // GetSrcAtTime - find a source at a given time. SearchDirection - // is which way to search. -1 = backwards, 1 = forwards - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(EAE58538-622E-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineTrack Interface"), - pointer_default(unique) -] -interface IAMTimelineTrack : IUnknown -{ - [helpstring("method SrcAdd")] - HRESULT SrcAdd(IAMTimelineObj * pSource); - [helpstring("method GetNextSrc")] - HRESULT GetNextSrc([out] IAMTimelineObj ** ppSrc, REFERENCE_TIME * pInOut); - [helpstring("method GetNextSrc2")] - HRESULT GetNextSrc2([out] IAMTimelineObj ** ppSrc, REFTIME * pInOut); - [helpstring("method MoveEverythingBy")] - HRESULT MoveEverythingBy( REFERENCE_TIME Start, REFERENCE_TIME MoveBy ); - [helpstring("method MoveEverythingBy2")] - HRESULT MoveEverythingBy2( REFTIME Start, REFTIME MoveBy ); - [helpstring("method GetSourcesCount")] - HRESULT GetSourcesCount( long * pVal ); - [helpstring("method AreYouBlank")] - HRESULT AreYouBlank( long * pVal ); - [helpstring("method GetSrcAtTime")] - HRESULT GetSrcAtTime( - [out] IAMTimelineObj ** ppSrc, - REFERENCE_TIME Time, - long SearchDirection ); - [helpstring("method GetSrcAtTime2")] - HRESULT GetSrcAtTime2([out] IAMTimelineObj ** ppSrc, REFTIME Time, long SearchDirection ); - HRESULT InsertSpace( REFERENCE_TIME rtStart, REFERENCE_TIME rtEnd ); - HRESULT InsertSpace2( REFTIME rtStart, REFTIME rtEnd ); - HRESULT ZeroBetween( REFERENCE_TIME rtStart, REFERENCE_TIME rtEnd ); - HRESULT ZeroBetween2( REFTIME rtStart, REFTIME rtEnd ); - HRESULT GetNextSrcEx(IAMTimelineObj * pLast, [out] IAMTimelineObj **ppNext); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // This virtual track interface is shared by both the compositions - // and tracks (and groups). - // explained methods: - // TrackGetPriority - used by rendering objects which need to know this. - // SetTrackDirty - !!! not sure if this is useful. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(A8ED5F80-C2C7-11d2-8D39-00A0C9441E20), - odl, - helpstring("IAMTimelineVirtualTrack Interface"), - pointer_default(unique) -] -interface IAMTimelineVirtualTrack : IUnknown -{ - [helpstring("method TrackGetPriority")] - HRESULT TrackGetPriority(long * pPriority); - [helpstring("method SetTrackDirty")] - HRESULT SetTrackDirty( ); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Compositions are like tracks in the sense that they also - // implement IAMVirtualTrack and you can put transitions and effects - // on them, but they really are the SUM of those tracks that they - // contain. They are "embedded" compositions. They should only contain - // media of one particular type (like all video or all audio), but - // this is not enforced. You can add a composition to another - // composition with VTrackInsBefore, just like you can add a track. - // The very top composition to which all other comps and tracks belong - // is a Group, which supports I-AMTimelineGroup as well as I-AMTimelineComp. - // explained methods: - // VTrackInsBefore - does NOT mean VideoTrack. Means Virtual Track. - // Adds a virtual track to a composition at a given priority. - // use -1 to mean "at the end" - // VTrackSwapPriorities - switch two vtracks around. - // VTrackGetCount - get how many vtracks this comp contains. - // GetVTrack - you get the idea - // GetCountOfType - Get the total number of these objects this comp - // and all it's vtracks (recursively) contains. !!! this may be dead. - // GetRecursiveLayerOfType - given a number, returns a given track. This - // is done recursively. You need to pass in a pointer to the number, - // and it will be modified upon exit to an unknown value. DO NOT - // CALL THE VERSION WITH THE POINTER! - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(EAE58536-622E-11d2-8CAD-00A024580902), - odl, - helpstring("IAMTimelineComp Interface"), - pointer_default(unique) -] -interface IAMTimelineComp : IUnknown -{ - [helpstring("method VTrackInsBefore")] - HRESULT VTrackInsBefore(IAMTimelineObj * pVirtualTrack, long Priority); - [helpstring("method VTrackSwapPriorities")] - HRESULT VTrackSwapPriorities(long VirtualTrackA, long VirtualTrackB); - [helpstring("method VTrackGetCount")] - HRESULT VTrackGetCount(long * pVal); - [helpstring("method GetVTrack")] - HRESULT GetVTrack([out] IAMTimelineObj ** ppVirtualTrack, long Which); - [helpstring("method GetCountOfType")] - HRESULT GetCountOfType(long * pVal, long * pValWithComps, TIMELINE_MAJOR_TYPE MajorType ); - [helpstring("method GetRecursiveLayerOfType")] - HRESULT GetRecursiveLayerOfType( - [out] IAMTimelineObj ** ppVirtualTrack, - long WhichLayer, - TIMELINE_MAJOR_TYPE Type); - [helpstring("method GetRecursiveLayerOfTypeI (do not call)")] - HRESULT GetRecursiveLayerOfTypeI( - [out] IAMTimelineObj ** ppVirtualTrack, - [in,out] long * pWhichLayer, - TIMELINE_MAJOR_TYPE Type); - HRESULT GetNextVTrack(IAMTimelineObj *pVirtualTrack, [out] IAMTimelineObj **ppNextVirtualTrack); -}; - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // Groups represent the topmost composition in a timeline. Every - // group should contain media of only one major type (like all video). - // The timeline can contain multiple groups, see it's interface for - // this. Each group has a particular "media type" that you can get/set - // which help identify it. Each group has an associated FPS which - // is used by the render engine in setting up the big switch. All - // cuts on the timeline will happen rounded to this nearest FPS for - // this particular group. Each group has a priority which enables - // writing out multiple-stream files with 1 or more streams of the - // same type. (Like a 2 video stream AVI file). - // explained methods: - // SetTimeline - this is called internally when the group is added. - // Do not call this. - // GetTimeline - get the timeline this group belongs to. - // GetPriority - get this group's priority - // Get/SetOutputFPS - explained above - // SetMediaTypeForVB - method for VB. Pass in 0 for video, 1 for audio - // SetRecompFormatFromSource - set the recompress format based on the - // source that's loaded or set in the IAMTimelineSrc - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(9EED4F00-B8A6-11d2-8023-00C0DF10D434), - odl, - helpstring("IAMTimelineGroup Interface"), - pointer_default(unique) -] -interface IAMTimelineGroup : IUnknown -{ - [helpstring("method SetTimeline")] - HRESULT SetTimeline( IAMTimeline * pTimeline ); - [helpstring("method GetTimeline")] - HRESULT GetTimeline( [out] IAMTimeline ** ppTimeline ); - [helpstring("method GetPriority")] - HRESULT GetPriority( long * pPriority ); - [helpstring("method GetMediaType")] - HRESULT GetMediaType([out] AM_MEDIA_TYPE *); - [helpstring("method SetMediaType")] - HRESULT SetMediaType([in] AM_MEDIA_TYPE *); - [helpstring("method SetOutputFPS")] - HRESULT SetOutputFPS(double FPS); - [helpstring("method GetOutputFPS")] - HRESULT GetOutputFPS(double * pFPS); - [helpstring("method SetGroupName")] - HRESULT SetGroupName( BSTR pGroupName ); - [helpstring("method GetGroupName")] - HRESULT GetGroupName( [out,retval] BSTR * pGroupName ); - // in preview mode, skip frames. In authoring mode, don't - [helpstring("method SetPreviewMode")] - HRESULT SetPreviewMode( BOOL fPreview ); - [helpstring("method GetPreviewMode")] - HRESULT GetPreviewMode( BOOL *pfPreview ); - [helpstring("method SetMediaTypeForVB")] - HRESULT SetMediaTypeForVB([in] long Val ); - // how many frames ahead switch can run - [helpstring("method GetOutputBuffering")] - HRESULT GetOutputBuffering([out] int *pnBuffer ); - [helpstring("method SetOutputBuffering")] - HRESULT SetOutputBuffering([in] int nBuffer ); - - HRESULT SetSmartRecompressFormat( long * pFormat ); - HRESULT GetSmartRecompressFormat( long ** ppFormat ); - HRESULT IsSmartRecompressFormatSet( BOOL * pVal ); - HRESULT IsRecompressFormatDirty( BOOL * pVal ); - HRESULT ClearRecompressFormatDirty( ); - HRESULT SetRecompFormatFromSource( IAMTimelineSrc * pSource ); -}; - - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // The main timeline. This is the base object you use to set - // properties of the timeline as a whole, and to create blank - // objects for use within the timeline. You cannot create the - // objects using COM methods, you must go through the timeline to - // create this. That's because certain information is set before - // handing the object back to you. Every object created by the - // timeline will support at LEAST IAMTimelineObj. For any timeline, - // it can have one or more "groups" that it knows about. Each group - // has the capability to hold a complete sub-tree containing media - // that is all of one type. This logical seperation is used for the - // rendering engine, but is not strictly enforced. - // explained methods: - // CreateEmptyNode - pass in a mid type and it will pass back - // an object of the type you requested. - // AddGroup - add a created group to the tree - // RemGroupFromList - make sure timeline no longer knows about this group. - // does NOT do anything to the group itself. Normally the user - // does not want to call this, it's called from the Group's Remove( ) method. - // GetGroup - get a certain group - // GetGroupCount - get how many groups - // ClearAllGroups - clear everything - // GetInsertMode - ask what the insert mode is, overlay or insert - // SetInsertMode - set whether to insert or overlay - // EnableTransitions - turn transitions on or off as a whole - // EnableEffects - same deal. - // SetIntererstRange - discard sub-objects outside of a given - // time range, to save memory/resources - // Get/SetDefaultFPS - set the 'default' FPS for this timeline, - // the RenderEngine reads this information for setting itself up - // by default. - // GetCountOfType - ask for how many of a given thing are in a given - // group. !!! this may be a useless function. - // !!! not implemented - // IsDirty - asks if anything in the timeline needs to be redrawn - // GetDirtyRange - same deal - // ValidateSourceNames - make sure the filenames in the sources - // really exist. Use the same enum flags as the render engine - // uses for SetSourceNameValidation. Source's filenames will be - // changed to those of the found ones in the timeline. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -[ - object, - uuid(78530B74-61F9-11D2-8CAD-00A024580902), - odl, - helpstring("IAMTimeline Interface"), - pointer_default(unique) -] -interface IAMTimeline : IUnknown -{ - [helpstring("method CreateEmptyNode")] - HRESULT CreateEmptyNode([out] IAMTimelineObj ** ppObj, TIMELINE_MAJOR_TYPE Type ); - HRESULT AddGroup( IAMTimelineObj * pGroup ); - HRESULT RemGroupFromList( IAMTimelineObj * pGroup ); - HRESULT GetGroup( [out] IAMTimelineObj ** ppGroup, long WhichGroup ); - HRESULT GetGroupCount( long * pCount ); - HRESULT ClearAllGroups( ); - HRESULT GetInsertMode( long * pMode ); - [helpstring("method SetInsertMode")] - HRESULT SetInsertMode(long Mode); - [helpstring("method EnableTransitions")] - HRESULT EnableTransitions(BOOL fEnabled); - [helpstring("method TransitionsEnabled")] - HRESULT TransitionsEnabled(BOOL * pfEnabled); - [helpstring("method EnableEffects")] - HRESULT EnableEffects(BOOL fEnabled); - [helpstring("method EffectsEnabled")] - HRESULT EffectsEnabled(BOOL * pfEnabled); - [helpstring("method SetInterestRange")] - HRESULT SetInterestRange(REFERENCE_TIME Start, REFERENCE_TIME Stop); - [helpstring("method GetDuration")] - HRESULT GetDuration(REFERENCE_TIME * pDuration); - [helpstring("method GetDuration2")] - HRESULT GetDuration2(double * pDuration); - [helpstring("method SetDefaultFPS")] - HRESULT SetDefaultFPS(double FPS); - [helpstring("method GetDefaultFPS")] - HRESULT GetDefaultFPS(double * pFPS); - [helpstring("method IsDirty")] - HRESULT IsDirty(BOOL * pDirty); - [helpstring("method GetDirtyRange")] - HRESULT GetDirtyRange(REFERENCE_TIME * pStart, REFERENCE_TIME * pStop); - [helpstring("method GetCountOfType")] - HRESULT GetCountOfType(long Group, long * pVal, long * pValWithComps, TIMELINE_MAJOR_TYPE MajorType ); - HRESULT ValidateSourceNames( long ValidateFlags, IMediaLocator * pOverride, LONG_PTR NotifyEventHandle ); - - HRESULT SetDefaultTransition( GUID * pGuid ); - HRESULT GetDefaultTransition( GUID * pGuid ); - HRESULT SetDefaultEffect( GUID * pGuid ); - HRESULT GetDefaultEffect( GUID * pGuid ); - HRESULT SetDefaultTransitionB( BSTR pGuid ); - HRESULT GetDefaultTransitionB( [out,retval] BSTR * pGuid ); - HRESULT SetDefaultEffectB( BSTR pGuid ); - HRESULT GetDefaultEffectB( [out,retval] BSTR * pGuid ); -}; - -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// -// XML STUFF --- XML STUFF --- XML STUFF --- XML STUFF --- XML -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// - -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -// Xml2Dex - converts back and forth between XML and a dexter project -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -[ - object, - uuid(18C628ED-962A-11D2-8D08-00A0C9441E20), - odl, - helpstring("IXml2Dex Interface"), - pointer_default(unique) -] -interface IXml2Dex : IDispatch -{ - [id(1), helpstring("method CreateGraphFromFile")] - HRESULT CreateGraphFromFile([out] IUnknown ** ppGraph, IUnknown * pTimeline, BSTR Filename); - [id(2), helpstring("method WriteGrfFile")] - HRESULT WriteGrfFile(IUnknown * pGraph, BSTR FileName); - [id(3), helpstring("method WriteXMLFile")] - HRESULT WriteXMLFile(IUnknown * pTimeline, BSTR FileName); - [id(5), helpstring("method ReadXMLFile")] - HRESULT ReadXMLFile(IUnknown *pTimeline, BSTR XMLName); - [id(6), helpstring("method Delete")] - HRESULT Delete(IUnknown *pTimeline, double dStart, double dEnd); - [id(7), helpstring("method WriteXMLPart")] - HRESULT WriteXMLPart(IUnknown * pTimeline, double dStart, double dEnd, BSTR FileName); - [id(8), helpstring("method PasteXMLFile")] - HRESULT PasteXMLFile(IUnknown * pTimeline, double dStart, BSTR FileName); - [id(9), helpstring("method CopyXML")] - HRESULT CopyXML(IUnknown * pTimeline, double dStart, double dEnd); - [id(10), helpstring("method PasteXML")] - HRESULT PasteXML(IUnknown * pTimeline, double dStart); - [id(11), helpstring("method Reset")] - HRESULT Reset( ); - [id(12), helpstring("method ReadXML")] - HRESULT ReadXML(IUnknown *pTimeline, IUnknown *pXML); - [id(13), helpstring("method WriteXML")] - HRESULT WriteXML(IUnknown *pTimeline, BSTR *pbstrXML); -}; - -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// -// USEFUL HELPER INTERFACES -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// - -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -// IAMErrorLog - an interface that receives error information from -// a timeline or a render engine. -//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -[ - object, - uuid(E43E73A2-0EFA-11d3-9601-00A0C9441E20), - odl, - helpstring("IAMErrorLog Interface"), - pointer_default(unique) -] -interface IAMErrorLog : IUnknown -{ - [helpstring("method LogError")] HRESULT LogError(long Severity, BSTR pErrorString, long ErrorCode, long hresult, [in] VARIANT * pExtraInfo ); -}; - -[ - object, - uuid(963566DA-BE21-4eaf-88E9-35704F8F52A1), - odl, - helpstring("IAMSetErrorLog Interface"), - pointer_default(unique) -] -interface IAMSetErrorLog : IUnknown -{ - [propget, helpstring("property ErrorLog")] HRESULT ErrorLog([out, retval] IAMErrorLog * *pVal); - [propput, helpstring("property ErrorLog")] HRESULT ErrorLog([in] IAMErrorLog * newVal); -}; - -[ - object, - uuid(0579154A-2B53-4994-B0D0-E773148EFF85), - local, - helpstring("ISampleGrabberCB Interface"), - pointer_default(unique) -] -interface ISampleGrabberCB : IUnknown -{ - HRESULT SampleCB( double SampleTime, IMediaSample * pSample ); - HRESULT BufferCB( double SampleTime, BYTE * pBuffer, long BufferLen ); -} - -[ - object, - uuid(6B652FFF-11FE-4fce-92AD-0266B5D7C78F), - local, - helpstring("ISampleGrabber Interface"), - pointer_default(unique) -] -interface ISampleGrabber: IUnknown -{ - // set this to have the filter immediate stop after - // garnishing a sample - // - HRESULT SetOneShot( BOOL OneShot ); - - // set what media type we connect to. It can be partially - // specified by setting only the major type, OR the major and - // subtype, OR major, subtype, and the formattype. - // - HRESULT SetMediaType( const AM_MEDIA_TYPE * pType ); - - // after something's connected to this filter, find out - // what it is - // - HRESULT GetConnectedMediaType( AM_MEDIA_TYPE * pType ); - - // call this to buffer incoming samples, so the next two methods will work - // If this is not called, the next two methods will return - // E_INVALIDARG - // - HRESULT SetBufferSamples( BOOL BufferThem ); - - // pass in NULL for pBuffer to get out the buffer size you need to - // allocate. This will NOT return a pointer to a compressed dib - // any longer! It will return the IMediaSample's GetPointer buffer. - // - HRESULT GetCurrentBuffer( [in,out] long * pBufferSize, [out] long * pBuffer ); - - // return the currently buffered sample - // - HRESULT GetCurrentSample( [out,retval] IMediaSample ** ppSample ); - - // if this callback is set, then it will be called for - // every sample passing through the filter. Do not take a long time - // in the callback for smooth playback (obviously!) - // - HRESULT SetCallback( ISampleGrabberCB * pCallback, long WhichMethodToCallback ); -}; - -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// -// THE LIBRARY ITSELF -//////////////////////////////////////////////////////////////// -//////////////////////////////////////////////////////////////// - -[ - uuid(78530B68-61F9-11D2-8CAD-00A024580902), - version(1.0), - helpstring("Dexter 1.0 Type Library") -] -library DexterLib -{ - importlib("stdole2.tlb"); - - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - // resize the input video to an output size, for uniformity within DES. - // DES will set the output media type and probably also put_Size. By setting - // the output media type, DES is stating the resizer must produce only that - // media type on the output pin, unless it is succeeded by a put_Size call. - // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [ - object, - uuid(4ada63a0-72d5-11d2-952a-0060081840bc), - odl, - helpstring("IResize Interface"), - pointer_default(unique) - ] - interface IResize : IUnknown - { - HRESULT get_Size([out] int *piHeight, [out] int *piWidth, [out] long *pFlag); - HRESULT get_InputSize([out] int *piHeight, [out] int *piWidth); - HRESULT put_Size([in] int Height, [in] int Width, [in] long Flag); - HRESULT get_MediaType([out] AM_MEDIA_TYPE *pmt); - HRESULT put_MediaType([in] const AM_MEDIA_TYPE *pmt); - }; - - [ - uuid(78530B75-61F9-11D2-8CAD-00A024580902), - helpstring("AMTimeline Class") - ] - coclass AMTimeline - { - [default] interface IAMTimeline; - interface IPersistStream; - interface IAMSetErrorLog; - }; - - [ - uuid(78530B78-61F9-11D2-8CAD-00A024580902), - helpstring("IAMTimelineObj Class") - ] - coclass AMTimelineObj - { - [default] interface IAMTimelineObj; - }; - - [ - uuid(78530B7A-61F9-11D2-8CAD-00A024580902), - helpstring("IAMTimelineSrc Class") - ] - coclass AMTimelineSrc - { - [default] interface IAMTimelineSrc; - interface IAMTimelineObj; - interface IAMTimelineEffectable; - interface IAMTimelineSplittable; - }; - - [ - uuid(8F6C3C50-897B-11d2-8CFB-00A0C9441E20), - ] - coclass AMTimelineTrack - { - [default] interface IAMTimelineTrack; - interface IAMTimelineObj; - interface IAMTimelineEffectable; - interface IAMTimelineTransable; - interface IAMTimelineVirtualTrack; - interface IAMTimelineSplittable; - }; - - [ - uuid(74D2EC80-6233-11d2-8CAD-00A024580902), - ] - coclass AMTimelineComp - { - [default] interface IAMTimelineComp; - interface IAMTimelineObj; - interface IAMTimelineEffectable; - interface IAMTimelineTransable; - interface IAMTimelineVirtualTrack; - }; - - [ - uuid(F6D371E1-B8A6-11d2-8023-00C0DF10D434), - ] - coclass AMTimelineGroup - { - [default] interface IAMTimelineGroup; - interface IAMTimelineComp; - interface IAMTimelineObj; - }; - - [ - uuid(74D2EC81-6233-11d2-8CAD-00A024580902), - ] - coclass AMTimelineTrans - { - [default] interface IAMTimelineTrans; - interface IAMTimelineObj; - interface IAMTimelineSplittable; - }; - - [ - uuid(74D2EC82-6233-11d2-8CAD-00A024580902), - ] - coclass AMTimelineEffect - { - [default] interface IAMTimelineEffect; - interface IAMTimelineObj; - interface IAMTimelineSplittable; - interface IPropertyBag; - }; - - [ - uuid(64D8A8E0-80A2-11d2-8CF3-00A0C9441E20), - ] - coclass RenderEngine - { - [default] interface IRenderEngine; - interface IRenderEngine2; - interface IAMSetErrorLog; - }; - - [ - uuid(498B0949-BBE9-4072-98BE-6CCAEB79DC6F), - ] - coclass SmartRenderEngine - { - [default] interface IRenderEngine; - interface ISmartRenderEngine; - interface IAMSetErrorLog; - }; - - [ - uuid(036A9790-C153-11d2-9EF7-006008039E37), - ] - coclass AudMixer - { - [default] interface IBaseFilter; - }; - - [ - uuid(18C628EE-962A-11D2-8D08-00A0C9441E20), - helpstring("Xml2Dex Class") - ] - coclass Xml2Dex - { - [default] interface IXml2Dex; - }; - - [ - uuid(CC1101F2-79DC-11D2-8CE6-00A0C9441E20), - helpstring("MediaLocator Class") - ] - coclass MediaLocator - { - [default] interface IMediaLocator; - }; - - [ - uuid(ADF95821-DED7-11d2-ACBE-0080C75E246E), - helpstring("Varying Property Holder") - ] - coclass PropertySetter - { - [default] interface IPropertySetter; - interface IAMSetErrorLog; - }; - - [ - uuid(65BD0711-24D2-4ff7-9324-ED2E5D3ABAFA), - helpstring("MediaDet Class") - ] - coclass MediaDet - { - [default] interface IMediaDet; - }; - - [ - uuid(C1F400A0-3F08-11d3-9F0B-006008039E37), - helpstring("MsGrab Class") - ] - coclass SampleGrabber - { - [default] interface ISampleGrabber; - }; - - // useful for movie maker and other people - [ - uuid(C1F400A4-3F08-11d3-9F0B-006008039E37), - helpstring("NullRenderer Class") - ] - coclass NullRenderer - { - [default] interface IBaseFilter; - }; - - [ - uuid(BB44391D-6ABD-422f-9E2E-385C9DFF51FC), - helpstring("DxtCompositor Class") - ] - coclass DxtCompositor - { - [default] interface IDxtCompositor; - }; - - [ - uuid(506D89AE-909A-44f7-9444-ABD575896E35), - helpstring("DxtAlphaSetter Class") - ] - coclass DxtAlphaSetter - { - [default] interface IDxtAlphaSetter; - }; - - [ - uuid(DE75D012-7A65-11D2-8CEA-00A0C9441E20), - helpstring("SMPTE wipe DXT") - ] - coclass DxtJpeg - { - [default] interface IDxtJpeg; - }; - - [ - uuid(0cfdd070-581a-11d2-9ee6-006008039e37), - ] - coclass ColorSource - { - [default] interface IBaseFilter; - }; - - [ - uuid(C5B19592-145E-11d3-9F04-006008039E37), - helpstring("DxtKey Class") - ] - coclass DxtKey - { - [default] interface IDxtKey; - }; -}; - -// these are some error codes that we can/will return -enum -{ - E_NOTINTREE = 0x80040400, - E_RENDER_ENGINE_IS_BROKEN = 0x80040401, - E_MUST_INIT_RENDERER = 0x80040402, - E_NOTDETERMINED = 0x80040403, - E_NO_TIMELINE = 0x80040404, - S_WARN_OUTPUTRESET = 40404 -}; - -// These codes are given to the app in IAMErrorLog to help identify what went wrong - -// Filename doesn't exist, or DShow doesn't recognize the filetype -// EXTRA - filename -cpp_quote("#define DEX_IDS_BAD_SOURCE_NAME 1400") - -// Filename doesn't exist or contains unknown data -// EXTRA - filename (maybe no codec?) -cpp_quote("#define DEX_IDS_BAD_SOURCE_NAME2 1401") - -// filename was required, but wasn't given -cpp_quote("#define DEX_IDS_MISSING_SOURCE_NAME 1402") - -// cannot parse data provided by this source -// !!! what source? -cpp_quote("#define DEX_IDS_UNKNOWN_SOURCE 1403") - -// unexpected error - some DShow component not installed correctly -cpp_quote("#define DEX_IDS_INSTALL_PROBLEM 1404") - -// Source filter does not accept filenames -// !!! What source? -cpp_quote("#define DEX_IDS_NO_SOURCE_NAMES 1405") - -// The group's mediatype is not supported -// EXTRA - gives you an integer group number -cpp_quote("#define DEX_IDS_BAD_MEDIATYPE 1406") - -// Invalid stream number for a source -// EXTRA - gives the stream number !!! should identify which source! -cpp_quote("#define DEX_IDS_STREAM_NUMBER 1407") - -// You ran out of memory -cpp_quote("#define DEX_IDS_OUTOFMEMORY 1408") - -// One bitmap in a sequence was not the same type as the others -// EXTRA - gives the bitmap name -cpp_quote("#define DEX_IDS_DIBSEQ_NOTALLSAME 1409") - -// Clip's mediatimes are invalid, or DibSeq too short, or a previous error caused this -// !!! Needs to give the clip name -cpp_quote("#define DEX_IDS_CLIPTOOSHORT 1410") - -// Clsid of FX/Transition is not a DirectX Transform -// EXTRA - gives the CLSID -cpp_quote("#define DEX_IDS_INVALID_DXT 1411") - -// Default FX/Transition Clsid is not a DirectX Transform" -// EXTRA - gives the CLSID -cpp_quote("#define DEX_IDS_INVALID_DEFAULT_DXT 1412") - -// Your version of DX doesn't support 3D transforms" -// EXTRA - gives the CLSID of the 3D transform you tried to use -cpp_quote("#define DEX_IDS_NO_3D 1413") - -// This DirectX Transform is not the right kind, or is broken -// EXTRA - gives the CLSID of the broken transform -cpp_quote("#define DEX_IDS_BROKEN_DXT 1414") - -// No such property exists on an object -// EXTRA - gives the name of the property (if given as a string) -cpp_quote("#define DEX_IDS_NO_SUCH_PROPERTY 1415") - -// Illegal value for a property -// EXTRA - gives the VARIANT value that was illegal -cpp_quote("#define DEX_IDS_ILLEGAL_PROPERTY_VAL 1416") - -// Syntax error in XML file at line: -// EXTRA - gives I4 line number, if available -cpp_quote("#define DEX_IDS_INVALID_XML 1417") - -// Can't find filter specified in XML by Category and Instance -// EXTRA - gives friendly name (instance) -cpp_quote("#define DEX_IDS_CANT_FIND_FILTER 1418") - -// Disk error writing XML file -cpp_quote("#define DEX_IDS_DISK_WRITE_ERROR 1419") - -// Clsid not a valid DShow audio effect filter -// EXTRA - gives the CLSID -cpp_quote("#define DEX_IDS_INVALID_AUDIO_FX 1420") - -// Cannot find compressor for smart recompression type -cpp_quote("#define DEX_IDS_CANT_FIND_COMPRESSOR 1421") - - - -// !!! Here go problems hooking up sources or finding codecs - - -// THE FOLLOWING SHOULD NEVER HAPPEN - please call me if they do - -// Unexpected error in parsing the timeline -cpp_quote("#define DEX_IDS_TIMELINE_PARSE 1426") -// Unexpected error building the filtergraph -cpp_quote("#define DEX_IDS_GRAPH_ERROR 1427") -// Unexpected error with the internal grid -cpp_quote("#define DEX_IDS_GRID_ERROR 1428") -// Unexpected error getting an interface -cpp_quote("#define DEX_IDS_INTERFACE_ERROR 1429") - -// these are the enumeration categories for effects -// -cpp_quote("EXTERN_GUID(CLSID_VideoEffects1Category, 0xcc7bfb42, 0xf175, 0x11d1, 0xa3, 0x92, 0x0, 0xe0, 0x29, 0x1f, 0x39, 0x59);") -cpp_quote("EXTERN_GUID(CLSID_VideoEffects2Category, 0xcc7bfb43, 0xf175, 0x11d1, 0xa3, 0x92, 0x0, 0xe0, 0x29, 0x1f, 0x39, 0x59);") -cpp_quote("EXTERN_GUID(CLSID_AudioEffects1Category, 0xcc7bfb44, 0xf175, 0x11d1, 0xa3, 0x92, 0x0, 0xe0, 0x29, 0x1f, 0x39, 0x59);") -cpp_quote("EXTERN_GUID(CLSID_AudioEffects2Category, 0xcc7bfb45, 0xf175, 0x11d1, 0xa3, 0x92, 0x0, 0xe0, 0x29, 0x1f, 0x39, 0x59);") - |