Line Properties
Line
properties control the appearance and behavior of a
Line
object. By changing property values, you can modify certain aspects of
the line plot.
uif = uifigure; g = geoglobe(uif); p = geoplot3(g,51.5074,0.1900,200) p.Marker = 'o'; p.LineWidth = 2;
Line
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.
RGB triplets and hexadecimal color codes are useful for specifying custom colors.
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 character vector or a string scalar that starts with a hash symbol (
#
) followed by three or six hexadecimal digits, which can range from0
toF
. The values are not case sensitive. Thus, 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" |
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 these options:
Line Style | Description | Resulting Line |
---|---|---|
'-' | Solid line (default) |
|
'none' | No line | No line |
LineWidth
— Line width
0.5
(default) | positive value
Line width, specified as a positive value in points, where 1 point = 1/72 of an inch. If the line has markers, then the line width also affects the marker edges.
The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.
SeriesIndex
— Series index
positive integer
Series index, specified as a positive integer. This property is useful for
reassigning the colors of several Line
objects so that they match each
other. By default, the SeriesIndex
property of a line object is a
number that corresponds to the object's order of creation, starting at
1
.
MATLAB uses the number to calculate indices for assigning color when you call
plotting functions. The indices refer to the rows of the arrays stored in the
ColorOrder
property of the parent object.
MATLAB automatically updates the color of the Line
object when
you change its SeriesIndex
, or when you change the
ColorOrder
property on the parent object. However, the following
conditions must be true for the changes to have any effect:
The
SeriesIndex
property on theLine
object is greater than0
.The
NextSeriesIndex
property on the parent object is greater than0
.
Markers
Marker
— Marker symbol
'none'
(default) | 'o'
Marker symbol, specified as 'none'
or 'o'
. By default, the line does not display markers. Specify 'o'
to display circle markers at each data point or vertex.
Markers do not tilt or rotate as you navigate the globe.
MarkerIndices
— Indices of data points at which to display markers
1:length(LatitudeData)
(default) | vector of positive integers | scalar positive integer
Indices of data points at which to display markers, specified as a vector of positive integers. If you do not specify the indices, then MATLAB displays a marker at every data point.
Note
To see the markers, you must also specify a marker symbol.
Example: geoplot3(g,lat,lon,h,'-o','MarkerIndices',[1 5 10])
displays a circle marker at the first, fifth, and tenth data points.
Example: geoplot3(g,lat,lon,h,'-o','MarkerIndices',1:3:length(lat))
displays a circle marker every three data points.
Example: geoplot3(g,lat,lon,h,'Marker','o','MarkerIndices',5)
displays one circle marker at the fifth data point.
MarkerSize
— Marker size
6
(default) | positive value
Marker size, specified as a positive value in points, where 1 point = 1/72 of an inch.
Coordinate Data
LatitudeData
— Latitude values
vector
Latitude values, specified as a vector. LatitudeData
and
LongitudeData
must have the same size.
LongitudeData
— Longitude values
vector
Longitude values, specified as a vector. LatitudeData
and
LongitudeData
must have the same size.
HeightData
— Height values
scalar | vector
Height values, specified as a scalar or vector. If HeightData
is
a scalar, then its value is applied to every element in LatitudeData
and LongitudeData
. If HeightData
is a vector, it
must be the same size as LatitudeData
and
LongitudeData
.
HeightReference
— Height reference
'geoid'
(default) | 'terrain'
| 'ellipsoid'
Height reference, specified as one of these values:
'geoid'
– Height values are relative to the geoid (mean sea level).'terrain'
– Height values are relative to the ground.'ellipsoid'
– Height values are relative to the WGS84 reference ellipsoid.
For more information about terrain, geoid, and ellipsoid height, see Find Ellipsoidal Height from Orthometric and Geoid Height.
Interactivity
Visible
— State of visibility
'on'
(default) | on/off logical value
State of visibility, specified as 'on'
or 'off'
,
or as numeric or logical 1
(true
) or
0
(false
). A value of 'on'
is equivalent to true
, and 'off'
is equivalent to
false
. Thus, you can use the value of this property as a logical
value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
'on'
— Display the object.'off'
— Hide the object without deleting it. You still can access the properties of an invisible object.
Parent/Child
Parent
— Parent
GeographicGlobe
object
Parent, specified as a GeographicGlobe
object.
Children
— Children
empty GraphicsPlaceholder
array
The object has no children. You cannot set this property.
HandleVisibility
— Visibility of object handle
'on'
(default) | 'off'
| 'callback'
Visibility of the object handle in the Children
property of the
parent, specified as one of these values:
'on'
— Object handle is always visible.'off'
— Object handle is invisible at all times. This option is useful for preventing unintended changes by another function. Set theHandleVisibility
to'off'
to temporarily hide the handle during the execution of that function.'callback'
— Object handle is visible from within callbacks or functions invoked by callbacks, but not from within functions invoked from the command line. This option blocks access to the object at the command line, but permits callback functions to access it.
If the object is not listed in the Children
property of the
parent, then functions that obtain object handles by searching the object
hierarchy or querying handle properties cannot return it. Examples of such
functions include the get
, findobj
, gca
, gcf
, gco
, newplot
, cla
, clf
, and close
functions.
Hidden object handles are still valid. Set the root
ShowHiddenHandles
property to 'on'
to list all object handles regardless of their
HandleVisibility
property setting.
Identifiers
Type
— Type of graphics object
'line'
Type of graphics object, returned as 'line'
. Use this property to
find all objects of a given type within a plotting hierarchy, for example, searching for
the type using findobj
.
Tag
— Object identifier
''
(default) | character vector | string scalar
Object identifier, specified as a character vector or string scalar. You can specify a unique Tag
value to serve as an identifier for an object. When you need access to the object elsewhere in your code, you can use the findobj
function to search for the object based on the Tag
value.
UserData
— User data
[]
(default) | array
User data, specified as any MATLAB array. For example, you can specify a scalar, vector, matrix, cell array, character array, table, or structure. Use this property to store arbitrary data on an object.
If you are working in App Designer, create public or private properties in the app to share data instead of using the UserData
property. For more information, see Share Data Within App Designer Apps.
Version History
Introduced in R2020a
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)