qedit.idl
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:68k
- //------------------------------------------------------------------------------
- // File: QEdit.idl
- //
- // Desc:
- //
- // Copyright (c) 1992 - 2000, 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. Probably
- // silly of me.
- 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);
- };
- // 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 );
- };
- // 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.
- // MoveAllSources - bump a bunch of sources 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
- // MakeSpace - !!! what does this do, anyhow?
- // RemoveSlice - !!! what does this do, anyhow?
- // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- [
- 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("stdole32.tlb");
- importlib("stdole2.tlb");
- [
- 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 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);")