Line Properties
Annotation line appearance and behavior
Line
properties control the appearance and behavior of an
Line
object. By changing property values, you can modify certain
aspects of the line. Use dot notation to query and set properties.
h = annotation("line"); c = h.Color; h.Color = "red";
Color and Styling
Color
— Line color
[0 0 0]
(default) | RGB triplet | hexadecimal color code | "r"
| "g"
| "b"
| ...
Line color, specified as an RGB triplet, a hexadecimal color code, a color
name, or a short name. The default value of [0 0 0]
corresponds to black.
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 from0
toF
. 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" |
Example: "blue"
Example: [0 0 1]
Example: "#0000FF"
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 |
LineWidth
— Line width
0.5
(default) | positive value
Line width, specified as a positive value in point units. One point equals 1/72 inch.
Example: 0.75
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Position
X
— Beginning and ending x-coordinates
[0.3 0.4]
(default) | two-element vector
Beginning and ending x-coordinates, specified as a
two-element vector of the form [x_begin x_end]
.
By default, the units are normalized to the figure. The lower-left corner
of the figure maps to (0,0)
and the upper-right corner
maps to (1,1)
. To change the units, use the
Units
property.
Example: [0.2 0.3]
Y
— Beginning and ending y-coordinates
[0.3 0.4]
(default) | two-element vector
Beginning and ending y-coordinates, specified as a
two-element vector of the form [y_begin y_end]
.
By default, the units are normalized to the figure. The lower-left corner
of the figure maps to (0,0)
and the upper-right corner
maps to (1,1)
. To change the units, use the
Units
property.
Example: [0.2 0.3]
Position
— Size and location
[0.3 0.3 0.1 0.1]
(default) | four-element vector
Size and location, specified as a four-element vector of the form
[x_begin y_begin dx dy]
. The first two elements
specify the coordinates of the starting point of the line. The second two
elements specify the slope of the line.
By default, the units are normalized to the figure. The lower-left corner
of the figure maps to (0,0)
and the upper-right corner
maps to (1,1)
. To change the units, use the
Units
property. To change the units, use the
Units
property.
Example: [0.2 0.2 0.3 0.3]
Units
— Position units
"normalized"
(default) | "inches"
| "centimeters"
| "characters"
| "points"
| "pixels"
Position units, specified as one of the values in this table.
Units | Description |
---|---|
"normalized" (default) | Normalized with respect to the figure, uipanel, or uitab that
contains the annotation. The lower-left corner of the container maps
to (0,0) and the upper-right corner maps to (1,1) . |
"inches" | Inches. |
"centimeters" | Centimeters. |
"characters" |
Based on the default system font character size.
|
"points" | Points. One point equals 1/72 inch. |
"pixels" | Pixels. Starting in R2015b, distances in pixels are independent of your system resolution on Windows® and Macintosh systems:
On Linux® systems, the size of a pixel is determined by your system resolution. |
All units are measured from the lower-left corner of the figure window.
This property affects the Position
property.
If you change the units, then it is good practice to return it to
the default value after completing your computation to prevent affecting
other functions that assume Units
is set to the
default value.
If you specify the Position
and Units
properties
using name-value arguments when creating the object, then the order of specification
matters. If you want to define the position with particular units, then you must set the
Units
property before the Position
property.
Version History
Introduced before R2006a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)