Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

clim

设置颜色图范围(在 R2022a 中从 caxis 更名为现名称)

    说明

    示例

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

    注意

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

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

    示例

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

    示例

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

    示例

    lims = clim[cmin cmax] 形式的向量返回当前的颜色图范围。

    示例

    全部折叠

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

    [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.

    获取当前颜色范围。

    lims = clim
    lims = 1×2
    
         0    50
    
    

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

    clim([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" 选项保持当前颜色范围不变。然后绘制第二个抛物面。

    clim("manual");
    surf(X,Y,Z2);

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

    调用 tiledlayout 函数以创建 1×2 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1ax2。在每个坐标区中绘制一个抛物面。

    [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

    clim(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 属性的独立可视化。

    详细信息

    全部折叠

    颜色图索引数组

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

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

    版本历史记录

    在 R2006a 之前推出

    全部展开