本文分析一下《DirectShow开发指南》中的一个典型的Transform Filter的例子：字幕叠加（FilterTitleOverlay）。通过分析该例子，我们可以学习到DirectShowTransform Filter 开发的方式。
直接打开项目工程（我这里是VC2010），看到项目的结构如下图所示：
先看一下运行的结果：
注意，DirectShow的Filter是不可以直接运行进行调试的。一般情况下需要借助于Graphedit.exe这个程序进行调试。当然这不是绝对的，也可以用graph-studio-next这样的开源程序。
选择右键点击工程->属性->调试->命令。在栏中输入Graphedit.exe的路径，如图所示
这样就可以调试Filter了。
拖入一个文件"五月天 咸鱼.mp4"，然后插入本工程的Filter，如图所示。
播放视频，效果如图，可见左上角显示出 "Hello, DirectShow!" 的字样。
看完了结果，就要开始分析代码了~
回顾一下工程结构图：
先看一下CFilterTitleOverlay.h（已经在重要的地方加了注释）：
//
// CFilterTitleOverlay.h
//
#ifndef __H_CFilterTitleOverlay__
#define __H_CFilterTitleOverlay__
#include "ITitleOverlay.h"
#include "COverlayController.h"
#include "OverlayDefs.h"
class CFilterTitleOverlay : public CTransInPlaceFilter
, public ISpecifyPropertyPages
, public ITitleOverlay
{
private:
OVERLAY_TYPE mOverlayType;
COverlayController * mOverlayController;
CCritSec mITitleOverlaySync;
BOOL mNeedEstimateFrameRate;
private:
CFilterTitleOverlay(TCHAR *tszName, LPUNKNOWN punk, HRESULT *phr);
~CFilterTitleOverlay();
HRESULT SetInputVideoInfoToController(void);
void ReleaseOverlayController(void);
void SideEffectOverlayTypeChanged(void);
public:
static CUnknown * WINAPI CreateInstance(LPUNKNOWN punk, HRESULT *phr);
//说明必须重写NonDelegatingQueryInterface
DECLARE_IUNKNOWN;
// Basic COM - used here to reveal our own interfaces
//暴露接口，使外部程序可以QueryInterface，关键！
STDMETHODIMP NonDelegatingQueryInterface(REFIID riid, void ** ppv);
// check if you can support mtIn
virtual HRESULT CheckInputType(const CMediaType* mtIn); // PURE
//必须重写的核心函数
virtual HRESULT Transform(IMediaSample *pSample); // PURE
// Delegating methods
virtual HRESULT CompleteConnect(PIN_DIRECTION direction, IPin *pReceivePin);
virtual HRESULT StartStreaming();
virtual HRESULT StopStreaming();
// --- ISpecifyPropertyPages ---
STDMETHODIMP GetPages(CAUUID *pPages);
// --- ITitleOverlay methods ---
//都是接口函数
STDMETHODIMP put_TitleOverlayType(long inOverlayType);
STDMETHODIMP get_TitleOverlayType(long * outOverlayType);
STDMETHODIMP put_TitleOverlayStyle(int inUsingCover);
STDMETHODIMP get_TitleOverlayStyle(int * outUsingCover);
STDMETHODIMP put_Title(const char * inTitle, int inLength);
STDMETHODIMP get_Title(char * outBuffer, int * outLength);
STDMETHODIMP put_TitleColor(BYTE inR, BYTE inG, BYTE inB);
STDMETHODIMP get_TitleColor(BYTE * outR, BYTE * outG, BYTE * outB);
STDMETHODIMP put_TitleStartPosition(POINT inStartPos);
STDMETHODIMP get_TitleStartPosition(POINT * outStartPos);
STDMETHODIMP put_TitleFont(LOGFONT inFont);
STDMETHODIMP get_TitleFont(LOGFONT * outFont);
STDMETHODIMP put_TitleDuration(double inStart, double inEnd);
STDMETHODIMP get_TitleDuration(double * outStart, double * outEnd);
};
#endif // __H_CFilterTitleOverlay__
CFilterTitleOverlay继承了CTransInPlaceFilter，意味着Transform()函数输入和输出的数据位于同一块内存中。
以下几个函数是必须有的：
CreateInstance()：创建Filter
NonDelegatingQueryInterface()：暴露接口，使外部程序可以QueryInterface
CheckInputType()：检查输入类型
Transform()：核心处理函数（字幕叠加）
另外还包含了ITitleOverlay中的函数put_TitleOverlayType()等等一大堆。
下面看一下CFilterTitleOverlay.cpp吧，先列出注册信息部分：
//唯一标识符
// {E3FB4BFE-8E5C-4aec-8162-7DA55BE486A1}
DEFINE_GUID(CLSID_HQTitleOverlay,
0xe3fb4bfe, 0x8e5c, 0x4aec, 0x81, 0x62, 0x7d, 0xa5, 0x5b, 0xe4, 0x86, 0xa1);
// {E70FE57A-19AA-4a4c-B39A-408D49D73851}
DEFINE_GUID(CLSID_HQTitleOverlayProp,
0xe70fe57a, 0x19aa, 0x4a4c, 0xb3, 0x9a, 0x40, 0x8d, 0x49, 0xd7, 0x38, 0x51);
//
// setup data
//
//注册时候的信息
const AMOVIESETUP_MEDIATYPE sudPinTypes =
{
&MEDIATYPE_NULL, // Major type
&MEDIASUBTYPE_NULL // Minor type
};
//注册时候的信息
const AMOVIESETUP_PIN psudPins[] =
{
{
L"Input", // String pin name
FALSE, // Is it rendered
FALSE, // Is it an output
FALSE, // Allowed none
FALSE, // Allowed many
&CLSID_NULL, // Connects to filter
L"Output", // Connects to pin
1, // Number of types
&sudPinTypes }, // The pin details
{ L"Output", // String pin name
FALSE, // Is it rendered
TRUE, // Is it an output
FALSE, // Allowed none
FALSE, // Allowed many
&CLSID_NULL, // Connects to filter
L"Input", // Connects to pin
1, // Number of types
&sudPinTypes // The pin details
}
};
//注册时候的信息
const AMOVIESETUP_FILTER sudFilter =
{
&CLSID_HQTitleOverlay, // Filter CLSID
L"HQ Title Overlay Std.", // Filter name
MERIT_DO_NOT_USE, // Its merit
2, // Number of pins
psudPins // Pin details
};
// List of class IDs and creator functions for the class factory. This
// provides the link between the OLE entry point in the DLL and an object
// being created. The class factory will call the static CreateInstance
//注意g_Templates名称是固定的
CFactoryTemplate g_Templates[] =
{
{
L"HQ Title Overlay Std.",
&CLSID_HQTitleOverlay,
CFilterTitleOverlay::CreateInstance,
NULL,
&sudFilter
},
{
L"HQ Title Overlay Property Page",
&CLSID_HQTitleOverlayProp,
CTitleOverlayProp::CreateInstance
}
};
int g_cTemplates = sizeof(g_Templates) / sizeof(g_Templates[0]);
这一部分并不属于CFilterTitleOverlay这个类。主要是DirectShow Filter的一些注册信息。其结构是非常固定的。
再来看看CFilterTitleOverlay中函数实现部分（只列了几个函数，不然内容太多= =）：
CreateInstance()：
//
// CreateInstance
//
// Override CClassFactory method.
// Provide the way for COM to create a CNullInPlace object
//
//创建
CUnknown * WINAPI CFilterTitleOverlay::CreateInstance(LPUNKNOWN punk, HRESULT *phr)
{
#if 1
//防伪？？！！
char szCreatorPath[256], szCreatorName[256];
::strcpy(szCreatorPath, "");
::strcpy(szCreatorName, "");
HMODULE hModule = ::GetModuleHandle(NULL);
::GetModuleFileName(hModule, szCreatorPath, 256);
char * backSlash = ::strrchr(szCreatorPath, '\\');
if (backSlash)
{
strcpy(szCreatorName, backSlash);
}
::_strlwr(szCreatorName);
// Please specify your app name with lowercase
// 检查调用该Filter的程序
// 一开始调试不了，就卡在这了 = =
if (::strstr(szCreatorName, "graphedit") == NULL &&
::strstr(szCreatorName, "ourapp") == NULL)
{
*phr = E_FAIL;
return NULL;
}
#endif
//通过New对象的方法
CFilterTitleOverlay *pNewObject = new CFilterTitleOverlay(NAME("TitleOverlay"), punk, phr);
if (pNewObject == NULL)
{
*phr = E_OUTOFMEMORY;
}
return pNewObject;
}
NonDelegatingQueryInterface()：
//
// Basic COM - used here to reveal our own interfaces
//暴露接口，使外部程序可以QueryInterface，关键！
STDMETHODIMP CFilterTitleOverlay::NonDelegatingQueryInterface(REFIID riid, void ** ppv)
{
CheckPointer(ppv, E_POINTER);
//根据不同的REFIID，获得不同的接口指针
if (riid == IID_ISpecifyPropertyPages)
{
return GetInterface((ISpecifyPropertyPages *) this, ppv);
}
else if (riid == IID_ITitleOverlay)
{
return GetInterface((ITitleOverlay *) this, ppv);
}
else
{
//不是以上的REFIID的话，调用父类的
return CTransInPlaceFilter::NonDelegatingQueryInterface(riid, ppv);
}
} // NonDelegatingQueryInterface
CheckInputType()：
// Only RGB 32/24/565/555 supported
HRESULT CFilterTitleOverlay::CheckInputType(const CMediaType* mtIn)
{
// Dynamic format change will never be allowed!
if (IsStopped() && *mtIn->Type() == MEDIATYPE_Video)
{
if (*mtIn->Subtype() == MEDIASUBTYPE_RGB32 ||
*mtIn->Subtype() == MEDIASUBTYPE_RGB24 ||
*mtIn->Subtype() == MEDIASUBTYPE_RGB555 ||
*mtIn->Subtype() == MEDIASUBTYPE_RGB565)
{
return NOERROR;
}
}
return E_INVALIDARG;
}
Transform()：
HRESULT CFilterTitleOverlay::Transform(IMediaSample *pSample)
{
// If we cann't read frame rate info from input pin's connection media type,
// We estimate it from the first sample's time stamp!
if (mNeedEstimateFrameRate)
{
mNeedEstimateFrameRate = FALSE;
REFERENCE_TIME startTime = 0;
REFERENCE_TIME endTime = 0;
double estimated = 25;
if (SUCCEEDED(pSample->GetTime(&startTime, &endTime)))
{
estimated = 1.0 * UNITS / (endTime - startTime);
}
mOverlayController->SetEstimatedFrameRate(estimated);
}
if (mOverlayType != OT_NONE)
{
//PBYTE是unsigned char
PBYTE pData = NULL;
//获取IMediaSample中的数据
pSample->GetPointer(&pData);
//叠加
mOverlayController->DoTitleOverlay(pData);
}
return NOERROR;
}
下面列出实现ITitleOverlay接口的函数的实现，就列了一个。
STDMETHODIMP CFilterTitleOverlay::get_Title(char * outBuffer, int * outLength)
{
CAutoLock lockit(&mITitleOverlaySync);
*outLength = mOverlayController->GetTitle(outBuffer);
return NOERROR;
}
暂且分析到这里。
书上提供的代码有误，这是经过修改后，添加了注释的代码：
http://download.csdn.net/detail/leixiaohua1020/6371819
相关推荐
DirectShow Transform Filter最典型的例子，带注释，难度不大，学习必备 博客对应文章http://blog.csdn.net/leixiaohua1020/article/details/12498975
FileStreamDecode(Directshow) -- 本例子基于Directshow框架，实现了一个自定义的Renderer Filter，带渲染视频功能，并且可以在视频上叠加OSD文字和Logo图标，用到Directdraw API渲染视频和叠加字幕。
DirectShow是一种由微软公司开发的多媒体框架，用于处理视频和音频流。它是Windows平台上进行多媒体处理的核心技术之一，尤其在实时播放和捕获多媒体数据时表现出色。本指南将深入探讨DirectShow的开发过程，帮助...
DirectShow Filter 编写是Windows平台上进行多媒体处理和流媒体播放的重要技术。在这个例程中，我们将探讨如何从文件直接读取数据，而非一次性将整个文件加载到内存中，这通常被称为异步读取。这个过程涉及到对...
在本压缩包中，"利用 DirectShow 开发自己的 Filter_源码.rar" 提供了关于如何自定义 DirectShow Filter 的源代码，这对于理解 DirectShow 工作原理以及进行多媒体应用程序开发非常有帮助。 一个 DirectShow Filter...
在这个“Directshow Transform Filter例子”中，我们将探讨如何创建一个自定义的Transform Filter，该Filter的主要功能是将输入的彩色图像数据转换为灰度图像。 Transform Filter在DirectShow中扮演着重要的角色，...
Directshow的Filter开发简要步骤-C++技术文章-C++-程序设计-技术资料
### DirectShow SDK 开发知识点详解 #### 一、DirectShow概览 DirectShow是微软推出的一款强大且灵活的媒体框架，旨在为Windows平台上的多媒体应用提供流媒体处理能力。它是DirectX开发包的一部分，主要专注于视频...
DirectShow Filter工具是一种用于开发和调试DirectShow过滤器的强大资源，它为用户提供了全面的DirectShow滤镜集合，以及一个方便的查看工具，以便更好地理解和管理这些滤镜。DirectShow是微软开发的一个多媒体处理...
DsDemo是一些演示代码，FilterTitleOverlay是字符叠加Filter的源代码。 Chapter05：第5章用到的代码，其中GraphBuilding为Filter Graph构建技术 的一些代码，SimplePlayer为一个简单的播放器例子。 Chapter07：第7章...
### DirectShow Filter的开发实践 #### 一、引言与背景 随着计算机视觉技术的不断发展，摄像头图像采集处理成为了一个重要的研究领域。DirectShow作为一项成熟的技术，为开发者提供了强大的工具来实现高效的图像...
对于Filter开发人员来说，掌握DirectShow Filter的相关知识至关重要，因为这将直接影响到多媒体应用程序的性能和兼容性。 DirectShow Filter可以被看作是一个个处理单元，它们按照特定的拓扑结构（Filter Graph）...
Directshow是一种由微软开发的多媒体框架，用于处理视频和音频流。它提供了低级的访问权限，使得开发者能够创建复杂的媒体处理应用程序，如播放器、捕获设备、视频编辑工具等。本技术资料深入浅出地讲解了Directshow...
本示例主要展示了如何使用DirectShow在VC++下开发USB摄像头应用，实现摄像头图像的实时显示。 首先，理解DirectShow：DirectShow是Microsoft为Windows平台提供的一种基于组件的对象模型，它允许开发者构建高质量的...
编辑等应用，深入分析了DirectShow SDK提供的部分典型源代码例子，结合作者个人的一些开发实践，通过案例和开放源码分析，进一步介绍DirectShow的实务应用。 此为本书的配套源码集，对VC 编程者来说，是比较不错...
第2部分重点讨论了Filter的开发，以及DirectShow应用程序的开发，包括目前非常流行的音视频采集、数码摄像机的支持、非线性编辑等应用。第3部分深入分析了DirectShow SDK提供的部分典型源代码。第4部分结合作者个人...
在字幕叠加的实现中，我们可以通过创建自定义的滤镜（Filter）来完成。首先，你需要了解并实现ISubtitleFilter接口，这个接口允许你插入字幕到视频流中。然后，你需要创建一个字幕渲染器（Subtitle Renderer），它会...
在DirectShow开发指南_部分1中，首先介绍了DirectShow技术的核心组件，包括Filter Graph Manager、Filter、Pin等。Filter Graph Manager是DirectShow架构中的主要部分，负责管理整个媒体流处理的流程。Filter是处理...