extrude

Extrude 2-D shape on another shape

Since R2023b

Syntax

extShape= extrude(shape1,shape2)

extShape= extrude(___,Name=Value)

Description

extShape= extrude(shape1,shape2) extrudes the shape2 on the shape1 surface by a height of 1 m. The center of the shape2 must lie on the surface of shape1.

extShape= extrude(___,Name=Value) extrudes the shape2 on the shape1 surface with additional options specified by one or more Name-Value Arguments. The center of the shape2 must lie on the surface of shape1.

Examples

Extrude Rectangle on Box

Create a box and a rectangle. Align both the shapes.

box = shape.Box;
rect = shape.Rectangle(Length=0.2,Width=0.2);
[~] = translate(rect,[0 0 1]);

Extrude the rectangle on the box face with a height of 0.5 m and 20 segments.

extShape = extrude(box,rect,Height=0.5,NumSegments=20);
show(extShape);

Input Arguments

shape1 — Shape to base extruded shape

2-D or 3-D shape object

Shape to base the extruded shape, specified as either a 2-D or a 3-D shape object.

Example: shape.Box

Example: shape.Circle

shape2 — Shape to extrude

2-D shape object

Shape to extrude, specified as a 2-D shape object.

Example: shape.Polygon

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Height=4

Height — Extrusion height

1 (default) | positive scalar

Extrusion height, specified as a positive scalar.

Example: 1

Data Types: double

NumSegments — Number of divisions along extrusion height

2 (default) | positive scalar

Number of divisions along the extrusion height, specified as a positive scalar.

Example: 20

Data Types: double

SnapToMetal — Option to extrude shape up to nearest metal

0 (default) | 1false | true

Option to extrude shape up to nearest metal, specified as 0 or false to disable, or 1 or true to enable. Set this argument to 1 or true to extrude the shape up to the nearest metal surface. When this argument is 0 or false, the shape extrudes up to the height specified in the Height argument.

Example: 1

Data Types: double | logical

Output Arguments

extShape — Extruded shape

shape.Custom3D object

Extruded shape, returned as a shape.Custom3D object.

Version History

Introduced in R2023b