cv::gapi::wip::onevpl::CfgParam 结构体参考

公共类用于创建 onevpl::GSource 实例。 更多信息...

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

cv::gapi::wip::onevpl::CfgParam 的协作图

公共类型
using	name_t = std::string
using	value_t = cv::util::variant< uint8_t, int8_t, uint16_t, int16_t, uint32_t, int32_t, uint64_t, int64_t, float_t, double_t, void *, std::string >

公共成员函数
	CfgParam (CfgParam &&src)
	CfgParam (const CfgParam &src)
	~CfgParam ()
const name_t &	get_name () const
const value_t &	get_value () const
bool	is_major () const
bool	operator!= (const CfgParam &rhs) const
bool	operator< (const CfgParam &rhs) const
CfgParam &	operator= (CfgParam &&src)
CfgParam &	operator= (const CfgParam &src)
bool	operator== (const CfgParam &rhs) const
std::string	to_string () const

静态公共成员函数
static constexpr const char *	acceleration_mode_name ()
	acceleration_mode_name
template<typename ValueType >
static CfgParam	create (const std::string &name, ValueType &&value, bool is_major=true)
static CfgParam	create_acceleration_mode (const char *value)
static CfgParam	create_acceleration_mode (uint32_t value)
static CfgParam	create_decoder_id (const char *值)
static CfgParam	create_decoder_id (uint32_t 值)
static CfgParam	create_frames_pool_size (size_t 值)
static CfgParam	create_implementation (const char *值)
static CfgParam	create_implementation (uint32_t 值)
static CfgParam	create_vpp_frames_pool_size (size_t 值)
static CfgParam	create_vpp_in_crop_h (uint16_t 值)
static CfgParam	create_vpp_in_crop_w (uint16_t 值)
static CfgParam	create_vpp_in_crop_x (uint16_t 值)
static CfgParam	create_vpp_in_crop_y (uint16_t 值)
static CfgParam	create_vpp_in_height (uint16_t 值)
static CfgParam	create_vpp_in_width (uint16_t 值)
static CfgParam	create_vpp_out_chroma_format (uint16_t 值)
static CfgParam	create_vpp_out_crop_h (uint16_t 值)
static CfgParam	create_vpp_out_crop_w (uint16_t 值)
static CfgParam	create_vpp_out_crop_x (uint16_t 值)
static CfgParam	create_vpp_out_crop_y (uint16_t 值)
static CfgParam	create_vpp_out_fourcc (uint32_t 值)
static CfgParam	create_vpp_out_framerate_d (uint32_t 值)
static CfgParam	create_vpp_out_framerate_n (uint32_t 值)
static CfgParam	create_vpp_out_height (uint16_t 值)
static CfgParam	create_vpp_out_pic_struct (uint16_t 值)
static CfgParam	create_vpp_out_width (uint16_t 值)
static constexpr const char *	decoder_id_name ()
	decoder_id_name
static constexpr const char *	frames_pool_size_name ()
	frames_pool_size_name
static constexpr const char *	implementation_name ()
static constexpr const char *	vpp_frames_pool_size_name ()
static constexpr const char *	vpp_in_crop_h_name ()
static constexpr const char *	vpp_in_crop_w_name ()
static constexpr const char *	vpp_in_crop_x_name ()
static constexpr const char *	vpp_in_crop_y_name ()
static constexpr const char *	vpp_in_height_name ()
static constexpr const char *	vpp_in_width_name ()
static constexpr const char *	vpp_out_chroma_format_name ()
static constexpr const char *	vpp_out_crop_h_name ()
static constexpr const char *	vpp_out_crop_w_name ()
static constexpr const char *	vpp_out_crop_x_name ()
static constexpr const char *	vpp_out_crop_y_name ()
static constexpr const char *	vpp_out_fourcc_name ()
static constexpr const char *	vpp_out_framerate_d_name ()
static constexpr const char *	vpp_out_framerate_n_name ()
static constexpr const char *	vpp_out_height_name ()
static constexpr const char *	vpp_out_pic_struct_name ()
static constexpr const char *	vpp_out_width_name ()

详细描述

公共类用于创建onevpl::GSource实例。

通过方法CfgParam::get_name()和CfgParam::get_value()可访问的类成员被onevpl::GSource内部逻辑用来创建或查找特定的oneVPL实现（软件/硬件、特定API版本等）。

注意

