Main Content

colororder

设置或查询色序调色板

自 R2019b 起

全页折叠

语法

colororder(colorarray)
colororder(palettename)
colororder(target,___)
C = colororder
C = colororder(target)

说明

设置颜色

示例

colororder(colorarray) 为当前图窗的色序设置调色板。色序控制 MATLAB® 用来在坐标区内绘制多个数据序列时所用的颜色的排序。

将 colorarray 指定为 RGB 三元组矩阵或颜色名称数组，如 ["red" "green" "blue"]。如果图窗不存在，MATLAB 会创建一个图窗并为该图窗设置调色板。当您为图窗设置调色板时，会为该图窗中的所有坐标区设置调色板。

示例

colororder(palettename) 将颜色指定为预定义调色板名称之一，例如 "gem"、"glow" 或 "sail"。 (自 R2023b 起)

示例

colororder(target,___) 为目标图窗、坐标区或图（而不是当前图窗）设置调色板。

获取颜色

C = colororder 返回当前图窗的颜色矩阵。

示例

C = colororder(target) 返回目标图窗、坐标区或图的颜色矩阵。

示例

全部折叠

打开实时脚本

将图窗的色序设置为四种颜色。定义一个 x 坐标向量和四个 y 坐标向量。然后绘制每组坐标。 

newcolors = [0.83 0.14 0.14
             1.00 0.54 0.00
             0.47 0.25 0.80
             0.25 0.80 0.54];
         
colororder(newcolors)

% Define coordinates
x = linspace(0,10);
y1 = sin(x);
y2 = sin(x-0.5);
y3 = sin(x-1);
y4 = sin(x-1.5);

% Plot coordinates
plot(x,y1,'LineWidth',2)
hold on
plot(x,y2,'LineWidth',2)
plot(x,y3,'LineWidth',2)
plot(x,y4,'LineWidth',2)
hold off

打开实时脚本

创建一个由 x 坐标组成的向量和一个由 y 坐标组成的矩阵。然后绘制坐标。

x = [1 2];
y = [0 1 2 3; 1 2 3 4];
plot(x,y,"LineWidth",2)

通过向 colororder 函数传递四个十六进制颜色代码来更改绘图的颜色。

newcolors = ["#0B0" "#00F" "#50F" "#A0F"];
colororder(newcolors)

您也可以指定几个命名的调色板之一。将颜色更改为名为 sail 的调色板。

colororder("sail")

打开实时脚本

显示三个条形序列。然后将色序设置为蓝色、紫色和灰色。 

bar([10 20 30; 25 35 45; 30 40 52])
newcolors = [0 0.5 1; 0.5 0 1; 0.7 0.7 0.7];
colororder(newcolors)

打开实时脚本

在调用 yyaxis 之前设置图窗的色序会为每个 y 轴设置颜色。左侧使用第一种颜色，右侧使用第二种颜色。如果指定两种以上的颜色，则任一侧都不会使用多余的颜色。

将 newcolors 定义为包含两个 RGB 三元组的矩阵。设置图窗的色序，并基于左侧绘制两条线。然后基于右侧绘制两条线。

newcolors = [0.40 0.30 0.90; 0.50 0.65 0.15];
colororder(newcolors)

% Left side
yyaxis left
plot([1 2; 3 4])

% Right side
yyaxis right
plot([4 3; 2 1])

打开实时脚本

在调用 yyaxis 之后设置图窗的色序会为活动侧设置颜色。

激活左侧 y 轴并绘制三条线。将线型序列设置为实线，并将左侧 y 轴颜色更改为蓝色。然后将色序设置为三个蓝色梯度。

% Left side
yyaxis left
plot([1 2 3; 4 5 6])
ax = gca;
ax.LineStyleOrder = '-';
ax.YColor = 'blue';
leftcolors = [0 0 1; 0 0.50 1; 0 0.80 1];
colororder(leftcolors)

激活右侧 y 轴并绘制两条线。将右侧 y 轴颜色更改为黑色。然后将色序设置为黑色。

% Right side
yyaxis right
plot([4 3; 2 1])
ax.YColor = 'black';
colororder('black')

打开实时脚本

当使用颜色参量调用绘图函数时，绘图函数会使用该颜色，而不是使用色序中的下一种颜色。

将图窗的色序设置为红色、品红色和蓝色。调用 scatter 函数以绘制一组散点。然后绘制第二组散点，并将标记指定为黑色星号。 

