plot

Plot polyshape

collapse all in page

Syntax

plot(pgon)

plot(pgon,Name,Value)

h = plot(___)

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

Simple Rectangle

Open Live Script

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.

Modify Plot

Open Live Script

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

`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

collapse all

`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

plot

Syntax

Description

Examples

Simple Rectangle

Modify Plot

Input Arguments

pgon — Input polyshape scalar | vector | matrix | multidimensional array

Name-Value Arguments

FaceColor — Color for solid regions [0 0.4470 0.7410] (default) | RGB triplet | hexadecimal color code | color name | 'none'

FaceAlpha — Face transparency 0.35 (default) | scalar in range [0,1]

EdgeColor — Color for boundaries [0 0 0] (default) | color name | RGB triplet | 'none'

EdgeAlpha — Edge transparency 1 (default) | scalar in range [0,1]

LineWidth — Line width 0.5 (default) | positive numeric value

LineStyle — Line style "-" (default) | "--" | ":" | "-." | "none"

Output Arguments

h — Polygon graphics object scalar | vector | matrix | multidimensional array

Version History

See Also

`pgon` — Input `polyshape`
scalar | vector | matrix | multidimensional array

`FaceColor` — Color for solid regions
`[0 0.4470 0.7410]` (default) | RGB triplet | hexadecimal color code | color name | `'none'`

`FaceAlpha` — Face transparency
`0.35` (default) | scalar in range `[0,1]`

`EdgeColor` — Color for boundaries
`[0 0 0]` (default) | color name | RGB triplet | `'none'`

`EdgeAlpha` — Edge transparency
`1` (default) | scalar in range `[0,1]`

`LineWidth` — Line width
`0.5` (default) | positive numeric value

`LineStyle` — Line style
`"-"` (default) | `"--"` | `":"` | `"-."` | `"none"`

`h` — `Polygon` graphics object
scalar | vector | matrix | multidimensional array