Was macht VectoJS Three?
Verwende diesen Skill, um eine Live-VectoJS-2D-Oberfläche auf eine Three.js-Textur zu legen und 3D-Zeigereingaben zurück in die VectoJS-Szene zu leiten.
Integrationsablauf
- Installiere
@vectojs/core,@vectojs/three,threeund ggf.@vectojs/ui, wenn UI-Komponenten verwendet werden. - Erstelle einen
ThreeAdapterpro VectoJS-Panel-Textur. - Füge VectoJS-Entitäten zu
adapter.vectoScenehinzu und starte dann die innere Szene. - Füge
adapter.meshoder die Adapter-Textur/das Material zur hostenden Three.js-Szene hinzu. - Führe in der hostenden Pointer-/Wheel-Schleife Raycasting gegen das Adapter-Mesh durch und rufe
adapter.updateIntersection(...)auf. - Rufe
adapter.dispose()auf, wenn das Panel entfernt wird.
Lies references/three-recipes.md für Code-Ausschnitte.
Einschränkungen
- Die Standardausgabe ist eine flache texturierte Ebene, kein DOM, das in 3D gerendert wird.
- Das logische VectoJS-Hit-Testing bleibt 2D, selbst wenn das Mesh im Weltraum transformiert wird.
- Die Host-Anwendung besitzt die Kamera, den Renderer, die Steuerung, die XR-Sitzung, den Raycaster und die Occlusion-Regeln.
- Raycast-UVs sollten auf die logischen
width/heightdes Adapters abbilden; verwende nicht die Backing-Store-Größe für Layout-Berechnungen. - Die Texturauflösung beeinflusst Schärfe und Upload-Kosten. Wähle Abmessungen entsprechend der Betrachtungsentfernung.
Häufige Fehler
| Fehler | Korrektur |
|---|---|
| Hinzufügen eines Offscreen-Adapter-Canvas zum DOM | Füge adapter.mesh zu Three.js hinzu; das Canvas dient als Textur-Backing. |
Vergessen von updateIntersection | Leite Host-Raycaster-Ereignisse bei jedem Pointer-/Wheel-Ereignis an den Adapter weiter. |
| Verwenden von Bildschirmkoordinaten | Verwende Raycast-UVs über ThreeAdapter. |
| Beibehalten entsorgter Texturen | Rufe adapter.dispose() auf und entferne Host-Referenzen. |
| Erwarten vollständiger DOM-Barrierefreiheit in XR | Behandle das 3D-Panel als Canvas-Textur; stelle Host-seitige Semantik bereit, wo nötig. |
Versions- und Backend-Gotchas (quellgeprüft)
- three ≤ 0.1.3:
ThreeRenderer.flush()führte einen vollständigen GL-Renderdurchlauf aus, und die Szene spülte um jeden nicht-gebatchen Knoten – die Framekosten wuchsen O(N²) mit der Anzahl der Entitäten. three 0.1.4 rendert einmal pro Frame über denpresent()-Hook; aktualisiere vor dem Profiling. - Native Eingabe in einer Textur ist begrenzt. Der Adapter-Canvas ist offscreen, daher sind die projizierten Barrierefreiheitselemente der Szene nie mit dem Dokument verbunden;
updateIntersectionfällt auf VectoJS' eigenen Ereignisdispatch zurück. Buttons/Hover/Wheel funktionieren; vollständige native IME/Textbearbeitung nicht – halte Texteingabe außerhalb des 3D-Panels oder akzeptiere vereinfachte Eingabe. stroke()-Linienbreite ist effektiv 1px auf den meisten Plattformen (LineBasicMaterial.linewidthist eine bekannte WebGL-Einschränkung). Zeichne dicke Linien stattdessen als gefüllte Formen.ThreeRenderer.drawImageallokiert eine Textur pro Aufruf pro Frame (freigegeben beiclear()); verwende wo möglich eine Quell-Canvas wieder.fillTextist ab three 0.1.4 gecacht (LRU mit Schlüssel aus Schrift|Farbe|Text, 256 Einträge) – bei ≤ 0.1.3 hatte es die gleichen Kosten pro Aufruf, daher bevorzuge dortMSDFTextEntity.