clabel

为等高线图添加高程标签

语法

clabel(C,h)

clabel(C,h,v)

clabel(C,h,'manual')

t = clabel(C,h,'manual')

clabel(C)

clabel(C,v)

clabel(C,'manual')

tl = clabel(___)

clabel(___,Name,Value)

说明

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 object. The axes object 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 object. The axes object 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 object. The axes object contains an object of type contour.

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

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

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

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

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

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

使用垂直文本为等高线图添加标签

打开实时脚本

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

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

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

输入参数

`C` — 等高线矩阵
二行矩阵

contour、contour3 或 contourf 函数返回的等高线矩阵。C 包含用于定义等高线的数据。有关等高线矩阵的详细信息，请参阅 ContourMatrix。

注意

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

`h` — 等高线对象
等高线对象

contour、contour3 或 contourf 函数返回的等高线对象。

`v` — 等高线层级值
向量

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

示例: [0 10 20]

名称-值参数

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

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

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

`LabelSpacing` — 标签间距
标量

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

注意

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

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

`Color` — 文本颜色
RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

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

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

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#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"`	不适用	不适用	不适用	无颜色

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

调色板调色板颜色

"gem" - 浅色主题默认值

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

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 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'

`EdgeColor` — 文本框轮廓的颜色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

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

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

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#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"`	不适用	不适用	不适用	无颜色

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

调色板调色板颜色

"gem" - 浅色主题默认值

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

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

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

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

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

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

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

`BackgroundColor` — 背景色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

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

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

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#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"`	不适用	不适用	不适用	无颜色

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

调色板调色板颜色

"gem" - 浅色主题默认值

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

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

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

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

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

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

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

`FontSize` — 字体大小
`10` (默认) | 大于 0 的标量值

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

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

`FontName` — 字体名称
支持的字体名称 | `"FixedWidth"`

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

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

`FontAngle` — 字符倾斜
`'normal'` (默认) | `'italic'`

字符倾斜，指定为 'normal' 或 'italic'。

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

`FontWeight` — 字符粗细
`'normal'` (默认) | `'bold'`

字符粗细，指定为 'normal' 或 'bold'。

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

`FontUnits` — 字体大小单位
`'points'` (默认) | `'inches'` | `'centimeters'` | `'characters'` | `'normalized'` | `'pixels'`

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

`Units`	描述
`'points'`	磅。一磅等于 1/72 英寸。
`'inches'`	英寸。
`'centimeters'`	厘米。
`'characters'`	基于默认系统字体的字符大小。字符宽度 = 字母 `x` 的宽度。字符高度 = 两个文本行的基线之间的距离。
`'normalized'`	按坐标区高度的一定比例来解释字体大小。如果您调整坐标区的大小，则字体大小也会相应地修改。例如，如果 `FontSize` 为 `0.1`（归一化单位），则文本为坐标区高度的 1/10。
`'pixels'`	像素。在 Windows^® 和 Macintosh 系统上，像素的大小为 1/96 英寸。此大小与系统分辨率无关。在 Linux^® 系统上，一个像素的大小由系统分辨率确定。

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

注意

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

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

`Rotation` — 文本方向
`0` (默认) | 标量

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

注意

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

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

`Interpreter` — 文本字符的解释
`'tex'` (默认) | `'latex'` | `'none'`

文本字符的解释，指定为下列值之一：

'tex' - 使用 TeX 标记显示文本。
'latex' - 使用 LaTeX 标记显示文本。
'none' - 显示字面字符。

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

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

`LineStyle` — 文本框轮廓的线型
`'-'` (默认) | `'--'` | `':'` | `'-.'` | `'none'`

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

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线
`"none"`	无线条	无线条

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

`LineWidth` — 文本框轮廓的宽度
`0.5` (默认) | 标量

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

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

`Margin` — 文本框中文本周围的空间
`3` (默认) | 标量

文本框中文本周围的空间，指定为标量值（以磅为单位）。

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

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

输出参量

`t` — 文本对象
向量

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

`tl` — 文本和线条对象
向量

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

扩展功能

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

clabel 函数支持 GPU 数组输入，但有以下用法说明和限制：

此函数接受 GPU 数组，但不在 GPU 上运行。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

用法说明和限制：

此函数在分布式数组上运行，但在客户端 MATLAB 中执行。

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

R2025a: `FontSmoothing` 属性不起作用

FontSmoothing 属性不起作用，将在以后的版本中删除。您可以设置或获取此属性的值而不发出警告，但无论属性值如何，所有文本都是平滑的。此属性删除已在 R2022a 中声明。

R2023b: 设置 `Color` 名称-值参量还会设置 `Contour` 对象的 `LabelColor`

如果在调用 clabel 函数时设置 Color 名称-值参量，则 Contour 对象的 LabelColor 属性将更新为指定的颜色值。

另请参阅

函数

contour | contourc | contourf | contour3

属性

Text 属性