该结构提供了用于填充“OpenVINO Toolkit”模型推理参数的函数。更多...

#include <opencv2/gapi/infer/ov.hpp>

cv::gapi::ov::Params< Net > 的协作图

公开成员函数
	Params (const std::string &blob_path, const std::string &device)

	Params (const std::string &model_path, const std::string &bin_path, const std::string &device)
	类构造函数。

GBackend	backend () const

Params< Net > &	cfgClampOutputs (bool flag=true)
	启用或禁用在 PrePostProcessor 中对模型输出进行裁剪。

Params< Net > &	cfgEnsureNamedTensors (bool flag=true)
	确保模型具有命名张量。

Params< Net > &	cfgInputLayers (const std::vector< std::string > &layer_names)
	指定用于推理的网络输入层名称序列。

Params< Net > &	cfgInputModelLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgInputModelLayout (std::string layout)
	指定输入层的模型布局。

Params< Net > &	cfgInputTensorLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgInputTensorLayout (std::string layout)
	指定输入层的张量布局。

Params< Net > &	cfgMean (detail::AttrMap< std::vector< float > > mean_map)

Params< Net > &	cfgMean (std::vector< float > mean_values)
	指定预处理的均值。

Params< Net > &	cfgNumRequests (const size_t nireq)
	指定异步推理请求的数量。

Params< Net > &	cfgOutputLayers (const std::vector< std::string > &layer_names)
	指定用于推理的网络输出层名称序列。

Params< Net > &	cfgOutputModelLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgOutputModelLayout (std::string layout)
	指定输出层的模型布局。

Params< Net > &	cfgOutputTensorLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgOutputTensorLayout (std::string layout)
	指定输出层的张量布局。

Params< Net > &	cfgOutputTensorPrecision (detail::AttrMap< int > precision_map)

Params< Net > &	cfgOutputTensorPrecision (int precision)
	指定输出层的张量精度。

Params< Net > &	cfgPluginConfig (const detail::ParamDesc::PluginConfigT &config)
	指定 OpenVINO 插件配置。

Params< Net > &	cfgReshape (detail::AttrMap< std::vector< size_t > > new_shape_map)

Params< Net > &	cfgReshape (std::vector< size_t > new_shape)
	指定输入层的新形状。

Params< Net > &	cfgResize (detail::AttrMap< int > interpolation)

Params< Net > &	cfgResize (int interpolation)
	指定 resize 插值算法。

Params< Net > &	cfgScale (detail::AttrMap< std::vector< float > > scale_map)

Params< Net > &	cfgScale (std::vector< float > scale_values)
	指定预处理的缩放值。

cv::util::any	params () const

std::string	tag () const

保护属性
detail::ParamDesc	m_desc

详细说明

template<typename Net>
struct cv::gapi::ov::Params< Net >

该结构提供了用于填充“OpenVINO Toolkit”模型推理参数的函数。

构造函数与析构函数说明

◆ Params() [1/2]

template<typename Net >

cv::gapi::ov::Params< Net >::Params	(	const std::string &	model_path,
		const std::string &	bin_path,
		const std::string &	device )

内联

类构造函数。

根据模型信息构造 Params，并为其他推理描述参数指定默认值。模型使用“OpenVINO Toolkit”加载和编译。

参数

model_path	模型路径。
bin_path	数据文件路径。对于 IR 格式 (.bin)：如果路径为空，将尝试读取与 xml 同名的 bin 文件。如果找不到同名的 bin 文件，将加载没有权重的 IR。对于 PDPD (.pdmodel) 和 ONNX (*.onnx) 格式，bin_path 不会使用。
device	要使用的目标设备。

◆ Params() [2/2]

template<typename Net >

cv::gapi::ov::Params< Net >::Params	(	const std::string &	blob_path,
		const std::string &	device )

内联

这是重载成员函数，为了方便起见提供。它仅在接受的参数方面与上述函数不同。使用此构造函数可处理预编译的网络。模型从预编译的 blob 导入。

参数

blob_path	预编译模型 (*.blob) 的路径。
device	要使用的目标设备。

成员函数说明

◆ backend()

template<typename Net >

GBackend cv::gapi::ov::Params< Net >::backend ( ) const

内联

此函数的调用图

