Tresjs/docs/nl/guide/getting-started.md

Installatie

Leer hoe je TresJS installeert

::: code-group

pnpm add three @tresjs/core

npm install three @tresjs/core

yarn add three @tresjs/core

:::

Beter gebruik met Vue 3.x en de composition API

Typescript

TresJS is geschreven in Typescript en is volledig getypt. Als u Typescript gebruikt, profiteert u optimaal van de typmogelijkheden. Zorg ervoor dat u de types voor threejs installeert.

::: code-group

npm install @types/three -D

yarn add @types/three -D

pnpm add @types/three -D

:::

Aan de slag

Je kan TresJS installeren als elke andere Vue plugin

import Tres from '@tresjs/core'
import { createApp } from 'vue'
import App from './App.vue'

export const app = createApp(App)

app.use(Tres)
app.mount('#app')

Of je kan het direct gebruiken in je component

<script setup lang="ts">
import { TresCanvas } from '@tresjs/core'
</script>

<template>
  <TresCanvas>
    <!-- Je scene komt hier -->
  </TresCanvas>
</template>

::: tip Dit wordt aanbevolen vanwege de prestaties en de bundelgrootte. tree-shaking werkt beter en je importeert alleen de componenten die je gebruikt. :::

Vite

Omdat v2 een custom renderer is, moeten we de vue-compiler van uw app laten weten dat de componenten van Tres mogen worden opgenomen om de waarschuwing [Vue warn]: Failed to solve component te vermijden.

Je hoeft alleen maar de templateCompilerOptions van TresJS te importeren en toe te voegen aan uw vite.config.ts in de vue plugin:

import { templateCompilerOptions } from '@tresjs/core'

export default defineConfig({
  plugins: [
    vue({
      // Andere config
      ...templateCompilerOptions
    }),
  ]
})