Rhodonite
Rhodonite is a WebGL library written in TypeScript.
Feature
- Component-oriented
- Blittable Memory Architecture (Original GPU data storage system with floating point texture)
- Physically-based Rendering with Image-based Lighting
- Support loading the following 3D model files: glTF2, glTF1, VRM
- Support Draco compression, Basis Universal and KTX2, etc
What's the "Blittable Memory Architecture"
With the Blittable Memory Architecture, Rhodonite stores almost all of its data in a large pre-allocated ArrayBuffer. Data storage for matrix or vector classes in Rhodonite's component classes and materials are assigned from the memory pool, which means most of the data are on that memory pool, transferred to the GPU every frame as a floating-point texture. This architecture allows all shaders always to access a vast amount of data.
For example, Rhodonite can handle and blend all morph targets (38 targets) of VRM characters simultaneously in the shader.
Viewer
You can try our library via https://editor.librn.com/. This viewer supports glTF/VRM files Drag & Drop to display. (Drag & Drop all files if glTF data is consists of multiple files.)
Supported Browsers
Google Chrome, Firefox, Safari, Microsoft Edge (chromium-based), and other modern browsers are supported. IE11 is not supported.
Install
You can install Rhodonite easily.
$ npm install rhodoniteNote
If you get an error like "webxr-input-profiles not found" when building a project using Rhodonite, Try "npm install" or "yarn install" again.
Coding with Rhodonite
In JavaScript
<body>
<canvas id="world"></canvas>
<script src="../../../dist/umd/rhodonite.min.js"></script>
<script>
// Init Rhodonite
await Rn.System.init({
approach: Rn.ProcessApproach.DataTexture,
canvas: document.getElementById('world'),
});
// create a Plane mesh
const planeEntity = Rn.MeshHelper.createPlane();
planeEntity.eulerAngles = Rn.Vector3.fromCopy3(Math.PI * 0.5, 0, 0);
// Render Loop
Rn.System.startRenderLoop(() => {
Rn.System.processAuto();
});
</script>
</body>In TypeScript
There are three package versions of Rhodonite: CommmonJS, ESModule, and UMD.
Using CommonJS package
You need a bundler (e.g., Webpack) to import the Rhodonite CommonJS package.
import Rn from 'rhodonite';
// Init Rhodonite
await Rn.System.init({
approach: Rn.ProcessApproach.DataTexture,
canvas: document.getElementById('world') as HTMLCanvasElement,
});
// create a Plane mesh
const planeEntity = Rn.MeshHelper.createPlane();
planeEntity.eulerAngles = Rn.Vector3.fromCopy3(Math.PI * 0.5, 0, 0);
// Render Loop
Rn.System.startRenderLoop(() => {
Rn.System.processAuto();
});Using ESModule package
You don't need any bundler.
<script type="module" src="main.js">// main.ts
import Rn from 'rhodonite/dist/esm/index.js';
// import Rn from 'rhodonite/dist/esmdev/index.js'; // use this if you want to display the source map or step through the library
// Init Rhodonite
await Rn.System.init({
approach: Rn.ProcessApproach.DataTexture,
canvas: document.getElementById('world') as HTMLCanvasElement,
});
// create a Plane mesh
const planeEntity = Rn.MeshHelper.createPlane();
planeEntity.eulerAngles = Rn.Vector3.fromCopy3(Math.PI * 0.5, 0, 0);
// Render Loop
Rn.System.startRenderLoop(() => {
Rn.System.processAuto();
});// tsconfig.json
{
...
"compilerOptions": {
"module": "ESNext",
"moduleResolution": "node",
"esModuleInterop": true,
...
}
...
}
Using UMD package
See the last part of https://github.com/actnwit/RhodoniteTS/wiki/Install .
Building Rhodonite
Prerequisites
- Node.js 14.15.5 or later
Setup Project
$ yarn installYou can use yarn instead.
Build command for Rhodonite library
$ yarn buildBuild command for samples
$ yarn build-samplesTry Samples
After building Rhodonite, try:
$ yarn watch-samplesThen, access http://localhost:8082/ with your web browser. When you are finished, press ctrl + c.
Build command for API documents
$ yarn docTesting Rhodonite
$ yarn testYou can execute a part of tests like this.
For unit test
$ yarn test-unit-part -- ./src/foundation/core$ yarn test-unit-part -- ./src/foundation/core/Entity.test.tsFor E2E (visual) test
$ yarn test-e2e-part -- ./samples/test_e2e/DataTextureInstancedDrawingWebGL1Development using VSCode devcontainer
This project supports the VSCode devcontainer for any docker-installed OS.
Input the following command in the VSCode command palette.
> Remote-Containers: Reopen in ContainerAfter a new dev container window opens, You can work in the Debian Linux container environment. All dependencies (node, npm, yarn, typescript, chromium, and all packages for Rhodonite) are already set up.
Debugging inside VSCode (Step execution in VSCode Debug tab)
- Install the "Debugger for Chrome" VSCode Extension.
- Start the local server with
$ yarn start. - Push the run icon by choosing "Launch Chrome to debug Rhodonite samples" in the RUN tab of VSCode's left pane to start debugging.
If you use the VSCode devcontainer environment, You should open another RhodoniteTS VSCode window locally and do debug ops on it instead of the devcontainer VSCode window.
License
MIT License
Acknowledgements
Libraries & Tools
Our library uses the following libraries and tools and more. Thank you.
- immersive-web/webxr-input-profiles (forked version)
- glTF samples
Check the complete list on package.json.