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:

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

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.