ycapture(わいきゃぷちゃ)

とりあえず公開版ですのでドキュメントなどは作り途中です。ご了承ください。

ダウンロード

ycaptureはソースコードによる提供のみとなります。利用用途に応じて書き換え、ビルドしてお使いください。

ライセンス

このライブラリはMIT Licence(日本語訳)に基づき配布をおこなっています。

もし使用してくださる方がおられる場合は、以下の点にご注意ください。

このライブラリはyacchin(谷沢智史)が趣味で作成したものです。著作権はyacchinに帰属するものとします。
ある程度テストはおこなっていますが、趣味の範囲内でおこなっているため、何らかのバグが残ってしまっているおそれがあります。
著作権者は、契約行為、不法行為、またはそれ以外であろうと、ソフトウェアに起因または関連し、あるいはソフトウェアの使用またはその他の扱いによって生じる一切の請求、損害、その他の義務について何らの責任も負わないものとします。
本ソフトウェアおよび関連文書のファイルの複製を取得するすべての人に対し、ソフトウェアを無制限に扱うことを無償で許可します。
ただし、上記免責事項への同意、および著作権表示および本許諾表示を、ソフトウェアのすべての複製または重要な部分へ記載することをお願いいたします。
何かお問い合わせは (メール) yazawa あっと yzwlab.net もしくは (Twitter) @yacchin1205 まで。
作者多忙のため、すぐには回答できない場合がありますのでその点はご了承ください。また、使用してくださる場合などは一言教えていただけるとすごく喜びます。

実装にあたってはStack Overflow、特にThe March Hare's web siteといった情報源に非常に助けられました。より詳しく知りたい場合はこれらのサイトを参考にしてください。

ダウンロード

ycapture-src-0.1.1.zip

変更点(0.1.0→0.1.1)：

Flash Media Live Encoderなどで使用できるようにIAMStreamConfigインタフェースを実装しました。

過去のバージョン：

version 0.1.0
ycapture-src-0.1.0.zip

動作チェック環境

Windows SDK for Windows Server 2008 and .NET Framework 3.5
ycaptureはWindows SDKサンプルのうち、DirectShow BaseClassesを利用します。作業手順に従い、ビルドした上でご利用ください。

作者の環境では、C:\Program Files\Microsoft SDKs\Windows\v6.1\Samples\Multimedia\DirectShow\BaseClasses に配置しています。
Visual Studio 2008 Standard Edition
本コードはC++を利用して記述されています。

使い方

プロジェクト構成

ycapture
キャプチャフィルタDLLです。

このDLLをビルドし、regsvr32コマンドで登録処理をおこなうと、このDLLがWindowsにVideo Capture Sourceとして認識されるようになります。
ycaptureclient
キャプチャフィルタDLLに画像データを供給するための静的ライブラリです。

このライブラリ内のCaptureSenderクラスを使用すると簡単にキャプチャフィルタDLLにデータを供給することができます。
testclient
ycaptureclientライブラリの使用例です。

使用例がコマンドラインアプリケーションとして実装されています。

必要な作業

Windows SDKの用意・BaseClassesのビルド
MicrosoftからWindows SDKをダウンロードし、Samples\Multimedia\DirectShow\BaseClassesをビルドしてください。
フィルタ名、CLSIDなどの変更
ycaptureプロジェクトのycapture.hにフィルタ名、CLSIDなどの定義が記述されています。

#pragma once

// ycapture.h : フィルタの情報定義

// ここは自分の製品に合わせて変更すること

// フィルタ名定義
#define NAME_CAPTURESOURCE L"ARgil Capture Source"

// {5C2CD55C-92AD-4999-8666-912BD3E70001}
DEFINE_GUID(CLSID_CaptureSource,
    0x5c2cd55c, 0x92ad, 0x4999, 0x86, 0x66, 0x91, 0x2b, 0xd3, 0xe7, 0x0, 0x1);

// イベント・メモリマップドファイル名定義
// フィルタ側・送信側で同一の名前を使用すること

// 書き込みを示すイベント名
#define CS_EVENT_WRITE    L"ARgil_CaptureSource_Write"
// データ読み込みを示すミューテックス名
#define CS_EVENT_READ    L"ARgil_CaptureSource_Read"
// 共有データファイル名(メモリマップドファイル)
#define CS_SHARED_PATH    L"ARgil_CaptureSource_Data"

ダウンロード時点での内容はARgil用のものとなっていますので、各定義を書き換えてください。

この内容を書き換えないと、ARgilと競合を起こす場合があります。
ycaptureプロジェクトのビルド
プロジェクトプロパティにWindows SDKのパスを指定し（作者と全く同じパスにWindows SDKをインストールした場合は不要）、ycaptureプロジェクトをビルドします。
ycaptureclientプロジェクトのビルド
ycaptureclientプロジェクトをビルドします。
画像供給処理の実装
ycaptureclientライブラリを使用し、画像供給処理を実装します。

testclientプロジェクトを参考にしてください。
ycapture.dllの登録
regsvr32 (ビルドされたycapture.dllのパス)を実行し、Windowsにycapture.dllを登録してください。

正常に実施できた場合、UstreamやYouTube撮影時のビデオソースとして「(ycapture.hに指定したフィルタ名)」が追加されるようになります。

実行手順

ycapture.dllが提供するVideo Capture Sourceと画像供給処理の実行順序などに特に制限はありません。ycapture.hの定義に従いオブジェクトを生成し、これらを共有して処理を行ないます。

ycapture.dllの上書きなどができない場合は、ブラウザなどがDLLへの参照を保持してしまっている可能性があります。ブラウザの終了などで対処してください。

ycapture(わいきゃぷちゃ) version 0.1.1