矩阵的基本操作

详细说明

枚举
enum	cv::cann::InterpolationFlags {   cv::cann::INTER_NEAREST = 0 ,   cv::cann::INTER_LINEAR = 1 ,   cv::cann::INTER_CUBIC = 2 ,   cv::cann::INTER_AREA = 3 ,   cv::cann::INTER_MAX = 7 }
	插值算法 更多...

函数
void	cv::cann::copyMakeBorder (const AscendMat &src, AscendMat &dst, int top, int bottom, int left, int right, int borderType, const Scalar &value=Scalar())
void	cv::cann::copyMakeBorder (const InputArray src, OutputArray dst, int top, int bottom, int left, int right, int borderType, const Scalar &value=Scalar())
	在输入图像的副本周围形成并填充指定的边框类型。
AscendMat	cv::cann::crop (const AscendMat &src, const Rect &rect, AscendStream &stream=AscendStream::Null())
AscendMat	cv::cann::crop (InputArray src, const Rect &rect, AscendStream &stream=AscendStream::Null())
	裁剪一个二维数组。该函数通过给定的 cv::Rect 裁剪矩阵。输出矩阵必须与输入矩阵具有相同的深度，大小由给定矩形大小指定。
void	cv::cann::cropResize (const AscendMat &src, AscendMat &dst, const Rect &rect, Size dsize, double fx, double fy, int interpolation)
void	cv::cann::cropResize (const InputArray src, OutputArray dst, const Rect &rect, Size dsize, double fx, double fy, int interpolation)
	从大图像中裁剪子图像，并将其调整到特定大小。
void	cv::cann::cropResizeMakeBorder (const AscendMat &src, AscendMat &dst, const Rect &rect, Size dsize, double fx, double fy, int interpolation, int top, int left, const int borderType, Scalar value=Scalar())
void	cv::cann::cropResizeMakeBorder (const InputArray src, OutputArray dst, const Rect &rect, Size dsize, double fx, double fy, int interpolation, int top, int left, const int borderType, Scalar value=Scalar())
	从大图像中裁剪出小图像，将其调整到指定大小，并在顶部/左侧生成边界并填充指定边界类型。
void	cv::cann::flip (const AscendMat &src, AscendMat &dst, int flipCode, AscendStream &stream=AscendStream::Null())
void	cv::cann::flip (InputArray src, OutputArray dst, int flipCode, AscendStream &stream=AscendStream::Null())
	围绕垂直、水平或两者同时翻转2D矩阵。
void	cv::cann::merge (const AscendMat *src, size_t n, AscendMat &dst, AscendStream &stream=AscendStream::Null())
	从多个单通道矩阵中创建一个多通道矩阵。
