Main Content

plot

Plot polyshape

Description

example

plot(pgon) plots a polyshape object.

example

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.

example

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

collapse all

Plot a rectangular polygon.

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

Figure contains an axes object. The axes object contains an object of type polygon.

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)

Figure contains an axes object. The axes object contains an object of type polygon.

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

Figure contains an axes object. The axes object contains an object of type polygon.

Input Arguments

collapse all

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

Data Types: polyshape

Name-Value 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.

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 NameShort NameRGB 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]

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.

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 NameShort NameRGB 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]

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.

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

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

Line StyleDescriptionResulting Line
'-'Solid line

Sample of solid line

'--'Dashed line

Sample of dashed line

':'Dotted line

Sample of dotted line

'-.'Dash-dotted line

Sample of dash-dotted line, with alternating dashes and dots

'none'No lineNo line

Output Arguments

collapse all

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

Introduced in R2017b