fill3

Create filled 3-D patches

collapse all in page

Syntax

fill3(X,Y,Z,C)

fill3(X1,Y1,Z1,C1,...,Xn,Yn,Zn,Cn)

fill3(___,Name,Value)

fill3(ax,___)

p = fill3(___)

Description

fill3(X,Y,Z,C) plots filled polygonal regions on 3-D axes as Patch objects with vertices at the (x,y,z) locations specified by X, Y, and Z.

To plot one region, specify X, Y, and Z as vectors.
To plot multiple regions, specify X, Y, and Z as matrices where each column corresponds to a polygon.

C determines the fill colors for the regions.

example

fill3(X1,Y1,Z1,C1,...,Xn,Yn,Zn,Cn) plots multiple filled polygonal regions on the same 3-D axes.

example

fill3(___,Name,Value) modifies the Patch objects using one or more name-value arguments to set properties. Patches can be specified using any of the input argument combinations in previous syntaxes. For example, fill3(X,Y,Z,C,'LineWidth',2) specifies a two-point border around all the patches. For a list of properties, see Patch Properties.

fill3(ax,___) plots the polygonal regions in the axes specified by ax instead of in the current axes (gca).

p = fill3(___) returns a Patch object or a vector of Patch objects. Use p to query and modify properties after plotting a region. For a full list of properties, see Patch Properties.

example

Examples

collapse all

Create Filled Triangle in 3-D Axes

Open Live Script

Specify vectors x, y, and z as the (x,y,z) coordinates of the vertices for a triangle. Then plot the triangle with the specified fill color, red.

x = [0 0 0];
y = [0 2 1];
z = [0 0 2];
fill3(x,y,z,'r')

Figure contains an axes object. The axes object contains an object of type patch.

Specify Custom Fill Colors

Open Live Script

Define vectors x1, y1, z1 and x2, y2, z2 as the (x,y,z) coordinates of the vertices for two rectangles. Specify the color of each rectangle as an RGB triplet, with values dictating the intensities of the red, green, and blue components of the color. Plot both rectangles in a single fill3 call.

x1 = [0 0 1 1];
y1 = [3 3 2 2];
z1 = [0 3 2 1];
c1 = [0 0.447 0.741];
x2 = [2 2 3 3];
y2 = [1 1 0 0];
z2 = [1 2 3 0];
c2 = [0.850 0.325 0.098];
fill3(x1,y1,z1,c1,x2,y2,z2,c2)

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

Interpolate Fill Color from Vertices

Open Live Script

Specify matrices x, y, and z as the coordinates of the vertices for three adjacent squares. Specify c as a matrix of the same dimensions as x, y, and z. Each value in c specifies a colormap index for the corresponding vertex. The fill3 function interpolates the fill color of each square from the vertex colors.

x = [0 0 0; 0 0 2; 0 2 2; 0 2 0];
y = [2 0 2; 0 0 2; 0 0 0; 2 0 0];
z = [2 0 2; 2 2 2; 0 2 2; 0 0 2];
c = [2 2 2; 3 3 0; 2 2 2; 0 0 3];
fill3(x,y,z,c)

Figure contains an axes object. The axes object contains 3 objects of type patch.

Modify Patches After Creation

Open Live Script

Plot two triangles with fill colors specified by vector c of colormap indices. Store the two returned patches in vector p.

x = [0 1; 1.5 2.5; 3 4];
y = [4 4; 2.5 2.5; 1 1];
z = [0 0; 2 2; 0 0];
c = [1 0];
p = fill3(x,y,z,c);

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

Use p to modify the first triangle. Modify the FaceAlpha property of the first element of p to make the first triangle transparent.

p(1).FaceAlpha = 0.5;

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

Input Arguments

collapse all

`X` — x-coordinates of patch vertices
vector | matrix

x-coordinates of the patch vertices, specified as a vector or matrix.

Number of Patches Description Example

Number of Patches	Description	Example
One patch	Specify `X`, `Y`, and `Z` as vectors of the same length. The vectors can have any orientation.	Plot one triangular patch. X = [0 0 4]; Y = [2 4 2]; Z = [1 1 1]; C = 1; fill3(X,Y,Z,C)
Two or more patches (shared `X`, `Y`, or `Z`)	Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB^® plots the columns of the matrices against the vector.	Plot two triangular patches with shared x- and z-coordinates. X = [0 0 4]; Y = [0 -0; 2 -2; 0 0]; Z = [0 0 0]; C = [0 1]; fill3(X,Y,Z,C)
Two or more patches (`X`, `Y`, and `Z` are unique)	Specify `X`, `Y`, and `Z` as matrices of the same size. MATLAB plots the corresponding columns of the matrices.	Plot two triangular patches with unique x-, y- and z-coordinates. X = [0 5; 0 5; 4 9]; Y = [2 0; 4 2; 2 0]; Z = [0 1; 2 3; 1 2]; C = [0 1]; fill3(X,Y,Z,C)

