Que fait VectoJS Three ?
Utilisez cette compétence pour placer une interface VectoJS 2D en direct sur une texture Three.js et rediriger les entrées du pointeur 3D vers la scène VectoJS.
Workflow d'intégration
- Installez
@vectojs/core,@vectojs/three,three, et@vectojs/uisi vous utilisez des composants d'interface. - Créez un
ThreeAdapterpar texture de panneau VectoJS. - Ajoutez des entités VectoJS à
adapter.vectoScene, puis démarrez la scène interne. - Ajoutez
adapter.meshou la texture/matériau de l'adaptateur à la scène Three.js hôte. - Dans la boucle de pointeur/molette hôte, effectuez un raycast contre le maillage de l'adaptateur et appelez
adapter.updateIntersection(...). - Appelez
adapter.dispose()lors de la suppression du panneau.
Consultez references/three-recipes.md pour des extraits de code.
Contraintes
- La sortie par défaut est un plan texturé plat, pas un rendu DOM en 3D.
- Les tests de collision logiques VectoJS restent en 2D même lorsque le maillage est transformé dans l'espace monde.
- L'application hôte possède la caméra, le moteur de rendu, les contrôles, la session XR, le raycaster et les règles d'occlusion.
- Les UV du raycast doivent correspondre à la
largeur/hauteurlogique de l'adaptateur ; n'utilisez pas la taille du tampon de stockage pour le calcul de la mise en page. - La résolution de la texture affecte la netteté et le coût de téléchargement. Choisissez les dimensions en fonction de la distance de visualisation.
Erreurs courantes
| Erreur | Correction |
|---|---|
| Ajouter un canevas d'adaptateur hors écran au DOM | Ajoutez adapter.mesh à Three.js ; le canevas sert de support à la texture. |
Oublier d'appeler updateIntersection | Routez les événements du raycaster hôte vers l'adaptateur à chaque événement de pointeur/molette. |
| Distribuer par coordonnées d'écran | Utilisez les UV du raycast via ThreeAdapter. |
| Garder des textures disposées en vie | Appelez adapter.dispose() et supprimez les références hôtes. |
| Attendre une accessibilité DOM complète dans XR | Traitez le panneau 3D comme une texture de canevas ; fournissez une sémantique de niveau hôte si nécessaire. |
Problèmes de version et de backend (vérifiés sur source)
- three ≤ 0.1.3 :
ThreeRenderer.flush()effectuait un rendu GL complet, et la Scene se vidait autour de chaque nœud non regroupé — le coût par trame augmentait en O(N²) en fonction du nombre d'entités. three 0.1.4 rend une fois par trame via le hookpresent(); mettez à niveau avant de profiler quoi que ce soit. - L'entrée native dans une texture est limitée. Le canevas de l'adaptateur est
hors écran, donc les éléments projetés d'accessibilité de la scène ne sont jamais connectés au
document ;
updateIntersectionutilise le système de distribution d'événements propre à VectoJS. Les boutons, le survol et la molette fonctionnent ; la saisie de texte native complète (IME) ne fonctionne pas — gardez la saisie de texte à l'extérieur du panneau 3D ou acceptez une saisie simplifiée. - L'épaisseur de trait
stroke()est effectivement de 1 px sur la plupart des plateformes (LineBasicMaterial.linewidthest une limitation WebGL connue). Dessinez des lignes épaisses sous forme de formes remplies à la place. ThreeRenderer.drawImagealloue une texture par appel par trame (disposée lors declear()) ; réutilisez un canevas source lorsque c'est possible.fillTextest mis en cache à partir de trois 0.1.4 (LRU indexé par police|couleur|texte, 256 entrées) — sur ≤ 0.1.3, il avait le même coût par appel, donc préférezMSDFTextEntitydans ce cas.