newcolors = {'red','magenta','blue'};
colororder(newcolors)
scatter(1:10,rand(1,10),'filled')
hold on
scatter(1:10,rand(1,10),'*k')

绘制第三组散点，不指定标记颜色。请注意，这组散点使用色序中的第三个颜色，即蓝色。

scatter(1:10,rand(1,10),'filled')
hold off

打开实时脚本

创建分块图布局，并在第一个图块中绘制三条线。 

tiledlayout('flow')
nexttile
plot([1 2 3; 4 5 6],'LineWidth',2)

带返回参量调用 nexttile 函数，以获取第二个图块的坐标区对象。在第二个图块中绘制三条线。然后获取坐标区的色序矩阵，并在 C 中返回输出。将 C 中的第一种颜色更改为紫色，并将坐标区色序设置为修改后的 C 矩阵。

ax = nexttile;
plot(ax,[4 5 6; 1 2 3],'LineWidth',2)
C = colororder(ax);
C(1,:) = [0.5 0 1];
colororder(ax,C)

自 R2023b 起

打开实时脚本

使用命名的调色板可以方便地更改图的颜色。此示例比较分块图布局中的四个不同调色板。

通过调用 nexttile 函数创建包含一个坐标区对象的分块图布局。然后使用默认调色板 gem 创建一个随机数条形图。

nexttile
bar(rand(3,5))
title("gem")

使用 reef、meadow 和 earth 调色板创建另外三个条形图。要指定不同坐标区的颜色，您必须将坐标区对象传递给 colororder 函数。要获取坐标区对象，请在调用 nexttile 时指定输出参量。

ax2 = nexttile;
bar(rand(3,5))
colororder(ax2,"reef")
title("reef")

ax3 = nexttile;
bar(rand(3,5))
colororder(ax3,"meadow")
title("meadow")

ax4 = nexttile;
bar(rand(3,5))
colororder(ax4,"earth")
title("earth")

输入参数

全部折叠

颜色数组，指定为一个 RGB 三元组矩阵、一个颜色名称数组。

RGB 三元组矩阵

指定一个 m×3 矩阵，其中每行都是一个 RGB 三元组。RGB 三元组是一个三元素向量，包含颜色的红、绿和蓝分量的强度。强度必须处于范围 [0,1] 中。例如，以下矩阵将新颜色定义为蓝色、深绿色和橙色：

colorarray = [1.0 0.0 0.0
             0.0 0.4 0.0
             1.0 0.5 0.0];

由颜色名称或十六进制颜色代码组成的数组

指定颜色名称、短名称或十六进制颜色代码的任意组合。

  • 要指定一种颜色，请将 colorarray 设置为字符向量或字符串标量。例如，colorarray = 'red' 将红色指定为色序中的唯一颜色。

  • 要指定多种颜色，请将 colorarray 设置为字符向量元胞数组或字符串数组。例如，colorarray = {'red','green','blue'} 将颜色指定为红色、绿色和蓝色。

十六进制颜色代码以井号 (#) 开头，后跟三个或六个 0 到 F 范围内的十六进制数字。这些值不区分大小写。因此，颜色代码 '#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

数据类型: single | double | char | cell | string

自 R2023b 起

预定义的调色板名称，指定为下表中的值之一或 "default"（与 "gem" 相同）。

调色板名称调色板颜色

"gem"

Sample of the "gem" color palette

"gem12"

Sample of the "gem12" color palette

"glow"

Sample of the "glow" color palette

"glow12"

Sample of "glow12" color palette

"sail"

Sample of the "sail" color palette

"reef"

Sample of the "reef" color palette

"meadow"

Sample of the "meadow" color palette

"dye"

Sample of the "dye" color palette

"earth"

Sample of the "earth" color palette

目标，指定为下列值之一：

提示

  • 如果您为图窗设置了色序，则在您调用绘图函数时颜色保持不变。但是，如果将坐标区对象传递给 colororder 函数，您必须首先调用 hold on 才能使颜色在您调用绘图函数时保持不变。

  • 如果对坐标区设置了 ColorOrderIndex 或 LineStyleOrderIndex 属性，新色序不会影响现有绘图。只有在您调用 hold on 然后调用绘图函数之后，新颜色才会生效。

版本历史记录

在 R2019b 中推出

全部展开

另请参阅

函数

属性

主题