One patch

Specify X, Y, and Z as vectors of the same length. The vectors can have any orientation.

Plot one triangular patch.

X = [0 0 4];
Y = [2 4 2];
Z = [1 1 1];
C = 1;
fill3(X,Y,Z,C)

Two or more patches
(shared X, Y, or Z)

Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB^® plots the columns of the matrices against the vector.

Plot two triangular patches with shared x- and z-coordinates.

X = [0 0 4];
Y = [0 -0; 2 -2; 0 0];
Z = [0 0 0];
C = [0 1];
fill3(X,Y,Z,C)

Two or more patches
(X, Y, and Z are unique)

Specify X, Y, and Z as matrices of the same size. MATLAB plots the corresponding columns of the matrices.

Plot two triangular patches with unique x-, y- and z-coordinates.

X = [0 5; 0 5; 4 9];
Y = [2 0; 4 2; 2 0];
Z = [0 1; 2 3; 1 2];
C = [0 1];
fill3(X,Y,Z,C)

If the data does not define closed regions, then fill3 closes the regions.

`Y` — y-coordinates of patch vertices
vector | matrix

y-coordinates of the patch vertices, specified as a vector or matrix.

Number of Patches Description Example

Number of Patches	Description	Example
One patch	Specify `X`, `Y`, and `Z` as vectors of the same length. The vectors can have any orientation.	Plot one triangular patch. X = [0 0 4]; Y = [2 4 2]; Z = [1 1 1]; C = 1; fill3(X,Y,Z,C)
Two or more patches (shared `X`, `Y`, or `Z`)	Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB plots the columns of the matrices against the vector.	Plot two triangular patches with shared x- and z-coordinates. X = [0 0 4]; Y = [0 -0; 2 -2; 0 0]; Z = [0 0 0]; C = [0 1]; fill3(X,Y,Z,C)
Two or more patches (`X`, `Y`, and `Z` are unique)	Specify `X`, `Y`, and `Z` as matrices of the same size. MATLAB Plots the corresponding columns of the matrices.	Plot two triangular patches with unique x-, y- and z-coordinates. X = [0 5; 0 5; 4 9]; Y = [2 0; 4 2; 2 0]; Z = [0 1; 2 3; 1 2]; C = [0 1]; fill3(X,Y,Z,C)

One patch

Specify X, Y, and Z as vectors of the same length. The vectors can have any orientation.

Plot one triangular patch.

X = [0 0 4];
Y = [2 4 2];
Z = [1 1 1];
C = 1;
fill3(X,Y,Z,C)

Two or more patches
(shared X, Y, or Z)

Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB plots the columns of the matrices against the vector.

Plot two triangular patches with shared x- and z-coordinates.

X = [0 0 4];
Y = [0 -0; 2 -2; 0 0];
Z = [0 0 0];
C = [0 1];
fill3(X,Y,Z,C)

Two or more patches
(X, Y, and Z are unique)

Specify X, Y, and Z as matrices of the same size. MATLAB Plots the corresponding columns of the matrices.

Plot two triangular patches with unique x-, y- and z-coordinates.

X = [0 5; 0 5; 4 9];
Y = [2 0; 4 2; 2 0];
Z = [0 1; 2 3; 1 2];
C = [0 1];
fill3(X,Y,Z,C)

If the data does not define closed regions, then fill3 closes the regions.

`Z` — z-coordinates of patch vertices
vector | matrix

z-coordinates of the patch vertices, specified as a vector or matrix.

Number of Patches Description Example

