Primitives are basic 3d objects that can build more complex shapes. For example, a 3d plot can be converted into polygons.

If you are using this library as a backend to a Wolfram-Language-like project that supports Plot3D you may convert that to a Graphics3D object (this library goal is to fully support it), or create a conversion function for every plot function.

An example of conversion code for a ListPlot3D:

import json

def list_plot_3d(coordinate_list: list) -> str:
    polygons: list = []

    for i in range(len(coordinate_list) - 1):
        for j in range(len(coordinate_list[0]) - 1):
            polygons.append([
                [i, j, coordinate_list[i][j]],
                [i + 1, j + 1, coordinate_list[i + 1][j + 1]],
                [i, j + 1, coordinate_list[i][j + 1]],
            ])
            polygons.append([
                [i, j, coordinate_list[i][j]],
                [i + 1, j + 1, coordinate_list[i + 1][j + 1]],
                [i + 1, j, coordinate_list[i + 1][j]],
            ])

    json_object: dict = {
        "elements": [
            {
                "type": "polygon",
                "color": [1, 1, 1],
                "coords": polygon,
            } for polygon in polygons
        ],
        "lighting": [{ "type": "ambient", "color": [1, 1, 1] }],
        "viewpoint": [2, -4, 4],
    }

    return json.dumps(json_object)

The current list of primitives supported:

• arrow
• cone
• cuboid
• cylinder
• line
• point
• polygon
• sphere
• text
• tube
• uniformPolyhedron