Main Content

本页面提供的是上一版软件的文档。当前版本中已删除对应的英文页面。

caxis

设置颜色图范围

全页折叠

语法

caxis(limits)
caxis('auto')
caxis('manual')
caxis(target,___)
cl = caxis

说明

示例

caxis(limits) 设置当前坐标区的颜色图范围。limits 是 [cmin cmax] 形式的二元素向量。颜色图索引数组中小于或等于 cmin 的所有值映射到颜色图的第一行。大于或等于 cmax 的所有值映射到颜色图的最后一行。介于 cmin 和 cmax 之间的所有值以线性方式映射到颜色图的中间各行。

注意

caxis 函数只影响 CDataMapping 属性设置为 'scaled' 的图形对象，不影响使用真彩色或 CDataMapping 设置为 'direct' 的图形对象。

示例

caxis('auto') 在颜色图索引数组中的值更改时启用自动范围更新。这是默认行为。caxis auto 命令是此语法的另一种形式。

示例

caxis('manual') 禁用自动范围更新。caxis manual 命令是此语法的另一种形式。

示例

caxis(target,___) 为特定坐标区或独立可视化设置颜色图范围。指定 target 作为上述任何语法中的第一个输入参数。

示例

cl = caxis 返回当前坐标区或图的当前颜色图范围。

示例

全部折叠

打开实时脚本

绘制带有颜色栏的抛物面。

[X,Y] = meshgrid(-5:.5:5);
Z = X.^2 + Y.^2;
surf(Z);
colorbar

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

获取当前颜色范围。

lim = caxis
lim = 1×2

     0    50

将下限提高到 20。请注意，小于或等于 20 的所有 Z 值映射到第一种颜色。

caxis([20 50])

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

打开实时脚本

创建两个垂直偏移的抛物面。 

[X,Y] = meshgrid(-5:.5:5);
Z1 = X.^2 + Y.^2;
Z2 = Z1 + 50;

绘制第一个抛物面。添加颜色栏，然后保持第二个抛物面的坐标区不变。

surf(X,Y,Z1);
colorbar
hold on

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

使用 'manual' 选项保持当前颜色范围不变。然后绘制第二个抛物面。 

caxis('manual');
surf(X,Y,Z2);

Figure contains an axes object. The axes object contains 2 objects of type surface.

打开实时脚本

从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建 1×2 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。在每个坐标区中绘制一个抛物面。

[X,Y] = meshgrid(-5:1:5);
Z = X.^2 + Y.^2;
tiledlayout(1,2)

% Left plot
ax1 = nexttile;
surf(ax1,Z);

% Right plot
ax2 = nexttile;
surf(ax2,Z);

Figure contains 2 axes objects. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type surface.

将右侧坐标区的颜色下限提高到 20。

caxis(ax2,[20 50])

Figure contains 2 axes objects. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type surface.

输入参数

全部折叠

新范围，指定为 [cmin cmax] 形式的向量。cmin 的值必须小于 cmax。

数据类型： single | double

目标对象，指定为 Axes 对象、PolarAxes 对象、GeographicAxes 对象或具有 Colormap 属性的独立可视化。

输出参数

全部折叠

当前坐标区或图的当前范围，返回为 [cmin cmax] 形式的向量。

详细信息

全部折叠

颜色图索引数组

一种数组，可将图中的数据元素映射到颜色图中的特定行。MATLAB® 将索引数组作为属性存储在图形对象上。

例如，Surface 对象的 CData 属性就是一个索引数组，它将曲面上的网格点映射到颜色图中的特定行。

版本历史记录

在 R2006a 之前推出

另请参阅

主题