由于oneVPL可能提供多个满足多个（或单个）CfgParam 标准的实现，因此可以配置preferred参数。这种类型的CfgParams使用is_major = false参数在CfgParam::create方法创建，并且在创建oneVPL特定实现时不会被使用。相反，它们填写一个“评分表”来从可用列表中选择首选实现。那些在大多数可选param标准上都满足的实现在会被选择。如果没有一个可选的CfgParam参数存在，则会应用第一个可用的oneVPL实现。请访问https://spec.oneapi.io/versions/latest/elements/oneVPL/source/API_ref/VPL_disp_api_func.html?highlight=mfxcreateconfig#mfxsetconfigfilterproperty来使用OneVPL配置。在这种情况下，mfxU8 *name代表CfgParam::get_name()，而mfxVariant value是CfgParam::get_value()

成员类型定义文档

name_t

using cv::gapi::wip::onevpl::CfgParam::name_t = std::string

value_t

using cv::gapi::wip::onevpl::CfgParam::value_t = cv::util::variant<uint8_t, int8_t, uint16_t, int16_t, uint32_t, int32_t, uint64_t, int64_t, float_t, double_t, void*, std::string>

构造函数和析构函数文档

CfgParam() [1/2]

cv::gapi::wip::onevpl::CfgParam::CfgParam

(

const CfgParam &

src

)

CfgParam() [2/2]

cv::gapi::wip::onevpl::CfgParam::CfgParam

(

CfgParam &&

src

)

~CfgParam()

cv::gapi::wip::onevpl::CfgParam::~CfgParam

(

)

成员函数文档

acceleration_mode_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::acceleration_mode_name ( )

inlinestaticconstexpr

acceleration_mode_name

为onevp::GSource提供特殊的配置参数名称

注意

acceleration_mode_name可以激活硬件加速和设备内存管理。支持值

• MFX_ACCEL_MODE_VIA_D3D11将激活DX11加速并将在DX11设备内存中分配数据的MediaFrames

如果没有设置，则MFX实现将使用默认的加速行为：所有解码操作使用默认的GPU资源，但是MediaFrame使用主机RAM来分配数据

create()

template<typename ValueType >

static CfgParam cv::gapi::wip::onevpl::CfgParam::create ( const std::string &  name, ValueType &&  value, bool  is_major = true  )

inlinestatic

创建onevp::GSource的通用配置参数。

参数

name	参数的名称。
value	参数的值。
is_major	如果参数必须由OneVPL内建实现提供，则为TRUE；对于可选的（用于解决多个可用实现），则为FALSE。

create_acceleration_mode() [1/2]

static CfgParam cv::gapi::wip::onevpl::CfgParam::create_acceleration_mode ( const char *  value )

static

create_acceleration_mode() [2/2]

static CfgParam cv::gapi::wip::onevpl::CfgParam::create_acceleration_mode ( uint32_t  value )

static

创建解码器ID() [1/2]

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_decoder_id ( const char *  value )

static

创建解码器ID() [2/2]

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_decoder_id ( uint32_t  value )

static

创建帧池大小()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_frames_pool_size ( size_t  value )

static

创建实现() [1/2]

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_implementation ( const char *  value )

static

创建实现() [2/2]

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_implementation ( uint32_t  value )

static

创建VPP帧池大小()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_frames_pool_size ( size_t  value )

static

创建VPP输入裁剪高度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_crop_h ( uint16_t  value )

static

创建VPP输入裁剪宽度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_crop_w ( uint16_t  value )

static

创建VPP输入裁剪X坐标()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_crop_x ( uint16_t  value )

static

创建VPP输入裁剪Y坐标()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_crop_y ( uint16_t  value )

static

创建VPP输入高度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_height ( uint16_t  value )

static

创建VPP输入宽度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_in_width ( uint16_t  value )

static

创建VPP输出色度格式()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_chroma_format ( uint16_t  value )

static

创建VPP输出裁剪高度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_crop_h ( uint16_t  value )

static

创建VPP输出裁剪宽度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_crop_w ( uint16_t  value )

static

创建VPP输出裁剪X坐标()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_crop_x ( uint16_t  value )

static

创建VPP输出裁剪Y坐标()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_crop_y ( uint16_t  value )

static

创建VPP输出fourcc码()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_fourcc ( uint32_t  value )

static

创建VPP输出帧率D()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_framerate_d ( uint32_t  value )

static

创建VPP输出帧率N()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_framerate_n ( uint32_t  value )

static

创建VPP输出高度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_height ( uint16_t  value )

static

创建VPP输出图片结构()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_pic_struct ( uint16_t  value )

