Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

clabel

为等高线图添加高程标签

说明

示例

clabel(C,h) 为当前等高线图添加标签,将旋转文本插入每条等高线。等高线必须足够长以容纳标签,否则 clabel 无法插入标签。如果没有等高线矩阵 C,则将 C 替换为 []

示例

clabel(C,h,v) 为由向量 v 指定的等高线层级添加标签。

clabel(C,h,'manual') 为您用鼠标选择的位置添加标签。点击鼠标或按空格键可标记最接近十字准线中心的等高线。当光标位于图窗窗口中时,按 Return 键以终止标记。

t = clabel(C,h,'manual') 返回创建的文本对象。

示例

clabel(C) 使用 '+' 符号和垂直向上的文本为等高线添加标签。

clabel(C,v) 将垂直向上的标签添加到由向量 v 指定的等高线层级。

clabel(C,'manual') 在您使用鼠标选择的位置添加垂直向上的标签。点击鼠标或按空格键可标记最接近十字准线中心的等高线。当光标位于图窗窗口中时,按 Return 键以终止标记。

tl = clabel(___) 返回创建的文本和线条对象。使用上述语法中不包含等高线对象 h 的任意输入参数组合。

示例

clabel(___,Name,Value) 使用一个或多个 Name,Value 对组参数修改标签外观。使用先前语法中的任意输入参数组合。例如,'FontSize',14 将字体大小设置为 14 磅。

示例

全部折叠

创建一个等高线图并获取等高线矩阵 C 和等高线对象 h。然后,为等高线图添加标签。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);   
clabel(C,h)

Figure contains an axes. The axes contains an object of type contour.

仅为等高线层级为 2 或 6 的等高线添加标签。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
v = [2,6];
clabel(C,h,v)

Figure contains an axes. The axes contains an object of type contour.

使用 Name,Value 对组参数,将标签的字体大小设置为 15 磅并将颜色设置为红色。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
clabel(C,h,'FontSize',15,'Color','red')

Figure contains an axes. The axes contains an object of type contour.

通过重新发出 clabel 命令设置其他属性。例如,将字体粗细设置为粗体并将颜色更改为蓝色。

clabel(C,h,'FontWeight','bold','Color','blue')

Figure contains an axes. The axes contains an object of type contour.

使用 'default' 关键字将字体大小重新设置为默认大小。

clabel(C,h,'FontSize','default')

Figure contains an axes. The axes contains an object of type contour.

创建一个等高线图并返回等高线矩阵 C。然后,为等高线添加标签。

[x,y,z] = peaks;
C = contour(x,y,z);  
clabel(C)

Figure contains an axes. The axes contains 25 objects of type contour, line, text.

输入参数

全部折叠

contourcontour3contourf 函数返回的等高线矩阵。C 包含用于定义等高线的数据。有关等高线矩阵的详细信息,请参阅 ContourMatrix

注意

如果您将等高线对象 h 传递到 clabel 函数,则可以将 C 替换为 []。例如,使用 clabel([],h)

contourcontour3contourf 函数返回的等高线对象。

等高线层级值,指定为由单个值组成的一个行或列向量。

示例: [0 10 20]

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: clabel(C,h,'Color','red','FontSize',12) 指定红色的 12 磅标签。

clabel 支持 LabelSpacing 属性以及一部分文本属性。

各标签之间的间距,指定为以磅为单位的标量值。

注意

将此选项与 clabel(C,h)clabel(C,h,v) 语法结合使用。其他语法不支持此选项。

示例: clabel(C,h,'LabelSpacing',100)

文本颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0 0 0] 对应于黑色。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

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

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

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

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

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[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'

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

文本框轮廓的颜色,指定为 'none'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

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

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

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

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

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[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'

示例: clabel(C,h,'EdgeColor','k')

文本框背景色,指定为 'none'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

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

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

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

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

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[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'

示例: clabel(C,h,'BackgroundColor','g')

字体大小,指定为大于 0 的标量值。默认情况下,字体大小使用磅为单位。一磅等于 1/72 英寸。但是,某些语法允许您使用 FontUnits 属性更改字体单位。

示例: clabel(C,h,'FontSize',15)

字体名称,指定为支持的字体名称或 'FixedWidth'。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 'FixedWidth'。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

字符倾斜,指定为 'normal''italic'

并非所有字体都有两种字体样式。因此,斜体可能看上去和常规字体一样。

字符粗细,指定为 'normal''bold'

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此,指定加粗字体仍可能得到普通字体。

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

  • 'on' - 应用字体平滑处理。减少文本字符中出现参差不齐,使文本更易于读取。

  • 'off' - 不应用字体平滑处理。

示例: clabel(C,h,'FontSmoothing','on')

字体大小单位,指定为此表中的一个值。

Units说明
'points'磅。一磅等于 1/72 英寸。
'inches'英寸。
'centimeters'厘米。
'characters'

基于默认系统字体的字符大小。

  • 字符宽度 = 字母 x 的宽度。

  • 字符高度 = 两个文本行的基线之间的距离。

'normalized' 按坐标区高度的一定比例来解释字体大小。如果您调整坐标区的大小,则字体大小也会相应地修改。例如,如果 FontSize0.1(归一化单位),则文本为坐标区高度的 1/10。
'pixels'

像素。

从 R2015b 开始,以像素为单位的距离不再依赖 Windows®Macintosh 系统上的系统分辨率:

  • 在 Windows 系统上,一个像素是 1/96 英寸。

  • Macintosh 系统上,一个像素是 1/72 英寸。

在 Linux® 系统上,一个像素的大小由系统分辨率确定。

如果在一次函数调用中同时设置字体大小和字体单位,必须先设置 FontUnits 属性以使坐标区能正确解释指定的字体大小。

注意

clabel(C,h)clabel(C,h,v) 语法不支持此选项。它们始终使用默认磅值。

示例: clabel(C,'FontUnits','normalized')

文本方向,指定为以度为单位的标量值。默认的 0 度旋转可使文本处于水平。对于垂直文本,请将此属性设置为 90-90。设置为正值可逆时针旋转文本。设置为负值可顺时针旋转文本。

注意

clabel(C,h)clabel(C,h,v) 语法不支持此选项。它们是将旋转文本插入等高线,每个标签都旋转以匹配相应线条局部的走向。

示例: clabel(C,'Rotation',90)

文本字符的解释,指定为下列值之一:

  • 'tex' - 使用 TeX 标记显示文本。

  • 'latex' - 使用 LaTeX 标记显示文本。

  • 'none' - 显示字面字符。

由于标签是数值文本,此属性的效果仅限于字体样式和粗细的细微更改。

示例: clabel(C,h,'Interpreter','latex')

文本框轮廓的线型,指定为此表中的线型之一。

线型说明表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

示例: clabel(C,h,'LineStyle','--')

文本框轮廓的宽度,指定为标量值(以磅为单位)。一磅等于 1/72 英寸。

示例: clabel(C,h,'LineWidth',1)

文本框中文本周围的空间,指定为标量值(以磅为单位)。

MATLAB 使用 Extent 属性值以及 Margin 属性值来确定文本框的大小。

示例: clabel(C,h,'Margin',4)

输出参数

全部折叠

文本对象,以向量形式返回。文本对象的 String 属性包含所显示的等高线值。

文本和线条对象,以向量形式返回。文本对象的 String 属性包含所显示的等高线值。线条对象对应于 '+' 符号。

扩展功能

另请参阅

函数

属性

在 R2006a 之前推出