veux.create_artist

veux.create_artist(model, ndf=6, canvas='gltf', vertical=2, **opts)

Create an Artist for a model:

artist = veux.create_artist(model, canvas=canvas)

Parameters

modelstr, dict, or Model

The model parameter can be of several types:

• str: Treated as a file path. Supported file formats are .json and .tcl.

• dict: A dictionary representation of the model.

• Model: An instance of the Model class from the xara Python package. See the documentation for details.

canvasstr, optional

The rendering backend to use. Options are (see Canvas):

• "gltf" (default): Produces high-quality renderings. Files can be saved as .html or .glb. .glb is recommended for 3D object portability.

• "plotly": Best for model debugging. Includes detailed annotations (e.g., node/element numbers, properties) but lower visual quality than gltf.

• "matplotlib": Generates .png files programmatically. Note that renderings are lower quality compared to gltf.

Returns

artistArtist

An object representing the rendered model. Can be used to view or save the rendering.