DirectShow下的視訊顯示窗體

用Google搜尋更多資訊

顯示視訊

DirectShow 提供了如下過濾器來顯示視訊：

l         Video Renderer 過濾器. 該過濾器可用于所有的支援DirectX的平台，它對平台沒有其它特殊的要求。可以是它，或GDI來顯示視訊。它是在WindowsXP之前作業系統的預設視訊顯示過濾器。

l         Video Mixing Renderer Filter 7 (VMR-7). VMR-7可用于WindowsXP作業系統，并且是該系統下的預設視訊顯示過濾器。與老的視訊顯示過濾器相比，它具有一些更強大的性能，包括采用插件模式來控制DirectShow顯示。

l         Video Mixing Renderer Filter 9 (VMR-9). VMR-9是一個更新的視訊混合顯示過濾器，它采用了Direct3D來顯示。它可用于所有的支援DirectX的平台。它不是預設的顯示過濾器，因為它與其它的顯示過濾器相比，對系統要求更高。

一般來說，在視訊顯示應用上，VMR-9是首選。因為，它使用了最新的圖像API，并且提供了最好的性能。

窗體模式和非窗體模式

DirectShow視訊顯示可以選擇在窗體模式或者非窗體模式下進行。

l         在窗體模式下，視訊将建立一個它自己的窗體來顯示。

l         在非窗體模式下，視訊可以自己在你程式的一個視窗上顯示，而不讓視訊自己區建立窗體來顯示。

 Video Renderer過濾器隻支援窗體模式，VMR-7和VMR-9支援這兩種模式。它們預設狀态是窗體模式。

設定視訊視窗

   在窗體模式下，視訊将建立一個視窗，然後在該視窗上顯示視訊。大多數情況下，你可能想要把該視窗綁定到你的應用程式中。通過使用IVideoWindow接口，可以設定視訊視窗的類型和位置。

       在開始播放前，在過濾器圖表管理器中去查找IVideoWindow接口：

IVideoWindow *pVidWin = NULL;

pGraph->QueryInterface(IID_IVideoWindow, (void **)&g_pVidWin);

調用IVideoWindow::put_Owner方法去處理你應用程式的窗體。該方法提供了一個OAHWND類型的變量，是以要把句柄轉換為該類型：

pVidWin->put_Owner((OAHWND)hwnd);

調用IVideoWindow::Put_WindowStyle來改變視訊窗體的類型：

pVidWin->put_WindowStyle(WS_CHILD | WS_CLIPSIBLINGS);

WS_CHILD标志設定視訊窗體為一個子窗體，WS_CLIPSIBLINGS标志可以防止視訊窗體在另一個子窗體的客戶區内顯示視訊。

調用IVideoWindow::SetWindowPosition方法可以視訊視窗的相對于你應用程式的客戶區的位置。該方法的參數帶了一個RECT參數，用它去指定視訊視窗的位置。下例，讓視訊視窗和它父窗體的客戶區想比對。

RECT grc;

GetClientRect(hwnd, &grc);

pVidWin->SetWindowPosition(0, 0, grc.right, grc.bottom);

通過在過濾器圖表管理器上調用IBaseicVideo::GetVideoSize方法可以得到視訊本身的尺寸大小。你可以通過這些資訊讓視訊保持正确的縱橫比例。

在應用程式退出前，停止圖表并重置視訊視窗為NULL。否則，視窗消息可能被錯誤的發送給錯誤的視窗，進而導緻錯誤發生，

pControl->Stop();

pVidWin->put_Visible(OAFALSE);

pVidWin->put_Owner(NULL); 

使用非窗體模式

視訊混合顯示過濾器（VMR-7和 VMR-9）都支援非窗體模式。這裡将描述窗體模式和非窗體模式之間的不同，以及如何使用非模式窗體。

       為了向後相容已經在使用的應用程式，VMR預設的顯示模式為窗體模式。在窗體模式中，視訊建立一個它自己的窗體去顯示視訊。應用程式設定這個視訊窗體為它的一個子窗體。這個單獨存在的窗體會導緻如下問題：