Number of Patches	Description	Example
One patch	Specify `X`, `Y`, and `Z` as vectors of the same length. The vectors can have any orientation.	Plot one triangular patch. X = [0 0 4]; Y = [2 4 2]; Z = [1 1 1]; C = 1; fill3(X,Y,Z,C)
Two or more patches (shared `X`, `Y`, or `Z`)	Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB plots the columns of the matrices against the vector.	Plot two triangular patches with shared x- and z-coordinates. X = [0 0 4]; Y = [0 -0; 2 -2; 0 0]; Z = [0 0 0]; C = [0 1]; fill3(X,Y,Z,C)
Two or more patches (`X`, `Y`, and `Z` are unique)	Specify `X`, `Y`, and `Z` as matrices of the same size. MATLAB Plots the corresponding columns of the matrices.	Plot two triangular patches with unique x-, y- and z-coordinates. X = [0 5; 0 5; 4 9]; Y = [2 0; 4 2; 2 0]; Z = [0 1; 2 3; 1 2]; C = [0 1]; fill3(X,Y,Z,C)

One patch

Specify X, Y, and Z as vectors of the same length. The vectors can have any orientation.

Plot one triangular patch.

X = [0 0 4];
Y = [2 4 2];
Z = [1 1 1];
C = 1;
fill3(X,Y,Z,C)

Two or more patches
(shared X, Y, or Z)

Specify the shared coordinates as a vector. Specify the other coordinates as matrices. The length of the vector must match the length of one dimension of the matrix. If the matrix is square, MATLAB plots the columns of the matrices against the vector.

Plot two triangular patches with shared x- and z-coordinates.

X = [0 0 4];
Y = [0 -0; 2 -2; 0 0];
Z = [0 0 0];
C = [0 1];
fill3(X,Y,Z,C)

Two or more patches
(X, Y, and Z are unique)

Specify X, Y, and Z as matrices of the same size. MATLAB Plots the corresponding columns of the matrices.

Plot two triangular patches with unique x-, y- and z-coordinates.

X = [0 5; 0 5; 4 9];
Y = [2 0; 4 2; 2 0];
Z = [0 1; 2 3; 1 2];
C = [0 1];
fill3(X,Y,Z,C)

If the data does not define closed regions, then fill3 closes the regions.

`C` — Patch colors
color name | RGB triplet | vector of colormap indices | matrix of colormap indices | ...

Patch colors, specified as a color name, RGB triplet, vector of colormap indices, or a matrix of colormap indices.

Color name — A color name such as 'red', or a short name such as 'r'.
RGB triplet — A three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7]. RGB triplets are useful for creating custom colors.
Vector of colormap indices — A vector of numeric values that has one element for each region.
Matrix of colormap indices — A matrix of numeric values that has the same dimensions as X, Y, and Z.

The way you specify the color depends on the color scheme and whether you are plotting one polygonal region or multiple regions. This table describes the most common situations.

Color Scheme How to Specify the Color Example

Single color for all regions

Color Scheme	How to Specify the Color	Example
Single color for all regions	Specify a color name or a short name from the table below, or specify one RGB triplet.	Create matrices `x`, `y`, and `z`. Then plot the filled region in red. x = [0.5 0; 0.5 0; 1 1]; y = [0 2; 2 6; 1 4]; z = [0 0; 0 0; 1 2]; fill3(x,y,z,'r')
One color per region	Specify an n-by-1 or 1-by-n vector of colormap indices, where `n` is the number of polygonal regions.	Create matrices `x`, `y`, and `z` and vector `c`. Then plot the filled region in the specified colormap colors. x = [0.5 0; 0.5 0; 1 1]; y = [0 2; 2 6; 1 4]; z = [0 0; 0 0; 1 2]; c = [1 0]; fill3(x,y,z,c)
Interpolated face colors	Specify an m-by-n matrix of colormap indices, where `[m,n] = size(X)`. Specify one color per vertex.	Create matrices `x`, `y`, `z` and `c`. Then plot the filled region with fill color interpolated from vertex colors `c`. x = [0.5 0; 0.5 0; 1 1]; y = [0 2; 2 6; 1 4]; z = [0 0; 0 0; 1 2]; c = [1 1; 1 0.5; 0 0]; fill3(x,y,z,c)

Specify a color name or a short name from the table below, or specify one RGB triplet.

Create matrices x, y, and z. Then plot the filled region in red.

x = [0.5 0; 0.5 0; 1 1];
y = [0 2; 2 6; 1 4];
z = [0 0; 0 0; 1 2];
fill3(x,y,z,'r')

3-D plot with two red triangles

One color per region

Specify an n-by-1 or 1-by-n vector of colormap indices, where n is the number of polygonal regions.

Create matrices x, y, and z and vector c. Then plot the filled region in the specified colormap colors.