static

创建VPP输出宽度()

静态 CfgParam cv::gapi::wip::onevpl::CfgParam::create_vpp_out_width ( uint16_t  value )

static

解码器ID名称()

静态常量时间表达式 const char * cv::gapi::wip::onevpl::CfgParam::decoder_id_name ( )

inlinestaticconstexpr

decoder_id_name

为onevp::GSource提供特殊的配置参数名称

注意

decoder_id_name 允许指定 VPL 解码器类型，这对于原始视频输入数据是必需的，但在视频流封装到容器（*.mp4, *.mkv 等等）时则不允许作为 CfgParam 存在。在这种情况下，onevp::GSource 将自动确定它。支持值

• MFX_CODEC_AVC
• MFX_CODEC_HEVC
• MFX_CODEC_MPEG2
• MFX_CODEC_VC1
• MFX_CODEC_CAPTURE
• MFX_CODEC_VP9
• MFX_CODEC_AV1

frames_pool_size_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::frames_pool_size_name ( )

inlinestaticconstexpr

frames_pool_size_name

onevp::GSource 的特殊配置参数名称

注意

frames_pool_size_name 允许分配适当大小的表面池，以在加速器内存中保留解码帧，以便在 onevp::GSource::pull 操作消耗之前准备好。如果您看到许多关于缺乏可用表面的警告，那么是时候增加 frames_pool_size_name，但要注意加速器可用内存量。如果未设置，则 MFX 实现使用 mfxFrameAllocRequest::NumFrameSuggested 行为

get_name()

const name_t & cv::gapi::wip::onevpl::CfgParam::get_name

(

)

常量

get_value()

const value_t & cv::gapi::wip::onevpl::CfgParam::get_value

(

)

常量

implementation_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::implementation_name ( )

inlinestaticconstexpr

is_major()

bool cv::gapi::wip::onevpl::CfgParam::is_major

(

)

常量

operator!=()

bool cv::gapi::wip::onevpl::CfgParam::operator!=

(

const CfgParam &

rhs

)

常量

operator<

bool cv::gapi::wip::onevpl::CfgParam::operator<

(

const CfgParam &

rhs

)

常量

operator=() [1/2]

CfgParam & cv::gapi::wip::onevpl::CfgParam::operator=

(

CfgParam &&

src

)

operator=() [2/2]

CfgParam & cv::gapi::wip::onevpl::CfgParam::operator=

(

const CfgParam &

src

)

operator==()

bool cv::gapi::wip::onevpl::CfgParam::operator==

(

const CfgParam &

rhs

)

常量

to_string()

std::string cv::gapi::wip::onevpl::CfgParam::to_string

(

)

常量

vpp_frames_pool_size_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_frames_pool_size_name ( )

inlinestaticconstexpr

vpp_in_crop_h_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_crop_h_name ( )

inlinestaticconstexpr

vpp_in_crop_w_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_crop_w_name ( )

inlinestaticconstexpr

vpp_in_crop_x_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_crop_x_name ( )

inlinestaticconstexpr

vpp_in_crop_y_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_crop_y_name ( )

inlinestaticconstexpr

vpp_in_height_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_height_name ( )

inlinestaticconstexpr

vpp_in_width_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_in_width_name ( )

inlinestaticconstexpr

vpp_out_chroma_format_name()

static constexpr const char * cv::gapi::wip::onevpl::CfgParam::vpp_out_chroma_format_name ( )

inlinestaticconstexpr

vpp_out_crop_h_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_crop_h_name ( )

inlinestaticconstexpr

vpp_out_crop_w_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_crop_w_name ( )

inlinestaticconstexpr

vpp_out_crop_x_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_crop_x_name ( )

inlinestaticconstexpr

vpp_out_crop_y_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_crop_y_name ( )

inlinestaticconstexpr

vpp_out_fourcc_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_fourcc_name ( )

inlinestaticconstexpr

vpp_out_framerate_d_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_framerate_d_name ( )

inlinestaticconstexpr

vpp_out_framerate_n_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_framerate_n_name ( )

inlinestaticconstexpr

vpp_out_height_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_height_name ( )

inlinestaticconstexpr

vpp_out_pic_struct_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_pic_struct_name ( )

inlinestaticconstexpr

vpp_out_width_name()

静态常量字符指针 cv::gapi::wip::onevpl::CfgParam::vpp_out_width_name ( )

inlinestaticconstexpr

---

本结构文档由以下文件生成

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