Installation

There are several installation options that are detailed below. In general this package only depends on the three.js visualization library. It has been tested down to version 0.105.0 but most versions with this major version number should work.

As a library under a global variable

When using this method, you must ensure that the three.js library is available as a global variable under the name THREE. In the simplest form this can be achieved by including the minified library code from a CDN by including it in your html. For example to include the version 0.118.0 from CDNJS, include the following script tag:

<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r118/three.min.js" integrity="sha512-ZoEQdcOJ16M20VnLaQxmZlthvLdTbF9CSAAyvZyzru+Em8NEY+7Xy0jdWdUjdOlo7hbPVmaobVBpUF9aqmXENA==" crossorigin="anonymous"></script>

After this script (order is important, also see the defer attribute for script elements), you will want to include the minified library for materia. You can get the newest version from the GitHub repository or install and use a specific version from npm. Then place the minified file (materia.min.js) in your server and include it as a script element:

<script src="/path/in/your/server/materia.min.js"></script>

All functionality will then be available under the materia variable, e.g.

let structureViewer = new materia.StructureViewer();

As a module

The library is distributed as an npm package and can be installed with:

npm install @lauri-codes/materia

This command will also install the three.js library as a dependency. With this package you have direct access to individual modules that can also be tree-shaked in your own build. For example:

import { StructureViewer } from "@lauri-codes/materia"