SAMI (CC) 分析器筛选器

分析同步可访问媒体交换 (SAMI) 文件中的标题数据。

SAMI 是类似于 HTML 的文本格式,用于编码基于时间的字幕。 此筛选器将 SAMI 数据转换为文本流。 流中的每个示例都包含一个标题条目,以及格式信息。 样本上的时间戳是从 SAMI 文件中的时间信息生成的。

此筛选器旨在与 内部脚本命令呈现器 筛选器一起使用。 内部脚本命令呈现器以事件通知的形式接收文本示例并将其发送到应用程序。 有关详细信息,请参见“备注”部分。

Label Value
筛选器接口 IAMStreamSelectIBaseFilter
输入固定媒体类型 MEDIATYPE_Stream
输入引脚接口 IPinIQualityControl
输出引脚媒体类型 MEDIATYPE_Text,MEDIASUBTYPE_NULL
输出引脚接口 IMediaSeekingIPinIQualityControl
筛选 CLSID {33FACFE0-A9BE-11D0-A520-00A0D10129C0}
属性页 CLSID 无属性页
可执行文件 quartz.dll
优点 MERIT_UNLIKELY
筛选器类别 CLSID_LegacyAmFilterCategory

 

注解

下面是一个简单的 SAMI 文件:

<SAMI>
<Head>
<STYLE TYPE="text/css"> <!--
    .ENCC {Name: English; lang:en-US; SAMI_TYPE: CC;}
    .FRCC {Name: French; lang:fr-FR; SAMI_TYPE: CC;}
    #NORMAL {Name: Normal; font-family: arial;}
    #GREENTEXT {Name: GreenText; color:green; font-family: verdana;}
-->
</STYLE>
</Head>
<BODY>
<Sync Start=1000>
    <P CLASS="ENCC">One
    <P CLASS="FRCC">Un

<Sync Start=2000>
    <P CLASS="ENCC">Two
    <P CLASS="FRCC">Deux

<Sync Start=3000>
    <P CLASS="ENCC">Three
    <P CLASS="FRCC">Trois
</BODY>
</SAMI>

STYLE 标记定义两种语言设置,即英语 (。ENCC) 和法语 (。FRCC) 。 它还定义了两种样式,#NORMAL和#GREENTEXT。 每个 SYNC 标记定义标题的开始时间(以毫秒为单位)。 P 标记包含标题文本,而 CLASS 属性指定标题应用于的语言设置。

对于每种语言和样式,筛选器都会创建一个逻辑流。 可以随时启用一个语言流和一个样式流。 筛选器生成示例时,它会选择当前语言的标题并应用当前样式。 默认情况下,将启用文件中声明的第一种语言和样式。 应用程序可以使用 IAMStreamSelect::Enable 方法启用其他流。

使用默认设置时,示例文件中的第一个标题将生成以下输出:

<P STYLE=" Name: English; lang:en-US; SAMI_TYPE: CC; Name: Normal; font-family: arial;">One

如果输出转到内部脚本命令呈现器,该筛选器会发送 EC_OLE_EVENT 事件通知。 第二个事件参数是包含标题文本的 BSTR。 应用程序可以检索事件并显示标题。

以下示例演示如何呈现 SAMI 文件、检索流信息、启用流和显示标题文本。 该示例假定以前的 SAMI 文件保存为 C:\Sami_test_file.sami。

为简单起见,此示例在调用 IAMStreamSelect::Enable 方法时使用了硬编码的流索引。 它还执行最小错误检查。

void __cdecl main()
{
    HRESULT hr;
    IGraphBuilder *pGraph;
    IMediaControl *pMediaControl;
    IMediaEventEx *pEv;
    IBaseFilter   *pSAMI;

    CoInitialize(NULL);
    
    // Create the filter graph manager.
    CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC, 
                        IID_IGraphBuilder, (void **)&pGraph);
    pGraph->QueryInterface(IID_IMediaControl, (void **)&pMediaControl);
    pGraph->QueryInterface(IID_IMediaEventEx, (void**)&pEv);

    // Create the graph and find the SAMI parser.
    pGraph->RenderFile(L"C:\\Sami_test_file.sami", NULL);
    hr = pGraph->FindFilterByName(L"SAMI (CC) Parser", &pSAMI);
    if (SUCCEEDED(hr)) 
    {
        IAMStreamSelect *pStrm = NULL;
        hr = pSAMI->QueryInterface(IID_IAMStreamSelect, (void**)&pStrm);
        if (SUCCEEDED(hr)) 
        {
            DWORD dwStreams = 0;
            pStrm->Count(&dwStreams);
            printf("Stream count: %d\n", dwStreams);

            // Select French and "GreenText"
            hr = pStrm->Enable(1, AMSTREAMSELECTENABLE_ENABLE);
            hr = pStrm->Enable(3, AMSTREAMSELECTENABLE_ENABLE);

            // Print the name of each logical stream.
            for (DWORD index = 0; index < dwStreams; index++)
            {
                DWORD dwFlags;
                WCHAR *wszName;
                hr = pStrm->Info(index, NULL, &dwFlags, NULL, NULL,
                    &wszName, NULL, NULL);
                if (hr == S_OK)
                {
                    wprintf(L"Stream %d: %s [%s]\n", index, wszName, 
                        (dwFlags ?  L"ENABLED" : L"DISABLED"));
                    CoTaskMemFree(wszName);
                }
            }
            pStrm->Release();
        }
        pSAMI->Release();
    }

    // Run the graph and display the captions.
    pMediaControl->Run();
    while (1)
    {
        long evCode, lParam1, lParam2;
        pEv->GetEvent(&evCode, &lParam1, &lParam2, 100);
        
        if (evCode == EC_OLE_EVENT) {
            wprintf(L"%s\n", (BSTR)lParam2);
        }
        pEv->FreeEventParams(evCode, lParam1, lParam2);

        if (evCode == EC_USERABORT || evCode == EC_COMPLETE || evCode == EC_ERRORABORT)
            break;
    }

    // Clean up.
    pMediaControl->Release();
    pEv->Release();
    pGraph->Release();
    CoUninitialize();
}

此筛选器使用 IAsyncReader 接口从源筛选器中提取示例。 因此,它不支持其输入引脚上的 IMemInputPin 接口。

DirectShow筛选器