use-gltf.md 1.1 KB

useGLTF

A composable that allows you to easily load glTF models into your TresJS scene.

Usage

import { useGLTF } from '@tresjs/cientos'

const { scene } = await useGLTF('/models/AkuAku.gltf')

Then is as straightforward as adding the scene to your scene:

<Suspense>
  <TresCanvas shadows alpha>
    <TresScene>
      <TresMesh v-bind="scene" />
    </TresScene>
  </TresCanvas>
</Suspense>

An advantage of using useGLTFis that you can pass a draco prop to enable Draco compression for the model. This will reduce the size of the model and improve performance.

import { useGLTF } from '@tresjs/cientos'

const { scene } = await useGLTF('/models/AkuAku.gltf', { draco: true })

Options

Name Type Default Description
draco boolean false Whether to enable Draco compression.
decoderPath string undefined Local path to the Draco decoder.