Rotate

Function Usage

Image rotating API of the tensor class, which is used to rotate an image to a specified angle. Asynchronous calling is supported.

Only Atlas inference product and Atlas 800I A2 inference product support this API.

The following conditions must be met:

The input and output tensors must be on the device or DVPP side, and the parameters (stream and data memory) must be on the same device.
For synchronization, the device where the data memory is located must be the same as the initialized device.
The input and output parameters match the tensors types.

Prototype

APP_ERROR Rotate(const Tensor &src, Tensor &dst, const RotateAngle angle, AscendStream& stream = AscendStream::DefaultStream());

Parameters

Parameter	Input/Output	Description
src	Input	Tensor class, input tensor, which cannot be empty. The input can be HWC (three-dimensional) or HW (two-dimensional). For the Atlas inference product, the float16, float32, and uint8 types are supported. For the Atlas 800I A2 inference product, the range of the input tensor width is [10, 4096]. When the input image format is YUV_400, the minimum width is 18 and the height range is [10, 4096]. Memory needs to be allocated on the device or DVPP side. The uint8 type is supported.
dst	Output	Tensor class, rotation result. An empty tensor can be passed. For the Atlas inference product, if dst is not an empty tensor, call Tensor.Malloc() to allocate memory in advance. The float16, float32, and uint8 types are supported. For Atlas 800I A2 inference product, if dst is not an empty tensor, the width range of the input tensor is [10, 4096]. When the input image format is YUV_400, the minimum width is 18 and the height range is [10, 4096]. Memory needs to be allocated on the device or DVPP. The uint8 type is supported. If the rotation angle is 180 degrees, the shape is the same as that of src. If the rotation angle is 90 degrees or 270 degrees, the shape is the HW channel of the src after transposition.
angle	Input	RotateAngle enumeration class. It specifies the clockwise rotation angle: 90 degrees, 180 degrees, or 270 degrees (ROTATE_90, ROTATE_180, and ROTATE_270).
stream	Input	AscendStream type. The default value is AscendStream::DefaultStream(). When the parameter value is the default value, the API calling is a synchronous operation. In other cases, the API calling is an asynchronous operation.

Response Parameters

Data Structure	Description
APP_ERROR	For details about the returned error codes, see APP_ERROR Description.

Parent topic: TensorOperations