# translate

Translate polyshape

## Description

example

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

collapse all

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

collapse all

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

Data Types: polyshape

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 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 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

## Version History

Introduced in R2017b