x = [0.5 0; 0.5 0; 1 1];
y = [0 2; 2 6; 1 4];
z = [0 0; 0 0; 1 2];
c = [1 0];
fill3(x,y,z,c)

3-D plot with one blue and one yellow triangle

Interpolated face colors

Specify an m-by-n matrix of colormap indices, where [m,n] = size(X). Specify one color per vertex.

Create matrices x, y, z and c. Then plot the filled region with fill color interpolated from vertex colors c.

x = [0.5 0; 0.5 0; 1 1];
y = [0 2; 2 6; 1 4];
z = [0 0; 0 0; 1 2];
c = [1 1; 1 0.5; 0 0];
fill3(x,y,z,c)

3-D plot with two triangles filled with a yellow, green, and blue gradient

Color Names and RGB Triplets for Common Colors

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

`ax` — Target axes
`Axes` object

Target axes, specified as an Axes object. If you do not specify the axes, the fill3 function plots into the current axes or creates an Axes object if one does not exist.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: fill3(x,y,z,c,'FaceAlpha',.5,'LineStyle',':') creates semitransparent polygons with dotted edges.

Note

The properties listed here are only a subset of patch properties. For a complete list, see Patch Properties.

`FaceColor` — Face color
`[0 0 0]` (default) | `'interp'` | `'flat'` | RGB triplet | hexadecimal color code | `'r'` | `'g'` | `'b'` | ...

Face color, specified as 'interp', 'flat' an RGB triplet, a hexadecimal color code, a color name, or a short name.

To create a different color for each face, specify the CData or FaceVertexCData property as an array containing one color per face or one color per vertex. The colors can be interpolated from the colors of the surrounding vertices of each face, or they can be uniform. For interpolated colors, specify this property as 'interp'. For uniform colors, specify this property as 'flat'. If you specify 'flat' and a different color for each vertex, the color of the first vertex you specify determines the face color.

