@mathicsorg/mathics-threejs-backend

mathics-threejs-backend

A JavaScript library for rendering Mathics (and eventually Wolfram-Language) Graphics3D objects.

This can be used in Mathics front ends like Mathics-Django to handle 3D Graphics. The code may also be useful as a guide for other kinds of Mathics/WL frontends to other kinds of Javascript graphics engines.

Example:

import drawGraphics3D from 'mathics-threejs-backend/src/index.js';

drawGraphics3D(
    document.getElementById('main'),
    {
        elements: [
            {
                type: 'sphere',
                color: [1, 1, 1],
                coords: [
                    [[0, 0, 0]]
                ]
            }
        ],
        lighting: [
            {
                type: 'ambient',
                color: [1, 1, 1]
            }
        ],
        viewpoint: [2.6, -4.8, 4.0]
    }
)

Lots of other examples can be found in the examples directory of this repository.

Displaying Examples

Install an HTTP server and run it:

$ npm install http-server # Do this only one time.
...
added 30 packages from 40 contributors and audited 30 packages in 1.595s
...
found 0 vulnerabilities

The above only needs to be done once to set up an HTTP server to use. If you already have an HTTP server running that is also able to browse local files in this repository, then you probably don't need to do this.

Otherwise, start the HTTP server that was just installed:

$ ./node_modules/http-server/bin/http-server  # Do this once per session
Starting up http-server, serving ./
Available on:
  http://127.0.0.1:8080
...
Hit CTRL-C to stop the server

Finally, look at a file that you want to see rendered, e.g. http://127.0.0.1:8080/examples/gallery/objects-in-directional-light.html

JSON API for Compact Graphics3D

See the wiki for the JSON API description for Graphics3D Primitives.