plot

Plot polyshape

Syntax

plot(pgon)

plot(pgon,Name,Value)

h = plot(___)

Description

plot(pgon) plots a polyshape object.

plot(pgon,Name,Value) specifies additional properties of the polyshape plot using one or more name-value pairs. For example, plot(pgon,'FaceColor','green') shades the solid regions of a polyshape green.

When pgon is an ill-defined polygon, the shading of the plot can be inaccurate.

h = plot(___) returns a Polygon graphics object for either of the previous syntaxes. You can change the appearance and behavior of the plot by directly changing the properties of h. For more information, see Polygon Properties.

Examples

Simple Rectangle

Plot a rectangular polygon.

pgon = polyshape([0 0 2 2],[2 0 0 2]);
plot(pgon)

Modify Plot

Create a rectangular polygon. Plot the rectangle, specifying the color and transparency factor.

pgon = polyshape([0 0 2 2],[2 0 0 2]);
plot(pgon,'FaceColor','red','FaceAlpha',0.1)

You can also change the appearance of the plot by assigning property values to the graphics object.

h = plot(pgon)

h = 
  Polygon with properties:

    FaceColor: [0 0.4470 0.7410]
    FaceAlpha: 0.3500
    EdgeColor: [0 0 0]
    LineWidth: 0.5000
    LineStyle: '-'
        Shape: [1x1 polyshape]

  Show all properties

h.LineStyle = '--';
h.EdgeColor = 'red';

Input Arguments

pgon — Input polyshape

scalar | vector | matrix | multidimensional array

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

Data Types: polyshape

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: plot(pgon,'LineStyle','--')

The plot properties listed here are only a subset. For a complete list, see Polygon Properties.

'FaceColor' — Color for solid regions

[0.85 0.85 0.85] (default) | color name | RGB triplet | 'none'

Color for solid regions of the polygon, specified as the comma-separated pair consisting of 'FaceColor' and a color name, an RGB triplet, or 'none'.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7]. This table lists the long and short color name options and the equivalent RGB triplet values.

Long Name	Short Name	RGB Triplet
'yellow'	'y'	[1 1 0]
'magenta'	'm'	[1 0 1]
'cyan'	'c'	[0 1 1]
'red'	'r'	[1 0 0]
'green'	'g'	[0 1 0]
'blue'	'b'	[0 0 1]
'white'	'w'	[1 1 1]
'black'	'k'	[0 0 0]

'FaceAlpha' — Face transparency

1 (default) | scalar in range [0,1]

Face transparency, specified as the comma-separated pair consisting of 'FaceAlpha' and a scalar in the range [0,1]. A value of 1 is opaque and 0 is completely transparent. Values between 0 and 1 are semitransparent.

'EdgeColor' — Color for boundaries

[0 0 0] (default) | color name | RGB triplet | 'none'

Color for boundaries of the polygon, specified as the comma-separated pair consisting of 'EdgeColor' and a color name, an RGB triplet, or 'none'. The default color of [0 0 0] corresponds to black boundaries.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7]. This table lists the long and short color name options and the equivalent RGB triplet values.

Long Name	Short Name	RGB Triplet
'yellow'	'y'	[1 1 0]
'magenta'	'm'	[1 0 1]
'cyan'	'c'	[0 1 1]
'red'	'r'	[1 0 0]
'green'	'g'	[0 1 0]
'blue'	'b'	[0 0 1]
'white'	'w'	[1 1 1]
'black'	'k'	[0 0 0]

'EdgeAlpha' — Edge transparency

1 (default) | scalar in range [0,1]

Edge transparency, specified as the comma-separated pair consisting of 'EdgeAlpha' and a scalar in the range [0,1]. A value of 1 is opaque and 0 is completely transparent. Values between 0 and 1 are semitransparent.

'LineWidth' — Line width

0.5 (default) | positive numeric value

Line width, specified as the comma-separated pair consisting of 'LineWidth' and a positive numeric value in points.

'LineStyle' — Line style

'-' (default) | '--' | ':' | '-.' | 'none'

Line style, specified as one of the options listed in this table.

Line Style	Description	Resulting Line
'-'	Solid line
'--'	Dashed line
':'	Dotted line
'-.'	Dash-dotted line
'none'	No line	No line

Output Arguments

h — Polygon graphics object

scalar | vector | matrix | multidimensional array

Polygon graphics object, specified as a scalar, vector, matrix, or multidimensional array. For more information on the properties of h, see Polygon Properties.

Data Types: Polygon