Struct opencv::gapi::GFrame

pub struct GFrame { /* private fields */ }

\addtogroup gapi_data_objects /

GFrame class represents an image or media frame in the graph.

GFrame doesn’t store any data itself, instead it describes a functional relationship between operations consuming and producing GFrame objects.

GFrame is introduced to handle various media formats (e.g., NV12 or I420) under the same type. Various image formats may differ in the number of planes (e.g. two for NV12, three for I420) and the pixel layout inside. GFrame type allows to handle these media formats in the graph uniformly – the graph structure will not change if the media format changes, e.g. a different camera or decoder is used with the same graph. G-API provides a number of operations which operate directly on GFrame, like infer<>() or renderFrame(); these operations are expected to handle different media formats inside. There is also a number of accessor operations like BGR(), Y(), UV() – these operations provide access to frame’s data in the familiar cv::GMat form, which can be used with the majority of the existing G-API operations. These accessor functions may perform color space conversion on the fly if the image format of the GFrame they are applied to differs from the operation’s semantic (e.g. the BGR() accessor is called on an NV12 image frame).

GFrame is a virtual counterpart of cv::MediaFrame.

See also

cv::MediaFrame, cv::GFrameDesc, BGR(), Y(), UV(), infer<>().

Implementations

impl GFrame

pub fn default() -> Result<GFrame>

Constructs an empty GFrame

Normally, empty G-API data objects denote a starting point of the graph. When an empty GFrame is assigned to a result of some operation, it obtains a functional link to this operation (and is not empty anymore).

Trait Implementations

impl Boxed for GFrame

unsafe fn from_raw(ptr: <GFrame as OpenCVFromExtern>::ExternReceive) -> Self

Wrap the specified raw pointer

fn into_raw(self) -> <GFrame as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> <GFrame as OpenCVTypeExternContainer>::ExternSend

Return the underlying raw pointer.

fn as_raw_mut(&mut self) -> <GFrame as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying mutable raw pointer

impl Clone for GFrame

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GFrame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for GFrame

fn drop(&mut self)

Executes the destructor for this type.

impl GFrameTrait for GFrame

fn as_raw_mut_GFrame(&mut self) -> *mut c_void

impl GFrameTraitConst for GFrame

fn as_raw_GFrame(&self) -> *const c_void

impl Send for GFrame