re3/dxsdk/Include/DShowIDL/qedit.idl

1735 lines
67 KiB
Plaintext
Raw Normal View History

//------------------------------------------------------------------------------
// 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);")