VectoJS Three
Usa este skill para colocar una interfaz 2D VectoJS en vivo sobre una textura de Three.js y enrutar la entrada del puntero 3D de vuelta a la escena VectoJS.
Flujo de trabajo de integración
- Instala
@vectojs/core,@vectojs/three,threey@vectojs/uisi usas componentes de UI. - Crea un
ThreeAdapterpor cada textura de panel VectoJS. - Añade entidades VectoJS a
adapter.vectoScene, luego inicia la escena interna. - Añade
adapter.mesho la textura/material del adaptador a la escena Three.js anfitriona. - En el bucle de puntero/rueda del anfitrión, haz raycasting contra el mesh del adaptador y llama a
adapter.updateIntersection(...). - Llama a
adapter.dispose()al eliminar el panel.
Consulta references/three-recipes.md para ver fragmentos de código.
Restricciones
- La salida predeterminada es un plano texturizado plano, no renderizado en DOM en 3D.
- Las pruebas de impacto lógicas de VectoJS siguen siendo 2D incluso cuando el mesh se transforma en el espacio del mundo.
- La aplicación anfitriona posee la cámara, el renderizador, los controles, la sesión XR, el raycaster y las reglas de oclusión.
- Las coordenadas UV del raycaster deben mapearse a las dimensiones lógicas (
width/height) del adaptador; no uses el tamaño del almacenamiento de respaldo para el diseño. - La resolución de la textura afecta la nitidez y el costo de subida. Elige dimensiones según la distancia de visualización.
Errores comunes
| Error | Corrección |
|---|---|
| Añadir un canvas de adaptador fuera de pantalla al DOM | Añade adapter.mesh a Three.js; el canvas respalda la textura. |
Olvidar llamar a updateIntersection | Enruta los eventos del raycaster anfitrión al adaptador en cada evento de puntero/rueda. |
| Despachar por coordenadas de pantalla | Usa las coordenadas UV del raycaster a través de ThreeAdapter. |
| Mantener texturas eliminadas vivas | Llama a adapter.dispose() y elimina las referencias del anfitrión. |
| Esperar accesibilidad DOM completa dentro de XR | Trata el panel 3D como textura de canvas; proporciona semántica a nivel de anfitrión donde sea necesario. |
Versionado y peculiaridades del backend (verificado en fuente)
- three ≤ 0.1.3:
ThreeRenderer.flush()realizaba un renderizado GL completo, y la Scene se vaciaba alrededor de cada nodo no agrupado; el costo por fotograma crecía O(N²) en número de entidades. three 0.1.4 renderiza una vez por fotograma mediante el hookpresent(); actualiza antes de perfilar cualquier otra cosa. - La entrada nativa dentro de una textura es limitada. El canvas del adaptador está
fuera de pantalla, por lo que los elementos de accesibilidad proyectados de la Scene nunca están conectados al
documento;
updateIntersectionrecurre al envío de eventos propio de VectoJS. Botones/desplazamiento/rueda funcionan; la edición completa de IME/texto nativa no — mantén la entrada de texto fuera del panel 3D o acepta una entrada simplificada. - El ancho de línea de
stroke()es efectivamente 1px en la mayoría de plataformas (LineBasicMaterial.linewidthes una limitación conocida de WebGL). Dibuja líneas gruesas como formas rellenas en su lugar. ThreeRenderer.drawImageasigna una textura por llamada por fotograma (se elimina enclear()); reutiliza un canvas de origen cuando sea posible.fillTextse almacena en caché desde three 0.1.4 (LRU con clave por fuente|color|texto, 256 entradas) — en ≤ 0.1.3 tenía el mismo costo por llamada, así que prefiereMSDFTextEntityahí.