cv::MediaFrame クラス

cv::MediaFrame クラスは、外部ソースから取得した画像/メディアフレームを表す。 詳細...

#include <opencv2/gapi/media.hpp>

Collaboration diagram for cv::MediaFrame:

クラス
class	IAdapter
	MediaFrame データアダプタ用のインターフェースクラス。 詳細...
class	View
	MediaFrame の基盤データへのアクセスを提供する。 詳細...

公開型
enum class	Access {   R ,   W }
using	AdapterPtr = std::unique_ptr<IAdapter>

公開メンバ関数
	MediaFrame ()
	空の MediaFrame を構築する。
	MediaFrame (AdapterPtr &&p)
	指定されたAdapterを用いて MediaFrame を構築する。MediaFrame は渡されたアダプタの所有権を取得する。
View	access (Access mode) const
	指定されたモードで基盤データへのアクセスを取得する。
cv::GFrameDesc	desc () const
	メディアフレーム記述子（メディアフォーマット、寸法などの情報）を返す。
template<typename T >
T *	get () const
	関連付けられた MediaFrame アダプタを特定のアダプタ型 T にキャストして返す。型が異なる場合はnullptrを返す。
void	serialize (cv::gapi::s11n::IOStream &os) const
	MediaFrame のデータをバイト配列にシリアライズする。

静的公開メンバ関数
template<class T , class... Args>
static cv::MediaFrame	Create (Args &&... args)
	Adapter用の指定された引数を用いて MediaFrame を構築する。型 T のアダプタはその場で構築される。

詳細説明

cv::MediaFrame クラスは、外部ソースから取得した画像/メディアフレームを表す。

cv::MediaFrame は cv::MediaFormat で指定された画像データを表す。cv::MediaFrame は何らかの外部メモリやバッファに対する薄いラッパーとなるよう設計されており、クラス自体がそのようなメモリ型に対して統一されたインターフェースを提供する。cv::MediaFrame はカメラドライバやメディアコーデックからのデータをラップし、このメモリに対する抽象化レイヤをG-APIに提供する。MediaFrame は基盤データにアクセスし管理するためのコンパクトなインターフェースを定義しており、実装は関連するAdapter（通常はユーザ定義）によって完全に定義される。

参照

cv::RMat

型定義メンバ詳解

AdapterPtr

using cv::MediaFrame::AdapterPtr = std::unique_ptr<IAdapter>

列挙型メンバ詳解

Access

enum class cv::MediaFrame::Access

strong

このenumは、基盤データへのアクセスを提供する cv::MediaFrame のさまざまな型を定義する。なお、このバージョンでは異なるフラグを組み合わせることはできない。

列挙値
R	読み取り用にデータへアクセスする。
W	書き込み用にデータへアクセスする。

構築子と解体子の詳解

MediaFrame() [1/2]

cv::MediaFrame::MediaFrame

(

)

空の MediaFrame を構築する。

構築されたオブジェクトには、関連付けられたデータが存在しない。

MediaFrame() [2/2]

cv::MediaFrame::MediaFrame ( AdapterPtr && p )

explicit

指定されたAdapterを用いて MediaFrame を構築する。MediaFrame は渡されたアダプタの所有権を取得する。

引数

p	IAdapter 派生クラスのインスタンスへのユニークポインタ。

メンバ関数詳解

access()

View cv::MediaFrame::access

(

Access

mode

)

const

指定されたモードで基盤データへのアクセスを取得する。

関連するAdapterおよびラップされたデータによっては、このメソッドは低コストの場合（例えば基盤メモリがローカルである場合）もあれば、高コストの場合（基盤メモリが外部メモリまたはデバイスメモリである場合）もある。

引数

mode	アクセスモードフラグ

戻り値

MediaFrame::View オブジェクト。ビューは慎重に扱う必要がある。詳細は MediaFrame::View のドキュメントを参照のこと。

desc()

cv::GFrameDesc cv::MediaFrame::desc

(

)

const

メディアフレーム記述子（メディアフォーマット、寸法などの情報）を返す。

戻り値

a cv::GFrameDesc

get()

template<typename T >

T * cv::MediaFrame::get ( ) const

inline

関連付けられた MediaFrame アダプタを特定のアダプタ型 T にキャストして返す。型が異なる場合はnullptrを返す。

このメソッドは、呼び出し側がアダプタ型を把握しており、メモリへのより低レベルなアクセスが必要な場合に有用である。メモリ型によっては、access() よりも効率的な場合がある。

戻り値

アダプタオブジェクトへのポインタ。アダプタ型が異なる場合はnullptr。

serialize()

void cv::MediaFrame::serialize

(

cv::gapi::s11n::IOStream &

os

)

const

MediaFrame のデータをバイト配列にシリアライズする。

覚え書き

実際のロジックはフレームのアダプタクラスによって実装される。デフォルトでは何も行わない。

引数

os	シリアライズされた MediaFrame データを格納するバイトストリーム。

---

このクラス詳解は次のファイルから抽出されました:

• opencv2/gapi/media.hpp