主要内容

Baseline 属性

基线的外观和行为

Baseline 对象作为条形图、区域图和针状图的一部分创建。Baseline 属性控制 Baseline 对象的外观和行为。通过更改属性值,您可以修改该基线的特定方面。使用圆点表示法引用特定的对象和属性:

b = bar(1:10);
bl = b.BaseLine;
c = bl.Color;
bl.Color = 'red';

外观

全部展开

线条颜色,指定为 'none'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。如果将颜色指定为 'none',则基线不可见。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"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

下表列出了浅色和深色主题中绘图的默认调色板。

调色板调色板颜色

"gem" - 浅色主题默认值

在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

您可以使用 orderedcolorsrgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

线型,指定为下表中列出的线型之一。

线型描述表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

线条宽度,指定为以磅为单位的正值。

示例: 0.75

位置和可见性

全部展开

基线的值,指定为标量。

通常,基线与条形序列、针状序列或区域对象关联。关联对象的 BaseValue 属性以及基线对象的 BaseValue 属性始终具有相同的值。设置一个属性会同时设置另一个属性。关联对象的 BaseLine 属性包含基线对象。

示例: 0.75

可见性,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 显示基准。

  • 'off' - 隐藏基准而不删除它。您可以访问不可见基准的属性。

通常,基线与条形序列、针状序列或区域对象关联。关联对象的 ShowBaseline 属性以及基线对象的 Visible 属性始终具有相同的值。设置一个属性会同时设置另一个属性。关联对象的 BaseLine 属性包含基线对象。

父级/子级

全部展开

父级,以 Axes 对象形式返回。但 Baseline 对象不会作为坐标区的子级而列出。

基准没有任何子级。您不能设置该属性。

版本历史记录

在 R2014b 中推出