To designate a single color for all of the faces, specify this property as an RGB triplet, a hexadecimal color code, a color name, or a short name.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7].
A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Thus, the color codes '#FF8800', '#ff8800', '#F80', and '#f80' are equivalent.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`
`"none"`	Not applicable	Not applicable	Not applicable	No color

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

`FaceAlpha` — Face transparency
1 (default) | scalar in range `[0,1]` | `'flat'` | `'interp'`

Face transparency, specified as one of these values:

Scalar in range [0,1] — Use uniform transparency across all of the faces. A value of 1 is fully opaque and 0 is completely transparent. This option does not use the transparency values in the FaceVertexAlphaData property.
'flat' — Use a different transparency for each face based on the values in the FaceVertexAlphaData property. First you must specify the FaceVertexAlphaData property as a vector containing one transparency value per face or vertex. The transparency value at the first vertex determines the transparency for the entire face.
'interp' — Use interpolated transparency for each face based on the values in FaceVertexAlphaData property. First you must specify the FaceVertexAlphaData property as a vector containing one transparency value per vertex. The transparency varies across each face by interpolating the values at the vertices.

`EdgeColor` — Edge colors
`[0 0 0]` (default) | `'none'` | `'flat'` | `'interp'` | RGB triplet | hexadecimal color code | `'r'` | `'g'` | `'b'` | ...

Edge colors, specified as one of the values in this table. The default edge color is black with a value of [0 0 0]. If multiple polygons share an edge, then the first polygon drawn controls the displayed edge color.

Value	Description	Result
RGB triplet, hexadecimal color code, or color name	Single color for all of the edges. See the following table for more details.
`'flat'`	Different color for each edge. Use the vertex colors to set the color of the edge that follows it. You must first specify `CData` or `FaceVertexCData` as an array containing one color per vertex. The edge color depends on the order in which you specify the vertices.
`'interp'`	Interpolated edge color. You must first specify `CData` or `FaceVertexCData` as an array containing one color per vertex. Determine the edge color by linearly interpolating the values at the two bounding vertices.
`'none'`	No edges displayed.	No edges displayed.

RGB triplets and hexadecimal color codes are useful for specifying custom colors.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example,[0.4 0.6 0.7].
A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Thus, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

`LineStyle` — Line style
`"-"` (default) | `"--"` | `":"` | `"-."` | `"none"`

Line style, specified as one of the options listed in this table.

Line Style	Description	Resulting Line
`"-"`	Solid line
`"--"`	Dashed line
`":"`	Dotted line
`"-."`	Dash-dotted line
`"none"`	No line	No line

Output Arguments

collapse all

`p` — Displayed polygonal regions
`Patch` object | vector of `Patch` objects

Displayed polygonal regions, returned as a Patch object or vector of Patch objects. Each patch corresponds to a plotted region. Use p to query or change properties of a region after it is plotted.

Alternative Functionality

Use the patch function to create filled polygons on 3-D axes. This function provides several additional options for defining and configuring filled regions:

Create polygons by specifying a set of faces and vertices.
Specify multiple n-gons of varying n within the same matrices.
Interpolate face colors from custom RBG values.

Extended Capabilities

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The fill3 function supports GPU array input with these usage notes and limitations:

This function accepts GPU arrays, but does not run on a GPU.

For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays
Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

Usage notes and limitations:

This function operates on distributed arrays, but executes in the client MATLAB.

For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a

expand all

R2021a: The `XData`, `YData`, and `ZData` properties on `Patch` objects created with the `fill` and `fill3` functions return values of the original data type

The XData, YData, and ZData properties on a Patch object created by the fill or fill3 functions return the coordinates using the original input data type, rather than returning them as double values.

In previous releases, datetime, duration, and categorical coordinates are converted to double values when they are stored in the XData, YData, and ZData properties.

For example, this code creates a filled polygon on 3-D axes with datetime x-coordinates. Then it calculates x2 using the values stored in the XData property. In R2020b, h.XData and x2 are double arrays. In R2021a, h.XData and x2 are datetime arrays.

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

To preserve the double values in your code, get the double values from the Vertices property of the Patch object. The x-, y-, and z-coordinates are stored as double values in the first, second, and third columns of the Vertices array.

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

Alternatively, use the ruler2num function. Pass the coordinate values and the corresponding axis ruler to the ruler2num function.

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

fill3

Syntax

Description

Examples

Create Filled Triangle in 3-D Axes

Specify Custom Fill Colors

Interpolate Fill Color from Vertices

Modify Patches After Creation

Input Arguments

X — x-coordinates of patch vertices vector | matrix

Y — y-coordinates of patch vertices vector | matrix

Z — z-coordinates of patch vertices vector | matrix

C — Patch colors color name | RGB triplet | vector of colormap indices | matrix of colormap indices | ...

Color Names and RGB Triplets for Common Colors

ax — Target axes Axes object

Name-Value Arguments

FaceColor — Face color [0 0 0] (default) | 'interp' | 'flat' | RGB triplet | hexadecimal color code | 'r' | 'g' | 'b' | ...

FaceAlpha — Face transparency 1 (default) | scalar in range [0,1] | 'flat' | 'interp'

EdgeColor — Edge colors [0 0 0] (default) | 'none' | 'flat' | 'interp' | RGB triplet | hexadecimal color code | 'r' | 'g' | 'b' | ...

LineStyle — Line style "-" (default) | "--" | ":" | "-." | "none"

Output Arguments

p — Displayed polygonal regions Patch object | vector of Patch objects

Alternative Functionality

Extended Capabilities

GPU Arrays Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Distributed Arrays Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

Version History

R2021a: The XData, YData, and ZData properties on Patch objects created with the fill and fill3 functions return values of the original data type

See Also

`X` — x-coordinates of patch vertices
vector | matrix

`Y` — y-coordinates of patch vertices
vector | matrix

`Z` — z-coordinates of patch vertices
vector | matrix

`C` — Patch colors
color name | RGB triplet | vector of colormap indices | matrix of colormap indices | ...

`ax` — Target axes
`Axes` object

`FaceColor` — Face color
`[0 0 0]` (default) | `'interp'` | `'flat'` | RGB triplet | hexadecimal color code | `'r'` | `'g'` | `'b'` | ...

`FaceAlpha` — Face transparency
1 (default) | scalar in range `[0,1]` | `'flat'` | `'interp'`

`EdgeColor` — Edge colors
`[0 0 0]` (default) | `'none'` | `'flat'` | `'interp'` | RGB triplet | hexadecimal color code | `'r'` | `'g'` | `'b'` | ...

`LineStyle` — Line style
`"-"` (default) | `"--"` | `":"` | `"-."` | `"none"`

`p` — Displayed polygonal regions
`Patch` object | vector of `Patch` objects

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Distributed Arrays
Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

R2021a: The `XData`, `YData`, and `ZData` properties on `Patch` objects created with the `fill` and `fill3` functions return values of the original data type