@threepipe/plugin-assimpjs

This package exports AssimpJsPlugin which loads the assimpjs library and provides ajs interface.

Example — Source Code — API Reference

This package uses a custom fork of assimpjs with custom build to support fbx export etc - https://github.com/repalash/assimpjs

npm install @threepipe/plugin-assimpjs

Sample Usage

Convert any format to glTF/glb and load in viewer

Any set of 3d files can be loaded into assimp, and converted to glTF/glb format. The converted files can then be loaded into the viewer as blobs.

import {ThreeViewer} from 'threepipe'
import {AssimpJsPlugin} from '@threepipe/plugin-assimpjs'

const viewer = new ThreeViewer({...})
const assimpjs = viewer.addPluginSync(AssimpJsPlugin)
await assimp.init() // load the assimpjs library and wait for it to be ready. It also loads automatically when plugin is added to the viewer if autoInit is true.

// Prepare a list of files to load
const files = [
    'https://threejs.org/examples/models/obj/male02/male02.obj',
]
// Download the files
const fe = files.map(async f=>fetch(`${f}`).then(async t=>t.arrayBuffer()))
const responses = await Promise.all(fe)
const fileList: Record<string, ArrayBuffer> = {}
for (let i = 0; i < files.length; i++) {
    fileList[files[i]] = responses[i]
}
const fbx = assimp.convertFiles(fileList, 'glb2')
if (!fbx) {
    console.error('Failed to convert files to glb')
    return
}

// load the glb file
await viewer.load<IObject3D>({path: 'file.glb', file: glb})

Check the assimpjs-plugin example for a live demo.

Export to FBX / Convert to FBX

Assimp includes a FBX exporter, which can be used to convert any 3D file format to FBX. To export the current scene to FBX, the scene can be exported to glTF/glb format, and then converted to FBX using the AssimpJsPlugin's convertFiles function.

import {ThreeViewer, downloadBlob} from 'threepipe'
import {AssimpJsPlugin} from '@threepipe/plugin-assimpjs'

const viewer = new ThreeViewer({...})
const assimpjs = viewer.addPluginSync(AssimpJsPlugin)
await assimp.init() // load the assimpjs library and wait for it to be ready. It also loads automatically when plugin is added to the viewer if autoInit is true.

// load some models
const result = await viewer.load<IObject3D>('https://threejs.org/examples/models/gltf/DamagedHelmet/glTF/DamagedHelmet.gltf')

const fbxBlob = await assimp.exportModel('fbx', result, {
    embedUrlImages: true,
})

// download the fbx file
downloadBlob(fbxBlob, 'model.fbx')

Check full example - fbx-export.