rotate

Rotate polyshape

Syntax

polyout = rotate(polyin,theta)

polyout = rotate(polyin,theta,refpoint)

Description

polyout = rotate(polyin,theta) returns a polyshape object created by rotating polyin by theta degrees with respect to the reference point (0,0).

example

polyout = rotate(polyin,theta,refpoint) specifies a reference point to rotate with respect to.

example

Examples

collapse all

Rotate Square

Open Live Script

Create a square, polyin, and rotate it 45 degrees counterclockwise with respect to the point (0,0).

polyin = polyshape([0 0 1 1],[1 0 0 1]);
poly1 = rotate(polyin,45);

Rotate polyin 45 degrees with respect to the point (1,0).

poly2 = rotate(polyin,45,[1 0]);

Plot all three polygons.

plot([polyin poly1 poly2])
axis equal

Figure contains an axes object. The axes object contains 3 objects of type polygon.

Input Arguments

collapse all

`polyin` — Input `polyshape`
scalar | vector | matrix | multidimensional array

Input polyshape, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: polyshape

`theta` — Rotation angle
scalar

Rotation angle, specified as a scalar number of degrees. When the input polyshape is an array, each element of the array is rotated by theta degrees. The rotation is counterclockwise when theta is positive, and clockwise when theta is negative.

`refpoint` — Reference point
`[0 0]` | two-element row vector

Reference point, specified as a two-element row vector containing the x-coordinate and y-coordinate. The rotate function rotates with respect to the reference point. When the input polyshape is an array, each element of the array is rotated with respect to refpoint.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

Dynamic memory allocation must be enabled for code generation.
Name-value pair must be compile time constant.

Version History

Introduced in R2017b