MediaFrame の基盤となるデータへのアクセスを提供する。詳細...

#include <opencv2/gapi/media.hpp>

Collaboration diagram for cv::MediaFrame::View:

公開型
using	Callback = std::function<void()>

using	Ptrs = std::array<void*, MAX_PLANES>

using	Strides = std::array<std::size_t, MAX_PLANES>

公開メンバ関数
	~View ()

公開変数類
Ptrs	ptr
	画像プレーンポインタの配列。

Strides	stride
	画像プレーンのストライド（バイト単位）の配列。

静的公開変数類
static constexpr const size_t	MAX_PLANES = 4

詳細説明

MediaFrame の基盤となるデータへのアクセスを提供する。

このオブジェクトは、関連する MediaFrame のピクセルデータにアクセスするために必要な情報を含む。すなわち、cv::MediaFormat で定義されているとおり、各画像プレーンのポインタの配列とストライド（各プレーン行間の距離、バイト単位）である。MediaFrame には最大4つの画像プレーンが存在しうる。

MediaFrame::access() に渡される MediaFrame::Access フラグに応じて、MediaFrame::View は読み取り専用または書き込み専用になりうる。

親 MediaFrame に関連付けられた MediaFrame::IAdapter の実装に応じて、MediaFrame::Access::R フラグでメモリに書き込んでも効果がない、または未定義動作を引き起こすことがある。MediaFrame::Access::W フラグでメモリを読み取る場合も同様である。この場合も IAdapter の実装に応じて、ビューがアクセスを提供するホスト側バッファには現在のデータが格納されていないことがある（そのため、バッファ内容のその場での編集が不可能なことがある）。

MediaFrame::View オブジェクトは慎重に扱わなければならない。MediaFrame::View オブジェクトが存在する間、MediaFrame に関連付けられた外部リソースがロックされることがあるためである。MediaFrame::View の取得は「map/unmap」イディオム（OpenCL、デバイスメモリ、リモートメモリに適用される）における「map」とみなすべきであり、その破棄は「unmap」とみなすべきである。

MediaFrame バッファが書き込みのためにアクセスされ、MediaFrame::View::Ptrs 配下のメモリが変更された場合、ホスト側とデバイス/リモートバッファのデータ同期は、MediaFrame::View が破棄されるまで保証されない。言い換えれば、デバイス上やリモートターゲット上の実データは MediaFrame::View の破棄時にのみ更新されることがある。ただし、これは関連する MediaFrame::IAdapter の実装に依存する。

型定義メンバ詳解

◆ Callback

using cv::MediaFrame::View::Callback = std::function<void()>

◆ Ptrs

using cv::MediaFrame::View::Ptrs = std::array<void*, MAX_PLANES>

◆ Strides

using cv::MediaFrame::View::Strides = std::array<std::size_t, MAX_PLANES>

構築子と解体子の詳解

◆ ~View()

cv::MediaFrame::View::~View ( )

メンバ変数詳解

◆ MAX_PLANES

const size_t cv::MediaFrame::View::MAX_PLANES = 4

staticconstexpr

◆ ptr

Ptrs cv::MediaFrame::View::ptr

画像プレーンポインタの配列。

◆ stride

Strides cv::MediaFrame::View::stride

画像プレーンのストライド（バイト単位）の配列。

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

opencv2/gapi/media.hpp

公開型

公開メンバ関数

公開変数類

静的公開変数類