Zur Nutzungsanleitung springen
Three.js Interactionvon CloudAI-X

Three.js Interaction Skill.

Ordnen Sie eine Geste dem gemeinten 3D-Objekt zu, indem Sie die tatsächlichen Koordinaten von Canvas und Kamera verwenden.

  • 3D
  • Three.js
Quellenprüfung · Three.js InteractionSKILL.md
Aufgabe 3D Ergebnis • Objektauswahl relativ zum Canvas • Eine passende Konfiguration der Kamerasteuerung • Verhalten für Selektion, Hover, Ziehen oder Transformation Vor dem Start Ein funktionierendes Three.js-Projekt mit Renderer; prüfen Sie die Quellbeispiele anhand der installierten Version. Weitere Controls und Loader hängen vom gewählten Weg ab.
Redaktionelle Zusammenfassung · Quelle geprüft am 2026-10-07 · kein generiertes Beispiel

01 Funktionen

Three.js Interaction: Objekte auswählen und manipulieren

Strahlbasierte Objektauswahl, Koordinatenumrechnung, Kamerasteuerung, Selektion und Objektmanipulation.

Workflow auf QuellenbasisKein Ausführungs-Benchmark

Der Arbeitsansatz

Three.js Interaction behandelt Raycasting und Steuerelemente. Es erklärt, wie Bildschirmeingaben zu einem Kamerastrahl werden, wie Schnittpunkte Objekte oder Instanzen identifizieren und warum ein eingebettetes Canvas eine eigene Koordinatenumrechnung braucht, statt von einem Vollfenster auszugehen.

Kameranavigation und Objektmanipulation sind getrennte Aufgaben. Orbit-, Fly-, Map-, Drag- und Transform-Controls haben unterschiedliche Rollen. Eine editorähnliche Szene muss diese Handler so abstimmen, dass das Ziehen eines Modells nicht auch die Kamera dreht.

Erwartete Ergebnisse

  • Objektauswahl relativ zum Canvas
  • Eine passende Konfiguration der Kamerasteuerung
  • Verhalten für Selektion, Hover, Ziehen oder Transformation
Beispiel-Brief ansehen

Vom Brief zur Prüfung

  1. 01
    Ziele definieren

    Listen Sie auswählbare Objekte auf und entscheiden Sie, ob verschachtelte Meshes oder Instanzen eigene Ziele sind.

  2. 02
    Eingabe zuordnen

    Normalisieren Sie Zeigerpositionen anhand des Canvas-Rechtecks und führen Sie das Raycasting über die aktive Kamera aus.

  3. 03
    Steuerung abstimmen

    Behandeln Sie Navigationskonflikte während der Manipulation und stellen Sie das Feedback wieder her, wenn sich die Selektion ändert.

02 Einsatzbereiche

Wann Sie es nutzen

Ein funktionierendes Three.js-Projekt mit Renderer; prüfen Sie die Quellbeispiele anhand der installierten Version. Weitere Controls und Loader hängen vom gewählten Weg ab.

Gut geeignet

  • ProduktkonfiguratorenWählen Sie ein Produktteil aus und heben Sie genau dieses Objekt hervor oder lösen Sie dafür eine Aktion aus.
  • SzeneneditorenNutzen Sie Transform- oder Drag-Controls, um ausgewählte Geometrie zu verschieben, zu drehen und zu skalieren.

Zu prüfende Grenzen

  • Barrierefreiheit ist ein eigenes ThemaZeigerbeispiele allein belegen noch keinen Zugang per Tastatur oder assistiver Technologie.
  • Lebenszyklus muss geprüft werdenPrüfen Sie die Controls-APIs und räumen Sie Event-Handler in der tatsächlichen Anwendung auf.

Diese Eingaben mitbringen

  • SzenenhierarchieBestimmen Sie auswählbare Meshes und Instanzen.
  • Canvas-PlatzierungGeben Sie die tatsächlich eingebettete Ansicht und die aktive Kamera an.
  • EingabeverhaltenLegen Sie Navigation, Manipulation, Touch und alternative Steuerungen fest.

03 Wichtige Entscheidungen