l         最嚴重的是，如果窗體的消息線上程間發送可能導緻消息死鎖。

l         過濾器圖表管理器必須傳遞某些window消息，比如WM_PAINT，給視訊顯示器(Video Renderer)。這些對IvideoWIndow的操作必須是由過濾器圖表管理器來完成，而不是視訊顯示器來完成，是以要靠過濾器圖表管理器來糾正内部狀态。

l         要視訊窗體的滑鼠或者鍵盤事件，應用程式必須建立一個“消息通道”，讓視訊視窗把消息傳遞給應用程式。

l         為了防止剪接的情況，視訊窗體還必須擁有正确的視窗狀态。

非窗體模式通過使用VMR直接在應用程式的客戶區上畫圖來避免了上述的問題。它使用DirectDraw去剪接視訊矩形。非窗體模式極大程度減少了死鎖的偶然發生。同樣，應用程式不必去設定視訊自身建立的視窗和視窗的狀态。事實上，當VRM使用窗體模式時，它也不使用IVideoWindow接口。

       要使用非窗體模式，你必須明确地去配置VMR。你會發現配置工作非常靈活并且比窗體模式更容易。

在配置VMR 前應建立過濾器圖表(Filter graph):

1. 建立過濾器圖表管理器（Filter Graph Manager）。
2. 建立VMR并添加到過濾器圖表中（filter graph）。
3. 在VMR中調用IVMRFilterConfig::SetRenderingMode 設定VMRMode_Windowless 辨別。
4. 在VMR中調用 IVMRWindowlessControl::SetVideoClippingWindow 去指定視訊将要顯示的窗體句柄。

現在調用IGraphBuilder::RenderFile完成過濾器圖表餘下的工作。過濾器圖表管理器将自動使用這個你添加到過濾器圖表中的VMR執行個體。

下面代碼顯示了這些工作：

HRESULT InitWindowlessVMR(

    HWND hwndApp,                // 視訊窗體

    IGraphBuilder* pGraph,           // 過濾器圖表指針

    IVMRWindowlessControl** ppWc,  // 接收VMR指針

    )

{

    if (!pGraph || !ppWc) return E_POINTER;

    IBaseFilter* pVmr = NULL;

    IVMRWindowlessControl* pWc = NULL;

    // 建立VMR

    HRESULT hr = CoCreateInstance(CLSID_VideoMixingRenderer, NULL,

        CLSCTX_INPROC, IID_IBaseFilter, (void**)&pVmr);

    if (FAILED(hr))

    {

        return hr;

    }

    // 把VMR添加到過濾器圖表中

    hr = pGraph->AddFilter(pVmr, L"Video Mixing Renderer");

    if (FAILED(hr))

    {

        pVmr->Release();

        return hr;

    }

    // 設定顯示模式

    IVMRFilterConfig* pConfig;

    hr = pVmr->QueryInterface(IID_IVMRFilterConfig, (void**)&pConfig);

    if (SUCCEEDED(hr))

    {

        hr = pConfig->SetRenderingMode(VMRMode_Windowless);

        pConfig->Release();

    }

    if (SUCCEEDED(hr))

    {

        // 設定窗體

        hr = pVmr->QueryInterface(IID_IVMRWindowlessControl, (void**)&pWc);

        if( SUCCEEDED(hr))

        {

            hr = pWc->SetVideoClippingWindow(hwndApp);

            if (SUCCEEDED(hr))

            {

                *ppWc = pWc; //傳回AddRef指針

            }

            else

            {

                pWc->Release();

            }

        }

    }

    pVmr->Release();

    return hr;

}

該函數假設正在顯示一個視訊流并沒有混合的靜态位圖。你将看到按如下調用該函數：

IVMRWindowlessControl *pWc = NULL;

hr = InitWindowlessVMR(hwnd, pGraph, &g_pWc);

if (SUCCEEDED(hr))

