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]

  Use GET to 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 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.

FaceColor — Color for solid regions

[0 0.4470 0.7410] (default) | RGB triplet | hexadecimal color code | color name | 'none'

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 from 0 to F. 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 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

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB^® uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

FaceAlpha — Face transparency

0.35 (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

Version History

Introduced in R2017b