VOR DEM EINSATZ

GLB-Kompression und Viewer-Kompatibilität

Die Dateiendung GLB garantiert nicht, dass jede Anwendung ihren Inhalt laden kann. Prüfe die in der Ausgabe verwendeten Erweiterungen und teste deine Zielanwendung.

Einstellungen auf den Loader abstimmen

Diese Anforderungen können gemeinsam auftreten. Das Ergebnisfeld zeigt Kompatibilitätsinformationen für deine Ausgabe. Unsere Vorschau enthält Decoder; eine erfolgreiche Vorschau bedeutet daher nicht, dass diese auch in deiner Anwendung eingerichtet sind.

Die Vorgaben verwenden standardmäßig Geometriequantisierung. Wenn du sie deaktivierst, kann deren Unterstützungsanforderung entfallen. Meshopt oder umgewandelte Texturen benötigen aber weiterhin ihre passenden Loader. Prüfe die für das tatsächliche Ergebnis gemeldeten Erweiterungen.

Three.js verwenden

Registriere für Meshopt-komprimierte Geometrie den Decoder mit GLTFLoader.setMeshoptDecoder(). Konfiguriere für KTX2-Texturen den KTX2Loader, ermittle die Unterstützung durch den Renderer und binde ihn mit setKTX2Loader() ein. Stelle die passenden Transcoder-Dateien mit deiner Anwendung bereit und verwende die Dokumentation für deine Three.js-Version.

GLTFLoader-Dokumentation · KTX2Loader-Dokumentation

Beispiel: Das Original lädt, der Export mit „Kleinere Datei“ jedoch nicht

Behalte die Originaltexturen und exportiere dieselbe Quelle zweimal: einmal mit „Konservativ“ und einmal mit „Kleinere Datei“. Schlägt in deiner Anwendung nur die zweite Datei fehl, prüfe die gemeldeten Erweiterungen und den Loader-Fehler, bevor du Geometrieeinstellungen änderst. Dieser Vergleich grenzt das Problem auf eine geänderte Ladeanforderung ein; er beweist nicht, dass bei jedem Fehler ein Decoder fehlt.

Registriere bei einer Ausgabe mit EXT_meshopt_compression in Three.js den MeshoptDecoder vor dem Laden. Teste anschließend dieselbe exportierte Datei erneut. Kann die Zielanwendung nicht geändert werden, ist ein erneuter Export ohne Kompression eine Ausweichlösung — gegebenenfalls mit größerem Download.

Beispiel: Originaltexturen funktionieren, KTX2 nach der Bereitstellung nicht

Lasse die Geometrieeinstellungen unverändert und vergleiche Originaltexturen mit KTX2. Prüfe in einer Three.js-Anwendung, ob KTX2Loader eingebunden und detectSupport ausgeführt wurde. Untersuche die Anfragen für basis_transcoder.js und basis_transcoder.wasm. Eine 404-Antwort oder eine HTML-Anwendungsseite unter diesen URLs deutet auf die Dateibereitstellung statt auf die Texturqualität hin.

Teste dieselbe KTX2-Ausgabe nach der Korrektur des Loaders oder Dateipfads erneut, auch auf einem vorgesehenen Mobilgerät. Eine Datei, die in der Vorschau dieser Website lädt, funktioniert mit deren Viewer-Konfiguration; dein produktiver Viewer muss seine Ladeanforderungen selbst erfüllen.

Namen, extras und Szenenverhalten

Die drei Erhaltungsoptionen sind standardmäßig aktiviert. Lasse sie aktiv, wenn deine Anwendung Objekte oder Materialien über Namen findet oder extras ausliest. Sie garantieren keine identischen Knotenindizes, Hierarchien, Animationsabtastungen oder benutzerdefinierten Attribute. Die Optimierung kann Daten zusammenführen, neu ordnen und ihre Genauigkeit verändern.

Teste Auswahl, Materialwechsel, Animationswiedergabe, Morph-Targets und Objekttransformationen in der tatsächlichen Anwendung. „extras erhalten“ bewahrt keine beliebigen benutzerdefinierten Erweiterungen.

Eingabebeschränkungen

Dieser Dienst lehnt Draco-komprimierte Eingaben, externe Ressourcen und nicht unterstützte erforderliche Erweiterungen ab. Unbekannte optionale Erweiterungen können entfallen. Exportiere bei Bedarf eine unkomprimierte GLB-Datei mit eingebetteten Ressourcen aus der Quellanwendung.

Zur Erweiterungsliste und zum Optimierungsverhalten der Engine siehe die gltfpack-Dokumentation des Ursprungsprojekts. Der Webdienst wendet zusätzliche Prüfungen und Ressourcengrenzen an.

gltfpack-Modelle in Three.js laden →