//
// ITitleOverlay.h
// Desc: DirectShow sample code - custom interface
//

#ifndef __H_ITitleOverlay__
#define __H_ITitleOverlay__

#ifdef __cplusplus
extern "C" {
#endif


//----------------------------------------------------------------------------
// ITitleOverlay's GUID

// {5E5B3386-6F9F-4a47-AC8B-7A302138D7FF}
DEFINE_GUID(IID_ITitleOverlay, 
0x5e5b3386, 0x6f9f, 0x4a47, 0xac, 0x8b, 0x7a, 0x30, 0x21, 0x38, 0xd7, 0xff);

//----------------------------------------------------------------------------

//----------------------------------------------------------------------------
// ITitleOverlay
//----------------------------------------------------------------------------
DECLARE_INTERFACE_(ITitleOverlay, IUnknown)
{
	// 設置Filter進行疊加的類型，如果需要改變類型，這個函數必須第一個設置，
	// 調用這個函數成功后，才能調用其他的函數進行參數設置。
	// 可以設置的疊加類型參見枚舉類型OVERLAY_TYPE的定義。
	STDMETHOD(put_TitleOverlayType) (THIS_
		long inOverlayType   
	) PURE;

	STDMETHOD(get_TitleOverlayType) (THIS_
		long * outOverlayType     
	) PURE;

	// 設置像素轉換的方式（可選），默認使用直接替換方式。
	// 當字符顏色與視頻背景顏色接近時，使用翻轉疊加方式比較合適。
	STDMETHOD(put_TitleOverlayStyle) (THIS_
		int inUsingCover   
	) PURE;

	STDMETHOD(get_TitleOverlayStyle) (THIS_
		int * outUsingCover     
	) PURE;

	// 設置欲疊加字符的內容
	STDMETHOD(put_Title) (THIS_
		const char * inTitle, int inLength    
	) PURE;

	STDMETHOD(get_Title) (THIS_
		char * outBuffer, int * outLength     
	) PURE;

	// 設置欲疊加字符的顏色，分別為R, G, B分量值
	STDMETHOD(put_TitleColor) (THIS_ 
		BYTE inR, BYTE inG, BYTE inB  
	) PURE;

	STDMETHOD(get_TitleColor) (THIS_
		BYTE * outR, BYTE * outG, BYTE * outB    
	) PURE;

	// 設置欲疊加字符的開始坐標
	STDMETHOD(put_TitleStartPosition) (THIS_
		POINT inStartPos
	) PURE;

	STDMETHOD(get_TitleStartPosition) (THIS_
		POINT * outStartPos  
	) PURE;

	// 設置欲疊加字符的字體，參數采用Windows GDI的LOGFONT數據結構
	STDMETHOD(put_TitleFont) (THIS_  
		LOGFONT inFont
	) PURE;

	STDMETHOD(get_TitleFont) (THIS_
		LOGFONT * outFont  
	) PURE;

	// 設置欲疊加字符的生存周期，參數一個是開始時間，一個是結束時間，以秒為單位
	// 如果inEnd值為-1，表示一直迭加到視頻結束
	STDMETHOD(put_TitleDuration) (THIS_  
		double inStart, double inEnd
	) PURE;

	STDMETHOD(get_TitleDuration) (THIS_
		double * outStart, double * outEnd
	) PURE;
};
//----------------------------------------------------------------------------

#ifdef __cplusplus
}
#endif

#endif // __H_ITitleOverlay__