{

    // 建立圖表

    pGraph->RenderFile(wszMyFileName, 0);

    //完成後釋放VMR接口

    pWc->Release();

}

視訊定位

       配置完VMR後，下一個步驟就是去設定視訊顯示的位置。有兩個矩形位置要考慮，一個是Source矩形位置，一個是desitnation矩形位置。Source定義視訊顯示的位置。Destination指定包含視訊的窗體的客戶區的位置。VMR從source把圖像按destination的尺寸比對後顯示出來。

       調用IVMRWindowlessControl::SetVideoPosition去指定這個兩個矩形位置。Source矩形的大小必須等于或小于視訊本身的尺寸大小；你可以使用IVMRWindowlessControl::GetNativeVideoSize去獲得視訊本身的尺寸。

下面的執行個體，将設定Source等于視訊尺寸1/4（左上角的位置相等），并設定destination矩形等于窗體客戶區的大小1/（左上角的位置相等）：

// 獲得視訊自身尺寸大小

long lWidth, lHeight;

HRESULT hr = g_pWc->GetNativeVideoSize(&lWidth, &lHeight, NULL, NULL);

if (SUCCEEDED(hr))

{

    RECT rcSrc, rcDest;

    // 設定Source尺寸

    SetRect(&rcSrc, 0, 0, lWidth/2, lHeight/2);

    // 獲得顯示窗體的客戶區尺寸

    GetClientRect(hwnd, &rcDest);

    //設定destination尺寸

    SetRect(&rcDest, 0, 0, rcDest.right/2, rcDest.bottom/2);

    // 視訊定位

    hr = g_pWc->SetVideoPosition(&rcSrc, &rcDest);

}

處理窗體消息

       因為VMR沒有自己的窗體，當視訊需要重畫或者尺寸要改變是，你必須要通知窗體來适應。

l           當接收到一個WM_PAINT消息，可調用IVMRWindowlessControl::RepaintVideo 來重畫圖像。

l           當接收到一個WM_DISPLAYCHANGE 消息, 可調用 IVMRWindowlessControl::DisplayModeChanged消息。VMR就可以獲得如下行為比如改變分辨率或者色深。

l           當接收到一個WM_SIZE 消息, 可以重新調用SetVideoPosition 來改變視訊的顯示位置。

下面顯示如何處理WM_PAINT消息。它将在窗體的客戶區重繪，但是不會對視訊顯示的區域進行重繪。不對視訊顯示的區域進行重繪，是因為VMR會對該區域顯示視訊，如果你的程式再對該區域重繪會引起螢幕閃爍。也是應為這個原因，所有不要在你窗體類中去設定背景刷。

void OnPaint(HWND hwnd)

{

    PAINTSTRUCT ps;

    HDC         hdc;

    RECT        rcClient;

    GetClientRect(hwnd, &rcClient);

    hdc = BeginPaint(hwnd, &ps);

    if (g_pWc != NULL)

    {

        // 查找窗體需要重繪的客戶區，該區域應該減去視訊顯示的區域

        // (這裡假設g_rcDest 是已經計算好了的區域)

        HRGN rgnClient = CreateRectRgnIndirect(&rcClient);

        HRGN rgnVideo  = CreateRectRgnIndirect(&g_rcDest); 

        CombineRgn(rgnClient, rgnClient, rgnVideo, RGN_DIFF); 

        // 重繪窗體

        HBRUSH hbr = GetSysColorBrush(COLOR_BTNFACE);

        FillRgn(hdc, rgnClient, hbr);

        // 釋放對象

        DeleteObject(hbr);

        DeleteObject(rgnClient);

        DeleteObject(rgnVideo);

        // 請求VMR to 重繪視訊

        HRESULT hr = g_pWc->RepaintVideo(hwnd, hdc); 

    }

    else  // 沒有視訊顯示，重繪整個客戶區

    {

        FillRect(hdc, &rc2, (HBRUSH)(COLOR_BTNFACE + 1));

    }

    EndPaint(hwnd, &ps);

}