cv::gapi::wip::onevpl::IDataProvider 構造体

公開インターフェースにより、（デフォルトの）ファイルからのストリーム読み込みの代わりに、onevpl::GSource が使用するビデオストリームデータの抽出をカスタマイズできる。 続きを読む...

#include <opencv2/gapi/streaming/onevpl/data_provider_interface.hpp>

Collaboration diagram for cv::gapi::wip::onevpl::IDataProvider:

公開型
using	mfx_codec_id_type = uint32_t
using	Ptr = std::shared_ptr<IDataProvider>

公開メンバ関数
virtual	~IDataProvider ()=default
virtual bool	empty () const =0
virtual bool	fetch_bitstream_data (std::shared_ptr< mfx_bitstream > &in_out_bitsream)=0
virtual mfx_codec_id_type	get_mfx_codec_id () const =0

詳細説明

公開インターフェースにより、（デフォルトの）ファイルからのストリーム読み込みの代わりに、onevpl::GSource が使用するビデオストリームデータの抽出をカスタマイズできる。

インターフェース実装のコンストラクタは整合性を保証し、完全に動作可能なオブジェクトを生成しなければならない。エラーが発生した場合、実装は DataProviderException 種別の例外をスローしなければならない

覚え書き

インターフェース実装は、あらゆる種類のリークを避けるため、ストリームおよびその他に構築されたリソースを自身で管理しなければならない。簡単なインターフェース実装例については、tests/streaming/gapi_streaming_tests.cpp の StreamDataProvider を参照。

型定義メンバ詳解

mfx_codec_id_type

using cv::gapi::wip::onevpl::IDataProvider::mfx_codec_id_type = uint32_t

Ptr

using cv::gapi::wip::onevpl::IDataProvider::Ptr = std::shared_ptr<IDataProvider>

構築子と解体子の詳解

~IDataProvider()

virtual cv::gapi::wip::onevpl::IDataProvider::~IDataProvider ( )

virtualdefault

メンバ関数詳解

empty()

virtual bool cv::gapi::wip::onevpl::IDataProvider::empty ( ) const

pure virtual

この関数は、より多くのバイナリデータが利用可能かどうかを確認するために onevpl::GSource によって使用される。

EOFの場合はTRUEを返さなければならず、例外をスローしてはならない。

戻り値

ストリームの終端を検出するブール値

fetch_bitstream_data()

virtual bool cv::gapi::wip::onevpl::IDataProvider::fetch_bitstream_data ( std::shared_ptr< mfx_bitstream > & in_out_bitsream )

pure virtual

この関数は、IDataProvider 実装からバイナリデータストリームを抽出するために onevpl::GSource によって使用される。

失敗時には DataProviderException 種別の例外をスローしなければならない。失敗とは見なされないEOFの場合はMFX_ERR_MORE_DATAを返さなければならない。

引数

in_out_bitsream

MFXビットストリームバッファ上の入出力参照。最初のリクエスト時には空でなければならず、実装側がバッファを自前で確保して返すことを可能にする。fetch_bitstream_data を後続で呼び出す際には、まだ消費されていない残りのフレームをスキップしないよう、直前に使用した in_out_bitsream を使用しなければならない

戻り値

データを取得できた場合はtrue、EOFの場合はfalseを返し、エラー時には例外をスローする

get_mfx_codec_id()

virtual mfx_codec_id_type cv::gapi::wip::onevpl::IDataProvider::get_mfx_codec_id ( ) const

pure virtual

この関数は、データからコーデックIDを抽出するために onevpl::GSource によって使用される

---

この構造体詳解は次のファイルから抽出されました:

• opencv2/gapi/streaming/onevpl/data_provider_interface.hpp