fill3

Purpose

Filled 3-D polygons in 3-space.

Synopsis

fill3(X,Y,Z,C)
fill3(X1,Y1,Z1,C1,X2,Y2,Z2,C2,...)

Description

fill3(X,Y,Z,C) fills the three-dimensional polygon defined by vectors X, Y, and Z with the color specified by C. The vertices of the polygon are specified by triples of components of X, Y, and Z. If necessary, the polygon is closed by connecting the last vertex to the first.

If C is a single character string chosen from the list 'r','g','b', 'c','m','y','w','k', or a red-green-blue row vector triple, [r g b], the polygon is filled with the constant specified color.

If C is a vector the same length as X, Y, and Z, its elements are scaled by caxis and used as indices into the current colormap to specify colors at the vertices; the color within the polygon is obtained by bilinear interpolation in the vertex colors.

If X, Y, and Z are matrices the same size, fill3(X,Y,Z,C) draws one polygon per column. In this case, C is a row vector for flat polygon colors, and C is a matrix for interpolated polygon colors.

If any one of X, Y, or Z is a matrix, and the others are column vectors with the same number of rows, the column vector arguments are replicated to produce matrices of the required size.

fill3(X1,Y1,Z1,C1,X2,Y2,Z2,C2,...) is another way of specifying multiple filled areas.

fill3 sets the patch object FaceColor property to flat, interp, or a ColorSpec depending upon the value of the C matrix.

fill3 returns a column vector of handles to patch objects, one handle per patch. The X, Y, Z, C parameters can be followed by parameter/value pairs to specify additional properties of the patches.

Examples

Fill four random triangles with color.

colormap(cool)
fill3(rand(3,4),rand(3,4),rand(3,4),rand(3,4))

See Also

colormap, fill, patch

(c) Copyright 1994 by The MathWorks, Inc.