◆ cfgClampOutputs()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgClampOutputs ( bool flag=true )

内联

启用或禁用在 PrePostProcessor 中对模型输出进行裁剪。

默认情况下，输出值会根据输出精度被裁剪到有效范围（由设备或插件处理）。启用此选项将裁剪操作移至 PrePostProcessor 阶段。

注意: 此功能仅在 OpenVINO 2025.2 及更新版本中可用。

参数

标志	如果为 true，则在 PrePostProcessor 中执行裁剪；否则，由设备或插件处理。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgEnsureNamedTensors()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgEnsureNamedTensors ( bool flag=true )

内联

确保模型具有命名张量。

此函数用于确保模型中的所有张量都有名称。它会遍历模型的所有输入和输出节点，并在未设置名称时进行设置。这对于具有无名张量的模型是必需的。

如果张量没有名称，它将被分配一个基于其生产者节点的友好名称的默认名称。如果生产者节点有多个输出，则名称将采用“node_name:N”的形式，其中 N 是输出索引。

参数

标志	如果为 true，则保证所有张量都有名称。

返回: 指向此参数结构的引用。

◆ cfgInputLayers()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgInputLayers ( const std::vector< std::string > & layer_names )

内联

指定用于推理的网络输入层名称序列。

该函数用于将 cv::gapi::infer<> 输入与模型输入关联。名称数量必须与 G_API_NET() 中定义的网络输入数量相匹配。如果网络只有一个输入层，则无需手动指定名称。

参数

layer_names std::array<std::string, N>，其中 N 是 G_API_NET 中定义的输入数量。包含输入层的名称。

返回: 指向此参数结构的引用。

