Main Content

plot

Plot polyshape

Description

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.

example

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]

  Use GET to 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 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 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 NameShort NameRGB TripletHexadecimal Color CodeAppearance
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"Not applicableNot applicableNot applicableNo color

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

RGB TripletHexadecimal Color CodeAppearance
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

Version History

Introduced in R2017b