def volmesh_draw(volmesh,
layer=None,
clear_layer=False,
vertexcolor=None,
edgecolor=None,
facecolor=None):
"""Draw a volmesh.
Parameters
----------
volmesh : compas.datastructures.VolMesh
A volmesh object.
layer : str (None)
The layer to draw in.
Default is to draw in the current layer.
clear_layer : bool (False)
Clear the current layer.
vertexcolor : str, tuple, list, dict (None)
The vertex color specification.
Default is to use the color of the parent layer.
edgecolor : str, tuple, list, dict (None)
The edge color specification.
Default is to use the color of the parent layer.
facecolor : str, tuple, list, dict (None)
The face color specification.
Default is to use the color of the parent layer.
Examples
--------
>>> volmesh_draw(volmesh)
>>> volmesh_draw(volmesh, layer='SomeLayer')
>>> volmesh_draw(volmesh, clear_layer=True)
>>> volmesh_draw(volmesh, vertexcolor='#ff0000')
>>> volmesh_draw(volmesh, edgecolor=(0, 255, 0))
>>> volmesh_draw(volmesh, facecolor={key: (0.0, 0.0, 0.5) for key in volmesh.faces()})
See Also
--------
* compas_rhino.VolMeshArtist
"""
artist = VolMeshArtist(volmesh)
artist.layer = layer
if clear_layer:
artist.clear_layer()
artist.clear()
artist.draw_vertices(color=vertexcolor)
artist.draw_edges(color=edgecolor)
artist.draw_faces(color=facecolor)
artist.redraw()
def clear(self):
artist = VolMeshArtist(self)
# self.clear_cell_labels()
artist.clear()