◆ cfgInputModelLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgInputModelLayout ( detail::AttrMap< std::string > layout_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

layout_map 键值对映射：相应输入层的名称及其模型布局（“NCHW”、“NHWC”等）。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgInputModelLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgInputModelLayout ( std::string layout )

内联

指定输入层的模型布局。

该函数用于设置输入层的模型布局。

参数

layout 模型布局（“NCHW”、“NHWC”等）将应用于所有输入层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgInputTensorLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgInputTensorLayout ( detail::AttrMap< std::string > layout_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

layout_map 键值对映射：相应输入层的名称及其张量布局（表示为 std::string，例如“NCHW”、“NHWC”等）。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgInputTensorLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgInputTensorLayout ( std::string layout )

内联

指定输入层的张量布局。

该函数用于设置输入层的张量布局。

参数

layout 张量布局（“NCHW”、“NWHC”等）将应用于所有输入层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgMean() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgMean ( detail::AttrMap< std::vector< float > > mean_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

mean_map 键值对映射：相应输入层的名称及其均值。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgMean() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgMean ( std::vector< float > mean_values )

内联

指定预处理的均值。

该函数用于设置输入层预处理的均值。

参数

mean_values 包含均值的浮点向量。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgNumRequests()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgNumRequests ( const size_t nireq )

内联

指定异步推理请求的数量。

参数

nireq 异步推理请求的数量。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputLayers()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputLayers ( const std::vector< std::string > & layer_names )

内联

指定用于推理的网络输出层名称序列。

该函数用于将 cv::gapi::infer<> 输出与模型输出关联。名称数量必须与 G_API_NET() 中定义的网络输出数量相匹配。如果网络只有一个输出层，则无需手动指定名称。

参数

layer_names std::array<std::string, N>，其中 N 是 G_API_NET 中定义的输出数量。包含输出层的名称。

返回: 指向此参数结构的引用。

◆ cfgOutputModelLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputModelLayout ( detail::AttrMap< std::string > layout_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

layout_map 键值对映射：相应输出层的名称及其模型布局（“NCHW”、“NHWC”等）。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputModelLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputModelLayout ( std::string layout )

内联

指定输出层的模型布局。

该函数用于设置输出层的模型布局。

参数

layout 模型布局（“NCHW”、“NHWC”等）将应用于所有输出层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputTensorLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputTensorLayout ( detail::AttrMap< std::string > layout_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

layout_map 键值对映射：相应输出层的名称及其张量布局（表示为 std::string，例如“NCHW”、“NHWC”等）。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputTensorLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputTensorLayout ( std::string layout )

内联

指定输出层的张量布局。

该函数用于设置输出层的张量布局。

参数

layout 张量布局（“NCHW”、“NWHC”等）将应用于所有输出层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputTensorPrecision() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputTensorPrecision ( detail::AttrMap< int > precision_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

precision_map 键值对映射：相应输出层的名称及其在 OpenCV 格式下的精度（CV_8U、CV_32F 等）。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgOutputTensorPrecision() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgOutputTensorPrecision ( int precision )

内联

指定输出层的张量精度。

该函数用于设置输出层的张量精度。

参数

precision 以 OpenCV 格式（CV_8U、CV_32F 等）表示的精度将应用于所有输出层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgPluginConfig()

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgPluginConfig ( const detail::ParamDesc::PluginConfigT & config )

内联

指定 OpenVINO 插件配置。

该函数用于设置 OpenVINO 插件的配置。某些参数可能因插件而异。请参阅 https://docs.openvinotoolkit.org/latest/index.html 以了解特定插件的信息。

参数

config 键值对映射：（配置参数名称，配置参数值）。

返回: 指向此参数结构的引用。

◆ cfgReshape() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgReshape ( detail::AttrMap< std::vector< size_t > > new_shape_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

new_shape_map 键值对映射：相应输出层的名称及其新形状。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgReshape() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgReshape ( std::vector< size_t > new_shape )

内联

指定输入层的新形状。

该函数用于设置输入层的新形状。

参数

new_shape 新形状将应用于所有输入层。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgResize() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgResize ( detail::AttrMap< int > interpolation )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

interpolation 键值对映射：相应输入层的名称及其 resize 算法。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgResize() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgResize ( int interpolation )

内联

指定 resize 插值算法。

该函数用于配置输入层的 resize 预处理。

参数

interpolation Resize 插值算法。支持的算法：INTER_NEAREST、INTER_LINEAR、INTER_CUBIC。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgScale() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgScale ( detail::AttrMap< std::vector< float > > scale_map )

内联

这是一个重载的成员函数，为方便起见而提供。它与上述函数的区别仅在于所接受的参数不同。

参数

scale_map 键值对映射：相应输入层的名称及其均值。

返回: 指向此参数结构的引用。

此函数的调用图

◆ cfgScale() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ov::Params< Net >::cfgScale ( std::vector< float > scale_values )

内联

指定预处理的缩放值。

该函数用于设置输入层预处理的缩放值。

参数

scale_values 包含缩放值的浮点向量。

返回: 指向此参数结构的引用。

此函数的调用图

◆ params()

template<typename Net >

cv::util::any cv::gapi::ov::Params< Net >::params ( ) const

内联

◆ tag()

template<typename Net >

std::string cv::gapi::ov::Params< Net >::tag ( ) const

内联

成员数据文档

◆ m_desc

template<typename Net >

detail::ParamDesc cv::gapi::ov::Params< Net >::m_desc

保护

此结构体的文档是从以下文件生成的

opencv2/gapi/infer/ov.hpp

公开成员函数

保护属性

详细说明

构造函数与析构函数说明

◆ Params() [1/2]

◆ Params() [2/2]

成员函数说明

◆ backend()

◆ cfgClampOutputs()

◆ cfgEnsureNamedTensors()

◆ cfgInputLayers()

◆ cfgInputModelLayout() [1/2]

◆ cfgInputModelLayout() [2/2]

◆ cfgInputTensorLayout() [1/2]

◆ cfgInputTensorLayout() [2/2]

◆ cfgMean() [1/2]

◆ cfgMean() [2/2]

◆ cfgNumRequests()

◆ cfgOutputLayers()

◆ cfgOutputModelLayout() [1/2]

◆ cfgOutputModelLayout() [2/2]

◆ cfgOutputTensorLayout() [1/2]

◆ cfgOutputTensorLayout() [2/2]

◆ cfgOutputTensorPrecision() [1/2]

◆ cfgOutputTensorPrecision() [2/2]

◆ cfgPluginConfig()

◆ cfgReshape() [1/2]

◆ cfgReshape() [2/2]

◆ cfgResize() [1/2]

◆ cfgResize() [2/2]

◆ cfgScale() [1/2]

◆ cfgScale() [2/2]

◆ params()

◆ tag()

成员数据文档

◆ m_desc