Entscheidende Punkte

  1. Präzise Normalisierung

    Canvas-relative Koordinaten verhindern, dass die Auswahl im Seitenlayout verrutscht.

  2. Zuständigkeit für Interaktionen

    Das Deaktivieren konkurrierender Controls gibt jeder Geste einen klaren Zweck.

04 Beispielbriefing

Mit einem fokussierten Brief ausprobieren

Der folgende Beispiel-Brief wurde nicht getestet. Prüfen Sie vor der Verwendung die Einrichtung des Skills.

Einrichtung prüfen

Verwenden Sie das passende threejs-skills-Verzeichnis als Agent-Anleitung. Es ist nicht die Three.js-Laufzeit und installiert keine Szenen-Assets.

Quelldatei im Upstream
https://github.com/CloudAI-X/threejs-skills/blob/b1c623076c661fc9b03dac19292e825a5d106823/skills/threejs-interaction/SKILL.md

Ein funktionierendes Three.js-Projekt mit Renderer; prüfen Sie die Quellbeispiele anhand der installierten Version. Weitere Controls und Loader hängen vom gewählten Weg ab.

Mit einem Ergebnis beginnen

Passen Sie Umfang, Quellmaterial und Vorgaben in diesem Brief an, bevor Sie den Skill ausführen.

Beispiel-Brief
Nutze threejs-interaction, um diesem eingebetteten Produktviewer eine Auswahl hinzuzufügen. Führe Raycasting nur für die aufgeführten Teile mit Canvas-relativen Koordinaten aus. Hebe das ausgewählte Teil hervor und verhindere, dass Orbit-Controls mit dem Ziehen von Objekten kollidieren. Beschreibe eine Tastaturalternative separat.

Ergebnis prüfen

Prüfen Sie die tatsächliche Ausgabe anhand dieser beobachtbaren Kriterien.

  • Die Auswahl bleibt nach Layoutänderungen präzise.
  • Ziehen dreht die Kamera nicht.
  • Alte Hervorhebungen und Listener werden ausdrücklich behandelt.

OpenDesign bietet einen lokalen Design-Arbeitsbereich für Coding-Agenten. Dieser Eintrag bedeutet nicht, dass der Skill mitgeliefert wird oder dass externe Tools, Zugangsdaten und Softwareabhängigkeiten enthalten sind.

05 Quelle und Lizenz

Quelle und Lizenz

Diese Seite beschreibt die unten verlinkte, festgelegte Quellrevision. Verhalten und Anforderungen im Upstream können sich ändern.

Quelleninhaber
CloudAI-X
Lizenz
Nicht bestätigt – prüfen Sie vor einer Wiederverwendung die Upstream-Bedingungen.
Geprüfter Stand
2026-10-07 · b1c623076c66
Redaktionelle Quellenzusammenfassung
Strahlbasierte Objektauswahl, Koordinatenumrechnung, Kamerasteuerung, Selektion und Objektmanipulation.

Eigene Zusammenfassung von OpenDesign auf Grundlage der verlinkten Quelle. Repository-Sterne sind ein datiertes Popularitätssignal, keine Skill-Nutzung und keine Qualitätsbewertung.

06 Fragen vor dem Start

Fragen vor dem Start

Kann es Instanzen unterscheiden?

Das dokumentierte Schnittergebnis enthält instanceId für InstancedMesh.

Warum können Klicks ein eingebettetes Canvas verfehlen?

Eine mögliche Ursache ist, dass die Fensterabmessungen statt des Canvas-Rechtecks verwendet werden.

Deckt es nur die Orbit-Navigation ab?

Nein. Es behandelt mehrere Modelle der Kamerasteuerung sowie Objektziehen und Transformationen.

OpenDesign

Schaffen Sie Raum für die nächste Design-Iteration.

Halten Sie Brief, Quellmaterial und Designarbeit in einem lokalen Arbeitsbereich zusammen. Prüfen Sie die Einrichtung des Skills selbst, bevor Sie ihn in Ihren Workflow aufnehmen.

Quelldatei im Upstream
https://github.com/CloudAI-X/threejs-skills/blob/b1c623076c661fc9b03dac19292e825a5d106823/skills/threejs-interaction/SKILL.md