MATLAB Function Reference |

Filled two-dimensional polygons

**Syntax**

fill(X,Y,C) fill(X,Y,

`ColorSpec`

) fill(X1,Y1,C1,X2,Y2,C2,...) fill(...,'

',PropertyValue) h = fill(...)*PropertyName*

**Description**

The `fill`

function creates colored polygons.

```
fill(X,Y,C)
```

creates filled polygons from the data in `X`

and `Y`

with vertex color specified by `C`

. `C`

is a vector or matrix used as an index into the colormap. If `C`

is a row vector, `length(C)`

must equal `size(X,2)`

and `size(Y,2)`

; if `C`

is a column vector, `length(C)`

must equal `size(X,1)`

and `size(Y,1)`

. If necessary, `fill`

closes the polygon by connecting the last vertex to the first.

`fill(X,Y,`

fills two-dimensional polygons specified by

)
*ColorSpec*`X`

and `Y`

with the color specified by `ColorSpec`

.

```
fill(X1,Y1,C1,X2,Y2,C2,...)
```

specifies multiple two-dimensional filled areas.

`fill(...,'`

allows you to specify property names and values for a patch graphics object.

',PropertyValue)
*PropertyName*

```
h = fill(...)
```

returns a vector of handles to patch graphics objects, one handle per patch object.

**Remarks**

If `X`

or `Y`

is a matrix, and the other is a column vector with the same number of elements as rows in the matrix, `fill`

replicates the column vector argument to produce a matrix of the required size. `fill`

forms a vertex from corresponding elements in `X`

and `Y`

and creates one polygon from the data in each column.

The type of color shading depends on how you specify color in the argument list. If you specify color using `ColorSpec`

, `fill`

generates f*lat-shaded* polygons by setting the patch object's `FaceColor`

property to the corresponding RGB triple.

If you specify color using `C`

, `fill`

scales the elements of `C`

by the values specified by the axes property `CLim`

. After scaling `C`

, `C`

indexes the current colormap.

If `C`

is a row vector, `fill`

generates f*lat-shaded* polygons where each element determines the color of the polygon defined by the respective column of the `X`

and `Y`

matrices. Each patch object's `FaceColor`

property is set to `'flat'`

. Each row element becomes the `CData`

property value for the `n`

th* *patch object, where *n* is the corresponding column in `X`

or `Y`

.

If `C`

is a column vector or a matrix, `fill`

uses a linear interpolation of the vertex colors to generate polygons with interpolated colors. It sets the patch graphics object `FaceColor`

property to `'interp'`

and the elements in one column become the `CData`

property value for the respective patch object. If `C`

is a column vector, `fill`

replicates the column vector to produce the required sized matrix.

**Examples**

**See Also**

`axis`

, `caxis`

, `colormap`

, `ColorSpec`

, `fill3`

, `patch`

Polygons and Surfaces for related functions

filesep | fill3 |

© 1994-2005 The MathWorks, Inc.