void	cv::cann::merge (const AscendMat *src, size_t n, OutputArray &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::merge (const std::vector< AscendMat > &src, AscendMat &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::merge (const std::vector< AscendMat > &src, OutputArray &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::resize (const AscendMat &src, AscendMat &dst, Size dsize, double fx, double fy, int interpolation, AscendStream &stream=AscendStream::Null())
void	cv::cann::resize (InputArray src, OutputArray dst, Size dsize, double fx, double fy, int interpolation, AscendStream &stream=AscendStream::Null())
	将图像src调整到指定大小或更小。
void	cv::cann::rotate (const AscendMat &src, AscendMat &dst, int rotateMode, AscendStream &stream=AscendStream::Null())
void	cv::cann::rotate (InputArray src, OutputArray dst, int rotateCode, AscendStream &stream=AscendStream::Null())
	以90度为增量旋转2D数组。函数cv::rotate 可以以三种不同的方式旋转数组：顺时针旋转90度（rotateCode = ROTATE_90_CLOCKWISE）。顺时针旋转180度（rotateCode = ROTATE_180）。顺时针旋转270度（rotateCode = ROTATE_90_COUNTERCLOCKWISE）。
void	cv::cann::split (const AscendMat &src, AscendMat *dst, AscendStream &stream=AscendStream::Null())
	将多通道矩阵的每个平面复制到一个数组中。
void	cv::cann::split (const AscendMat &src, std::vector< AscendMat > &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::split (const InputArray src, AscendMat *dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::split (const InputArray src, std::vector< AscendMat > &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::transpose (const AscendMat &src, AscendMat &dst, AscendStream &stream=AscendStream::Null())
void	cv::cann::transpose (InputArray src, OutputArray dst, AscendStream &stream=AscendStream::Null())
	转置矩阵。

枚举类型文档

InterpolationFlags

enum cv::cann::InterpolationFlags

#include <

插值算法

枚举值
INTER_NEAREST	最近邻插值
INTER_LINEAR	双线性插值
INTER_CUBIC	双三次插值
INTER_AREA	使用像素面积关系进行重采样。它可能是图像插值的优选方法，因为它可以提供无莫尔的图像。但是当图像被缩放时，它与INTER_NEAREST方法相似。
INTER_MAX	插值代码掩码

函数文档

copyMakeBorder() [1/2]

void cv::cann::copyMakeBorder	(	const AscendMat &	src,
		AscendMat &	dst,
		int	top,
		int	bottom,
		int	left,
		int	right,
		int	borderType,
		const Scalar &	value = ]
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

copyMakeBorder() [2/2]

void cv::cann::copyMakeBorder	(	const InputArray	src,
		OutputArray	dst,
		int	top,
		int	bottom,
		int	left,
		int	right,
		int	borderType,
		const Scalar &	value = ]
	)

#include <

在输入图像的副本周围形成并填充指定的边框类型。

参数

src	源图像。
dst	与src类型相同的目标图像，具体大小为 Size(src.cols+left+right, src.rows+top+bottom)。
top	顶部填充像素数
bottom	底部填充像素数
left	左侧填充像素数
right	右侧填充像素数指定从源图像矩形向外部扩展的像素数。例如，top=1, bottom=1, left=1, right=1 表示需要构建 1 像素宽的边界。
borderType	边界类型。支持的类型有only value	如果 borderType==BORDER_CONSTANT，为边界 BGR 或 YUV 值。

注意

输入图像必须是 uint8，并且只支持 GRAY 和 BGR 图像。输入和输出图像的分辨率必须在范围 [10*6, 4096*4096] 内。

支持的设备仅限于以下产品：Atlas Inference 系列产品、Atlas 200/500 A2 Inference 产品和Atlas A2 Training 系列产品/Atlas 300I A2 Inference 产品。

参见

cv::copyMakeBorder，cv::borderInterpolate

crop() [1/2]

AscendMat cv::cann::crop	(	const AscendMat &	src,
		const Rect &	rect,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

crop() [2/2]

AscendMat cv::cann::crop	(	InputArray	src,
		const Rect &	rect,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

裁剪一个二维数组。该函数通过给定的 cv::Rect 裁剪矩阵。输出矩阵必须与输入矩阵具有相同的深度，大小由给定矩形大小指定。

参数

src	输入数组。
rect	裁剪数组的矩形
stream	AscendStream 异步版本。

参见

cv::gapi::crop

cropResize() [1/2]

void cv::cann::cropResize	(	const AscendMat &	src,
		AscendMat &	dst,
		const Rect &	rect,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

cropResize() [2/2]

void cv::cann::cropResize	(	const InputArray	src,
		OutputArray	dst,
		const Rect &	rect,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation
	)

#include <

从大图像中裁剪子图像，并将其调整到特定大小。

参数

src	输入数组。
dst	输出数组。它具有大小 dsize（当它非零时）或从 src.size()，fx 和 fy 计算得到的大小；dst 的类型与 src 相同。
rect	裁剪数组的矩形
dsize	输出图像大小；如果等于零，则计算如下 cv::resize。
fx	水平轴上的缩放因子；当它等于 0 时，计算如下 \[(𝚍𝚘𝚞𝚋𝚕𝚎)𝚍𝚜𝚒𝚣𝚎.𝚠𝚒𝚍𝚝𝚑/𝚜𝚛𝚌.𝚌𝚘𝚕𝚜\]
fy	垂直轴上的缩放因子；当它等于 0 时，计算如下 \[(𝚍𝚘𝚞𝚋𝚕𝚎)𝚍𝚜𝚒𝚣𝚎.𝚑𝚎𝚒𝚐𝚑𝚝/𝚜𝚛𝚌.𝚛𝚘𝚠𝚜\]
interpolation	插值方法，此处只支持 INTER_NEAREST 和 INTER_LINEAR。 (参见 cv.cann.InterpolationFlags)

注意

输入图像必须是 uint8，并且只支持 GRAY 和 BGR 图像。输入和输出图像的分辨率必须在范围 [10*6, 4096*4096] 内。

支持的设备仅限于以下产品：Atlas Inference 系列产品、Atlas 200/500 A2 Inference 产品和Atlas A2 Training 系列产品/Atlas 300I A2 Inference 产品。

参见

cv::gapi::crop，cv::resize，cv::cann::resize

cropResizeMakeBorder() [1/2]

void cv::cann::cropResizeMakeBorder	(	const AscendMat &	src,
		AscendMat &	dst,
		const Rect &	rect,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation,
		int	top,
		int	left,
		const int	borderType,
		Scalar	value = ]
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

cropResizeMakeBorder() [2/2]

void cv::cann::cropResizeMakeBorder	(	const InputArray	src,
		OutputArray	dst,
		const Rect &	rect,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation,
		int	top,
		int	left,
		const int	borderType,
		Scalar	value = ]
	)

#include <

从大图像中裁剪出小图像，将其调整到指定大小，并在顶部/左侧生成边界并填充指定边界类型。

参数

src	输入数组。
dst	输出数组；它具有大小 Size(dsize.height + top, dsize.width + left)。
rect	裁剪数组的矩形
dsize	调整大小的大小；
fx	沿横向轴的缩放因子；
fy	沿垂直轴的缩放因子；
interpolation	插值方法，仅支持 INTER_NEAREST 和 INTER_LINEAR。 (参见 cv.cann.InterpolationFlags)
borderType	边界外推方法，仅支持 cv::BorderTypes::BORDER_CONSTANT 和 cv::BorderTypes::BORDER_REPLICATE。
value	如果 borderType==BORDER_CONSTANT，为边界 BGR 或 YUV 值。
top	顶部填充像素数
left	左侧填充像素数

注意

输入图像必须是 uint8，并且只支持 GRAY 和 BGR 图像。输入和输出图像的分辨率必须在范围 [10*6, 4096*4096] 内。

支持的设备仅限于以下产品：Atlas Inference 系列产品、Atlas 200/500 A2 Inference 产品和Atlas A2 Training 系列产品/Atlas 300I A2 Inference 产品。

参见

cv::gapi::crop，cv::resize，cv::cann::resize，cv::BorderTypes

flip() [1/2]

void cv::cann::flip	(	const AscendMat &	src,
		AscendMat &	dst,
		int	flipCode,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

flip() [2/2]

void cv::cann::flip	(	InputArray	src,
		OutputArray	dst,
		int	flipCode,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

围绕垂直、水平或两者同时翻转2D矩阵。

参数

src	源矩阵。
dst	目标矩阵。
flipCode	源翻转模式 0 绕x轴翻转。 > 0 绕y轴翻转。 < 0 绕两个轴翻转。
stream	AscendStream 异步版本。

注意

src必须是以下类型之一：float16、float、int64、int32、int16、uint16

参见

cv::flip cv::cuda::flip

merge() [1/4]

void cv::cann::merge	(	const AscendMat *	src,
		size_t	n,
		AscendMat &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

从多个单通道矩阵中创建一个多通道矩阵。

参数

src	源矩阵数组/向量。
n	源矩阵的数量。
dst	目标矩阵。
stream	AscendStream 异步版本。

注意

src必须是以下类型之一：float16、float32、double、int32、int16、int8、int64、uint8、uint16、uint32、uint64。

参见

cv::merge cv::cuda::merge

merge() [2/4]

void cv::cann::merge	(	const AscendMat *	src,
		size_t	n,
		OutputArray &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

merge() [3/4]

void cv::cann::merge	(	const std::vector< AscendMat > &	src,
		AscendMat &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

merge() [4/4]

void cv::cann::merge	(	const std::vector< AscendMat > &	src,
		OutputArray &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

resize() [1/2]

void cv::cann::resize	(	const AscendMat &	src,
		AscendMat &	dst,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

resize() [2/2]

void cv::cann::resize	(	InputArray	src,
		OutputArray	dst,
		Size	dsize,
		double	fx,
		double	fy,
		int	interpolation,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

将图像src调整到指定大小或更小。

参数

src	输入图像
dst	输出图像；其尺寸为dsize（当它非零时）或从src.size()、fx和fy计算得到的尺寸；dst的类型与src相同。
dsize	输出图像尺寸；如果它等于零，则如公式 \[𝚍𝚜𝚒𝚣𝚎 = 𝚂𝚒𝚣𝚎(𝚛𝚘𝚞𝚗𝚍(𝚏𝚡*𝚜𝚛𝚌.𝚌𝚘𝚕𝚜), 𝚛𝚘𝚞𝚗𝚍(𝚏𝚢*𝚜𝚛𝚌.𝚛𝚘𝚠𝚜))\] 要么dsize或fx和fy都非零。
fx	水平轴上的缩放因子；当它等于 0 时，计算如下 \[(𝚍𝚘𝚞𝚋𝚕𝚎)𝚍𝚜𝚒𝚣𝚎.𝚠𝚒𝚍𝚝𝚑/𝚜𝚛𝚌.𝚌𝚘𝚕𝚜\]
fy	垂直轴上的缩放因子；当它等于 0 时，计算如下 \[(𝚍𝚘𝚞𝚋𝚕𝚎)𝚍𝚜𝚒𝚣𝚎.𝚑𝚎𝚒𝚐𝚑𝚝/𝚜𝚛𝚌.𝚛𝚘𝚠𝚜\]
interpolation	插值方法（参见 cv.cann.InterpolationFlags）
stream	AscendStream 异步版本。

注意

在使用最邻近邻域或双线性插值进行重采样时，有一些对输入数据类型的限制：输入图像必须是uint8，且仅支持GRAY和BGR图像。输入输出图像的分辨率必须在[10*6, 4096*4096]范围内。二次样条插值：输入图像可以是不同类型，输出图像必须是float或uint8。像素区域插值：输入图像可以是不同类型，但输出图像始终是float。
在采用最邻近邻域或双线性插值进行重采样时，支持的设备只有：Atlas Inference系列产品、Atlas 200/500 A2 Inference产品以及Atlas A2 Training系列产品/Atlas 300I A2 Inference产品

参见

cv::resize

rotate() [1/2]

void cv::cann::rotate	(	const AscendMat &	src,
		AscendMat &	dst,
		int	rotateMode,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

rotate() [2/2]

void cv::cann::rotate	(	InputArray	src,
		OutputArray	dst,
		int	rotateCode,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

以90度为增量旋转2D数组。函数cv::rotate 可以以三种不同的方式旋转数组：顺时针旋转90度（rotateCode = ROTATE_90_CLOCKWISE）。顺时针旋转180度（rotateCode = ROTATE_180）。顺时针旋转270度（rotateCode = ROTATE_90_COUNTERCLOCKWISE）。

参数

src	输入数组。
dst	与src同类型的输出数组。其大小与ROTATE_180相同，对于ROTATE_90_CLOCKWISE和ROTATE_90_COUNTERCLOCKWISE，行和列互换了。
rotateCode	一个枚举值，用于指定如何旋转数组；参见枚举 RotateFlags
stream	AscendStream 异步版本。

注意

src必须是以下类型之一：float16、float、int64、int32、int16、uint16

参见

cv::rotate

split() [1/4]

void cv::cann::split	(	const AscendMat &	src,
		AscendMat *	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

将多通道矩阵的每个平面复制到一个数组中。

参数

src	源矩阵。
dst	单通道矩阵的目标数组/向量。
stream	AscendStream 异步版本。

注意

src必须是以下类型之一：float16, float32, double, int64, int32, uint8, uint16, uint32, uint64, int8, int16, bool

参见

cv::split cv::cuda::split

split() [2/4]

void cv::cann::split	(	const AscendMat &	src,
		std::vector< AscendMat > &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

split() [3/4]

void cv::cann::split	(	const InputArray	src,
		AscendMat *	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

split() [4/4]

void cv::cann::split	(	const InputArray	src,
		std::vector< AscendMat > &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

transpose() [1/2]

void cv::cann::transpose	(	const AscendMat &	src,
		AscendMat &	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

transpose() [2/2]

void cv::cann::transpose	(	InputArray	src,
		OutputArray	dst,
		AscendStream &	stream = AscendStream::Null()
	)

#include <

转置矩阵。

参数

src	源矩阵。
dst	目标矩阵。
stream	AscendStream 异步版本。

注意

src必须是以下类型之一：float16, float, int8, int16, int32, int64, uint8, uint16, uint32, uint64, bool

参见

cv::transpose cv::cuda::transpose