GLTF-Import
Externe 3D-Modelle importieren
Übersicht
Das GLTF-Element ermöglicht den Import externer 3D-Modelle im GLTF-Format (GL Transmission Format) in Ihre Szene. GLTF ist ein Standarddateiformat für 3D-Szenen und -Modelle, das in webbasierten 3D-Anwendungen weit verbreitet ist.
Hauptmerkmale
- Import von GLTF (.gltf) und GLB (.glb) Dateien
- Volle Positions-, Rotations- und Skalierungskontrolle
- Erhaltung von Materialien und Texturen
- Unterstützung für Animationen (wenn verfügbar)
Unterstützte Formate
GLTF
.gltf
JSON-Format mit externen Assets
GLB
.glb
Binärformat (empfohlen)
GLB wird empfohlen, da alle Assets in einer einzigen Datei verpackt sind.
Parameter
Konfigurieren Sie Ihren GLTF-Import.
url
URL oder Pfad zur GLTF-Datei
models/chair.glb
x, y, z
Position im 3D-Raum
0, 0, 0
rx, ry, rz
Rotationswinkel in Grad
0, 45, 0
scale
Einheitlicher Skalierungsfaktor
1.0
Verwendungsbeispiel
Importieren Sie ein 3D-Modell in Ihre Szene.
Einfacher Import
gltf
models/furniture.glb
0
0
0
1.0
Dies importiert das Möbelmodell am Ursprung mit normaler Skalierung.
Rotierter und skalierter Import
gltf
models/chair.glb
100
0
50
45
0.5
Dies importiert ein Stuhlmodell an Position (100, 0, 50), um 45 Grad gedreht, mit halber Größe.
Best Practices
Tipps für die Arbeit mit GLTF-Importen.
Dateivorbereitung
- Verwenden Sie optimierte GLTF-Dateien für gute Performance
- Halten Sie Modelldateigrößen für Web-Loading angemessen
- Verwenden Sie das komprimierte GLB-Format für binäre Effizienz
- Zentrieren Sie Ihr Modell vor dem Export am Ursprung
- Verwenden Sie eine konsistente Skalierung (Meter empfohlen)
Import-Tipps
- Optimieren Sie Modelle vor dem Import (Polygonzahl reduzieren)
- Verwenden Sie das GLB-Format für beste Ergebnisse mit Texturen
- Testen Sie Modelle vor der Bereitstellung auf Kompatibilität
- Verwenden Sie geeignete Skalierung passend zu Ihren Szeneneinheiten
Performance-Überlegungen
- Verwenden Sie komprimierte Texturen wenn möglich
- Optimieren Sie Modellgeometrie vor dem Import
- Erwägen Sie LOD-Versionen (Level of Detail) für komplexe Modelle
- Cachen Sie häufig verwendete Modelle
- Überwachen Sie die Speichernutzung beim Laden mehrerer Modelle
Häufige Probleme und Lösungen
Lösungen für häufig auftretende Probleme.
Modell lädt nicht
Überprüfen Sie, ob der URL-Pfad korrekt und die Datei erreichbar ist. Stellen Sie sicher, dass die Datei ein gültiges GLTF/GLB-Format ist und CORS-Header den Zugriff erlauben, wenn von einer anderen Domain geladen wird.
Modell erscheint zu groß oder klein
Passen Sie den Skalierungsparameter an, um ihn an Ihre Szenenskalierung anzupassen. Modelle können in unterschiedlichen Maßstäben exportiert werden (z.B. Zentimeter vs. Meter).
Falsche Modellausrichtung
Verwenden Sie Rotationsparameter (rx, ry, rz) zur Korrektur der Ausrichtung. Häufige Anpassungen umfassen 90-Grad-Rotationen zum Wechsel zwischen Y-Up- und Z-Up-Konventionen.
Fehlende Texturen
Verwenden Sie das GLB-Format anstelle von GLTF, um sicherzustellen, dass Texturen eingebettet sind. Bei GLTF-Dateien stellen Sie sicher, dass Texturdateien in den korrekten relativen Pfaden liegen.