show

Show collision geometry

Syntax

ax = show(geom)

[ax,patchobj] = show(geom)

show(geom)

show(geom,'Parent',AX)

Description

ax = show(geom) returns the axes under which the collision geometry is plotted.

[ax,patchobj] = show(geom) returns the patchobj graphic object that represents the collision geometry in the plot.

show(geom) shows the collision geometry in the current figure at its current pose. The tessellation is generated automatically.

show(geom,'Parent',AX) specifies the axes AX in which to plot the collision geometry.

Examples

Show Collision Geometry

Create a cylinder collision geometry. The cylinder has a length of 3 meters and a radius of 1 meter.

cyl = collisionCylinder(1,3);

Show the cylinder.

show(cyl)

Show the cylinder in a new figure, and return the patch object that represents the cylinder. Change the cylinder color to cyan by changing the RGB value of the FaceColor field in the patch object. Hide the edges by setting EdgeColor to 'none'.

figure
[~,patchObj] = show(cyl);
patchObj.FaceColor = [0 1 1];
patchObj.EdgeColor = 'none';

Input Arguments

geom — Collision geometry

collisionBox object | collisionCylinder object | collisionMesh object | collisionSphere object

Collision geometry to show.

AX — Axes on which to plot

Axes object

Axes in which to plot the collision geometry, specified as an Axes object.

Output Arguments

ax — Axes

Axes object

Axes under which the collision geometry geom is shown, returned as an Axes object. For more information, see Axes Properties.

patchobj — Graphic object

Patch object

Graphic object that represents the collision geometry, returned as a Patch object. For more information, see Patch Properties.

Version History

Introduced in R2019b