plot
Plot polyshape
Description
plot(
specifies additional properties of the pgon,Name,Value)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(___)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.
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.
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 |
