语法

说明

fill 函数创建彩色多边形。

fill(X,Y,C) 根据 X 和 Y 中的数据创建填充的多边形（顶点颜色由 C 指定）。C 是一个用作颜色图索引的向量或矩阵。如果 C 为行向量，length(C) 必须等于 size(X,2) 和 size(Y,2)；如果 C 为列向量，length(C) 必须等于 size(X,1) 和 size(Y,1)。必要时，fill 可将最后一个顶点与第一个顶点相连以闭合多边形。X 和 Y 的值可以是数字、日期时间、持续时间或分类值。

fill(X,Y,ColorSpec) 用 ColorSpec 指定的颜色填充多边形，指定的颜色可以是下列值之一：

fill(X1,Y1,C1,X2,Y2,C2,...) 指定多个二维填充区。

fill(...,'PropertyName',PropertyValue) 允许您为补片图形对象指定属性名称和值。

fill(ax,...) 将在由 ax 指定的坐标区而不是当前坐标区 (gca) 中创建多边形。选项 ax 可以位于前面的语法中的任何输入参数组合之前。

h = fill(...) 返回由补片对象构成的向量。

提示

如果 X 或 Y 为矩阵，另一个为元素数量与矩阵中的行数相同的列向量，则 fill 会复制列向量参数以生成所需大小的矩阵。fill 根据 X 和 Y 中的对应元素来形成顶点，并根据每列中的数据来创建一个多边形。

如果 X 或 Y 包含一个或多个 NaN 值，则 fill 不填充这些多边形。

色差的类型取决于您如何在参数列表中指定颜色。如果您使用 ColorSpec 参数指定颜色，则 fill 会通过将补片对象的 FaceColor 属性设置为对应的 RGB 三元组来生成单一着色多边形。

如果您使用 C 指定颜色，则 fill 会通过坐标区属性 CLim 指定的值来缩放 C 的元素。缩放 C 之后，C 可索引当前颜色图。

如果 C 为行向量，则 fill 会生成单一着色多边形，其中每个元素可确定 X 和 Y 矩阵各自的列定义的多边形的颜色。每个补片对象的 FaceColor 属性均设置为 'flat'。每个行元素成为第 n 个补片对象的 CData 属性值，其中 n 为 X 或 Y 中的对应列。

如果 C 为列向量或矩阵，则 fill 会使用顶点颜色的线性插值来生成具有插补颜色的多边形。它会将补片图形对象的 FaceColor 属性设置为 'interp'，并且一列中的元素将成为各自补片对象的 CData 属性值。如果 C 为列向量，则 fill 会复制该列向量以生成所需大小的矩阵。

兼容性考虑

x = datetime('01-Jan-2018') + days([0 1 1 0]);
y = [0 0 1 1];
h = fill(x,y,'red');
x2 = h.XData + 1;

x2 = h.Vertices(:,1) + 1;

ax = gca;
x2 = ruler2num(h.XData,ax.XAxis) + 1;

扩展功能

另请参阅

函数

• axis | patch | fill3 | caxis | colormap

属性

• Patch 属性