Three.js Bridge

Convert between shapecraft meshes and Three.js objects.

import { toThreeMesh, toThreeGeometry, fromThreeGeometry } from 'shapecraft/three'

toThreeMesh

Returns a THREE.Mesh ready to add to a scene.

const threeMesh = toThreeMesh(mesh)
scene.add(threeMesh)

// Options
toThreeMesh(mesh, {
  flatShading: true,     // default true (low-poly look)
  wireframe: false,      // default false
  roughness: 1,          // default 1 (fully matte)
  metalness: 0,          // default 0
  doubleSided: false,    // default false — set true for thin geometry (leaves)
  material: myMaterial,  // override auto-generated material entirely
})

Auto-detects vertex colors — uses MeshStandardMaterial({ vertexColors: true }) if present, otherwise default gray.

toThreeGeometry

Get just the THREE.BufferGeometry:

const geometry = toThreeGeometry(mesh)
const obj = new THREE.Mesh(geometry, myMaterial)

fromThreeGeometry

Import an existing Three.js geometry into shapecraft:

const mesh = fromThreeGeometry(existingGeometry)
mesh.translate(1, 0, 0).vertexColor('#ff0000')