mpl_toolkits.mplot3d.art3d.Poly3DCollection

class mpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort=True, **kwargs)

Bases: matplotlib.collections.PolyCollection

A collection of 3D polygons.

Create a Poly3DCollection.

verts should contain 3D coordinates.

Keyword arguments: zsort, see set_zsort for options.

Note that this class does a bit of magic with the _facecolors and _edgecolors properties.

do_3d_projection(renderer)

Perform the 3D projection for this object.

get_edgecolor()

get_facecolor()

get_vector(segments3d)

Optimize points for projection.

set_3d_properties()

set_alpha(alpha)

Set the alpha transparencies of the collection.

Parameters:

alpha : float or None

set_edgecolor(colors)

Set the edgecolor(s) of the collection. c can be a matplotlib color spec (all patches have same color), or a sequence of specs; if it is a sequence the patches will cycle through the sequence.

If c is 'face', the edge color will always be the same as the face color. If it is 'none', the patch boundary will not be drawn.

Parameters:

c : color or sequence of colors

set_facecolor(colors)

Set the facecolor(s) of the collection. c can be a matplotlib color spec (all patches have same color), or a sequence of specs; if it is a sequence the patches will cycle through the sequence.

If c is 'none', the patch will not be filled.

Parameters:

c : color or sequence of colors

set_sort_zpos(val)

Set the position to use for z-sorting.

set_verts(verts, closed=True)

Set 3D vertices.

set_verts_and_codes(verts, codes)

Sets 3D vertices with path codes.

set_zsort(zsort)

Sets the calculation method for the z-order.

Parameters:

zsort : bool or {'average', 'min', 'max'}

For 'average', 'min', 'max' the z-order is determined by applying the function to the z-coordinates of the vertices in the viewer's coordinate system. True is equivalent to 'average'.