translate

Move shape to new location

Syntax

translate(shape,locationpoints)

c = translate(shape,locationpoints)

Description

translate(shape,locationpoints) moves the shape to a new specified location using a translation vector and plots the resultant shape.

c = translate(shape,locationpoints) moves the shape to a new specified location using a translation vector and returns a shape object.

Examples

Create and Transform Polygon

Create a polygon using antenna.Polygon with vertices at [-1 0 0; -0.5 0.2 0; 0 0 0] and display it.

p = antenna.Polygon(Vertices=[-1 0 0; -0.5 0.2 0; 0 0 0])

p = 
  Polygon with properties:

        Name: 'mypolygon'
    Vertices: [3×3 double]

show(p)
axis equal

Mesh the polygon and display the meshed shape.

mesh(p,0.2)

Move the polygon to a new location on the X-Y plane.

translate(p,[2,1,0])
axis equal

Input Arguments

shape — Shape to move

shape object

Shape to move, specified as one of the following objects:

• 2-D shapes without material properties:

  • antenna.Circle

  • antenna.Ellipse

  • antenna.Polygon

  • antenna.Rectangle

  • antenna.Triangle

• 2-D and 3-D shapes with material properties:

  • shape.Circle

  • shape.Ellipse

  • shape.Rectangle

  • shape.Polygon

  • shape.Box

  • shape.OpenBox

  • shape.Cylinder

  • shape.OpenCylinder

  • shape.Sphere

  • shape.Custom3D

Example: antenna.Rectangle

Example: shape.Polygon

Example: shape.Box

locationpoints — Translation vector

three-element vector

Translation vector, specified as a three-element vector.

Example: [0 1 1]

Data Types: double

Output Arguments

c — Resultant shape

shape object

Resultant shape after the translate operation on the input shape, returned as a shape object.

Example: antenna.Rectangle

Example: shape.Polygon

Example: shape.Box

Version History

Introduced in R2017a