translate

Translate polyshape

Syntax

polyout = translate(polyin,v)

polyout = translate(polyin,x,y)

Description

polyout = translate(polyin,v) returns a polyshape object defined by translating polyin by v. The first element of v specifies the distance to translate in the x direction, and the second element specifies the distance to translate in the y direction.

polyout = translate(polyin,x,y) specifies the x and y translation amounts as separate arguments.

Examples

Translate Square

Create a square, then translate the square to the right by two units, and up by one unit. Plot both squares.

polyin = polyshape([0 0 1 1],[1 0 0 1]);
polyout = translate(polyin,[2 1]);
plot([polyin polyout])
axis equal

Input Arguments

polyin — Input polyshape

scalar | vector | matrix | multidimensional array

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

Data Types: polyshape

v — Translation distance

two-element row vector

Translation distance, specified as a two-element row vector. The first element of v specifies the distance to translate in the x direction, and the second element specifies the distance to translate in the y direction. Positive distances translate right and up, and negative distances translate left and down. When the input polyshape is an array, each element of the array is translated according to v.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

x — x translation distance

scalar

x translation distance, specified as a scalar. Positive distances translate right, and negative distances translate left. When the input polyshape is an array, each element of the array is translated in the x direction according to x.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

y — y translation distance

scalar

y translation distance, specified as a scalar. Positive distances translate up, and negative distances translate down. When the input polyshape is an array, each element of the array is translated in the y direction according to y.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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