Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 10/31/2024
Public
Document Table of Contents

GetRotateShift

Computes shift values for rotation of an image around the specified center.

Syntax

IppStatus ippiGetRotateShift (double xCenter, double yCenter, double angle, double* xShift, double* yShift);

Include Files

ippi.h

Flavors with the _L suffix: ippi_l.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

xCenter, yCenter

Coordinates of the required center of rotation.

angle

The angle in degrees to rotate the image clockwise around the point with coordinates (xCenter, yCenter).

xShift, yShift

Pointers to computed shift values along horizontal and vertical axes. These shift values should be passed to ippiRotate function to bring about the desired rotation around (xCenter, yCenter).

Description

Use this function if you need to rotate an image about an arbitrary center (xCenter, yCenter) rather than the origin (0,0). The function helps compute shift values xShift, yShift that should be passed to the warping function for the rotation around (xCenter, yCenter) to take place.

Example shows how to use the function ippiGetRotateShift.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error.

ippStsNullPtrErr

Indicates an error condition if xShift or yShift pointer is NULL.