Skip to content

GLTF Custom Animations

Video Lecture

GLTF Custom Animations

Description

We don't need to download animations from other websites, we can create our own.

Using Blender, you can create a model and then adjust the positions, scales and rotations of its parts by creating key frames on the timeline editor.

Test your animation works by using the play options on the timeline editor in Blender, and then export your model as GLB(preferred) or GLTF with animation options selected for the export.

After exporting your model, you can drag the GLB/GLTF file from your filesystem, onto this example scene below. It will read the file and create a new checkbox for every animation clip that it finds. You can enable/disable each animation independently.

<>

Lesson Scripts

./dist/client/index.html

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
        <title>
            Three.js TypeScript Tutorials by Sean Bradley :
            https://sbcode.net/threejs
        </title>
        <style>
            body {
                overflow: hidden;
                margin: 0px;
            }

            #animationsPanel {
                position: absolute;
                top: 40px;
                right: 10px;
                width: 300px;
                height: auto;
                border: 1px solid white;
                color: white;
                font-family: monospace;
                font-size: 17px;
            }

            #animationsPanel ul {
                padding: 4px;
                list-style-type: none;
            }

            #btnPlayAll {
                position: absolute;
                top: 10px;
                right: 10px;
                width: 300px;
                display: none;
            }

            #dropzone {
                position: absolute;
                width: 140px;
                height: 90px;
                left: 10px;
                top: 50px;
                border: 10px dotted gray;
                background-color: lightgray;
                padding: 20px;
                font-family: monospace;
                font-size: 17px;
            }

            #dropzone p {
                pointer-events: none;
            }
        </style>
    </head>

    <body>
        <div id="dropzone">
            <p>Drag (uncompressed) animated gLTF/gLB here</p>
        </div>
        <button id="btnPlayAll">Play All</button>
        <div id="animationsPanel"></div>
        <script type="module" src="bundle.js"></script>
    </body>
</html>

./src/client/client.ts

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
import * as THREE from 'three'
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls'
import { GLTF, GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader'
import Stats from 'three/examples/jsm/libs/stats.module'

const scene = new THREE.Scene()
scene.add(new THREE.AxesHelper(5))

const camera = new THREE.PerspectiveCamera(
    75,
    window.innerWidth / window.innerHeight,
    0.1,
    1000
)
camera.position.set(4, 4, 4)

const renderer = new THREE.WebGLRenderer()
renderer.setSize(window.innerWidth, window.innerHeight)
document.body.appendChild(renderer.domElement)

const controls = new OrbitControls(camera, renderer.domElement)
controls.enableDamping = true

let mixer: THREE.AnimationMixer
let modelReady = false

const gltfLoader = new GLTFLoader()

const dropzone = document.getElementById('dropzone') as HTMLDivElement

dropzone.ondragover = dropzone.ondragenter = function (evt) {
    evt.preventDefault()
}
dropzone.ondrop = function (evt: DragEvent) {
    evt.stopPropagation()
    evt.preventDefault()

    //clear the scene
    for (let i = scene.children.length - 1; i >= 0; i--) {
        scene.remove(scene.children[i])
    }
    //clear the checkboxes
    const myNode = document.getElementById('animationsPanel') as HTMLDivElement
    while (myNode.firstChild) {
        myNode.removeChild(myNode.lastChild as any)
    }

    const axesHelper = new THREE.AxesHelper(5)
    scene.add(axesHelper)

    const light1 = new THREE.DirectionalLight(new THREE.Color(0xffcccc), 2)
    light1.position.set(-1, 1, 1)
    scene.add(light1)

    const light2 = new THREE.DirectionalLight(new THREE.Color(0xccffcc), 2)
    light2.position.set(1, 1, 1)
    scene.add(light2)

    const light3 = new THREE.DirectionalLight(new THREE.Color(0xccccff), 2)
    light3.position.set(0, -1, 0)
    scene.add(light3)

    const files = (evt.dataTransfer as DataTransfer).files
    const reader = new FileReader()
    reader.onload = function () {
        gltfLoader.parse(
            reader.result as string,
            '/',
            (gltf: GLTF) => {
                console.log(gltf.scene)

                mixer = new THREE.AnimationMixer(gltf.scene)

                console.log(gltf.animations)

                if (gltf.animations.length > 0) {
                    const animationsPanel = document.getElementById(
                        'animationsPanel'
                    ) as HTMLDivElement
                    const ul = document.createElement('UL') as HTMLUListElement
                    const ulElem = animationsPanel.appendChild(ul)

                    gltf.animations.forEach((a: THREE.AnimationClip, i) => {
                        const li = document.createElement('UL') as HTMLLIElement
                        const liElem = ulElem.appendChild(li)

                        const checkBox = document.createElement(
                            'INPUT'
                        ) as HTMLInputElement
                        checkBox.id = 'checkbox_' + i
                        checkBox.type = 'checkbox'
                        checkBox.addEventListener('change', (e: Event) => {
                            if ((e.target as HTMLInputElement).checked) {
                                mixer
                                    .clipAction((gltf as any).animations[i])
                                    .play()
                            } else {
                                mixer
                                    .clipAction((gltf as any).animations[i])
                                    .stop()
                            }
                        })
                        liElem.appendChild(checkBox)

                        const label = document.createElement(
                            'LABEL'
                        ) as HTMLLabelElement
                        label.htmlFor = 'checkbox_' + i
                        label.innerHTML = a.name
                        liElem.appendChild(label)
                    })

                    if (gltf.animations.length > 1) {
                        const btnPlayAll = document.getElementById(
                            'btnPlayAll'
                        ) as HTMLButtonElement
                        btnPlayAll.addEventListener('click', (e: Event) => {
                            mixer.stopAllAction()
                            gltf.animations.forEach(
                                (a: THREE.AnimationClip) => {
                                    mixer.clipAction(a).play()
                                }
                            )
                        })

                        btnPlayAll.style.display = 'block'
                    }
                } else {
                    const animationsPanel = document.getElementById(
                        'animationsPanel'
                    ) as HTMLDivElement
                    animationsPanel.innerHTML = 'No animations found in model'
                }

                //Center model in view
                const box = new THREE.Box3().setFromObject(gltf.scene)
                const center = box.getCenter(new THREE.Vector3())
                gltf.scene.position.x += gltf.scene.position.x - center.x
                gltf.scene.position.y += gltf.scene.position.y - center.y
                gltf.scene.position.z += gltf.scene.position.z - center.z

                scene.add(gltf.scene)

                modelReady = true
            },
            (error) => {
                console.log(error)
            }
        )
    }
    reader.readAsArrayBuffer(files[0])
}

window.addEventListener('resize', onWindowResize, false)
function onWindowResize() {
    camera.aspect = window.innerWidth / window.innerHeight
    camera.updateProjectionMatrix()
    renderer.setSize(window.innerWidth, window.innerHeight)
    render()
}

const stats = new Stats()
document.body.appendChild(stats.dom)

const clock = new THREE.Clock()

function animate() {
    requestAnimationFrame(animate)

    controls.update()

    if (modelReady) mixer.update(clock.getDelta())

    render()

    stats.update()
}

function render() {
    renderer.render(scene, camera)
}

animate()

Comments