@draco-rust/fbx

Reads and writes binary FBX in WebAssembly. It keeps the model tree with its local transforms, the materials, the skins with their weights, and the morph targets, rather than a flat list of meshes. It is part of draco-rust and is what the converter uses to bring FBX into glTF.

~234 KiB gzip.

Usage

import init, { read_fbx, write_fbx } from "@draco-rust/fbx";

await init();
const scene = read_fbx(fbxBytes);
if (!scene.success) throw new Error(scene.error);
console.log(scene.meshes.length, scene.warnings);

const written = write_fbx({ positions, indices, normals, uvs }, {}); // or an array of meshes
const fbx = written.bytes; // Uint8Array

write_fbx_scene(scene, options) writes a whole scene instead: model hierarchy, materials, textures, animation and local transforms. Compressed FBX arrays (zlib) are read, which every mainstream exporter writes. ASCII FBX is not supported.

On workers

A large file blocks the calling thread while it is read or written. @draco-rust/fbx/pool runs the same functions on workers:

import { createPool } from "@draco-rust/fbx/pool";

const pool = createPool({ workers: 2 }); // default: cores - 1, at most 4
const result = await pool.read(bytes); // what read_fbx returns
const written = await pool.write(meshes, {}); // what write_fbx returns
const scene = await pool.writeScene(sceneInput, {}); // what write_fbx_scene returns
pool.dispose();

The workers start as work arrives, and the wasm is compiled once for all of them. Inputs are copied to the worker, or handed over with { transfer: true }; { signal } takes an AbortSignal, which rejects the promise at once. A task a worker has started still runs to its end and its result is dropped. With workers: 0, or where there are no workers, the pool runs on the calling thread. It works on Web Workers, Node's worker threads (Node 20.16 and later) and from a CDN, as the decoder's does.

For loading from a CDN or in Node, see the decoder's README; the same init options apply, with @draco-rust/fbx/index_bg.wasm as the file.

Licensed under Apache-2.0.

This build

@draco-rust/[email protected] was built from draco-rust commit 4b72cfc8, with draco-core 2.3.2, draco-io 0.6.0, draco-gltf 0.7.0.