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
Plot a rectangular polygon.
pgon = polyshape([0 0 2 2],[2 0 0 2]); plot(pgon)
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.0660 0.4430 0.7450]
FaceAlpha: 0.3500
EdgeColor: [0.1294 0.1294 0.1294]
LineWidth: 0.5000
LineStyle: '-'
Shape: [1×1 polyshape]
Show all properties
h.LineStyle = '--'; h.EdgeColor = 'red';
Input Arguments
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.
Before R2021a, use commas to separate each name and value, and enclose
Name in quotes.
Example: plot(pgon,'LineStyle','--')
The plot properties listed here are only a subset. For a complete list, see Polygon Properties.
Color for solid regions, specified as the comma-separated pair
consisting of 'FaceColor' and an RGB triplet, a
hexadecimal color code, a color name, or
'none'.
For a custom color, specify an RGB triplet or a hexadecimal color code.
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].A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (
#) followed by three or six hexadecimal digits, which can range from0toF. The values are not case sensitive. Therefore, the color codes"#FF8800","#ff8800","#F80", and"#f80"are equivalent.
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.
| Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan"
| "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | Not applicable | Not applicable | Not applicable | No color |
This table lists the default color palettes for plots in the light and dark themes.
| Palette | Palette Colors |
|---|---|
Before R2025a: Most plots use these colors by default. |
|
|
|
You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.
RGB = orderedcolors("gem");
H = rgb2hex(RGB);Before R2023b: Get the RGB triplets using RGB =
get(groot,"FactoryAxesColorOrder").
Before R2024a: Get the hexadecimal color codes using H =
compose("#%02X%02X%02X",round(RGB*255)).
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 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] |
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 Style | Description | Resulting Line |
|---|---|---|
"-" | Solid line |
|
"--" | Dashed line |
|
":" | Dotted line |
|
"-." | Dash-dotted line |
|
"none" | No line | No line |
Output Arguments
Version History
Introduced in R2017b
