AVANT LA MISE EN LIGNE

Compression GLB et compatibilité des visualiseurs

L'extension .glb ne garantit pas que toutes les applications pourront charger le fichier. Vérifiez les extensions utilisées par le résultat et testez-le dans l'application cible.

Adapter les paramètres au chargeur

Ces exigences peuvent se cumuler. Le panneau de résultat indique la compatibilité du fichier produit. Notre aperçu inclut les décodeurs : un aperçu réussi ne prouve donc pas qu'ils sont configurés dans votre application.

Les préréglages utilisent la quantification géométrique par défaut. La désactiver peut supprimer cette exigence, mais Meshopt et les textures converties nécessitent toujours leurs chargeurs respectifs. Vérifiez les extensions indiquées pour le résultat réel.

Utilisation avec Three.js

Pour une géométrie compressée avec Meshopt, enregistrez le décodeur avec GLTFLoader.setMeshoptDecoder(). Pour les textures KTX2, configurez KTX2Loader, détectez la prise en charge par le moteur de rendu et associez-le avec setKTX2Loader(). Servez les fichiers du transcodeur correspondants avec votre application et consultez la documentation de votre version de Three.js.

documentation de GLTFLoader · documentation de KTX2Loader

Exemple : l'original se charge, mais pas l'export Fichier plus petit

Conservez les textures d'origine et exportez deux fois la même source : une fois avec Prudent, puis avec Fichier plus petit. Si seul le second échoue dans votre application, examinez les extensions indiquées et l'erreur du chargeur avant de modifier la géométrie. Cette comparaison oriente vers une exigence de chargement modifiée ; elle ne prouve pas que tout échec vient d'un décodeur absent.

Pour un résultat EXT_meshopt_compression dans Three.js, enregistrez MeshoptDecoder avant le chargement. Réessayez ensuite avec le même fichier exporté. Si vous ne pouvez pas modifier l'application cible, réexporter sans compression est une solution de repli, mais le téléchargement peut être plus volumineux.

Exemple : les textures d'origine fonctionnent, mais KTX2 échoue après déploiement

Gardez les mêmes paramètres de géométrie et comparez les textures d'origine à KTX2. Dans une application Three.js, vérifiez que KTX2Loader est associé et que detectSupport a été appelé. Examinez les requêtes vers basis_transcoder.js et basis_transcoder.wasm. Une réponse 404, ou une page HTML de l'application renvoyée à ces adresses, indique un problème de distribution des fichiers plutôt que de qualité des textures.

Après correction du chargeur ou du chemin des fichiers, retestez le même résultat KTX2, y compris sur un appareil mobile cible. Un fichier qui fonctionne dans l'aperçu de ce site a été chargé avec notre configuration ; votre visualiseur de production doit encore satisfaire ses propres exigences.

Noms, extras et comportement de la scène

Les trois options de préservation sont activées par défaut. Laissez-les actives si votre application recherche les objets ou matériaux par nom, ou lit les extras. Elles ne garantissent pas des indices de nœuds, une hiérarchie, des échantillons d'animation ou des attributs personnalisés identiques. L'optimisation peut fusionner ou réorganiser les données et modifier leur précision.

Testez la sélection, les changements de matériaux, la lecture des animations, les cibles de morphing et les transformations dans l'application réelle. Préserver les extras ne permet pas de conserver n'importe quelle extension personnalisée.

Restrictions sur les fichiers d'entrée

Ce service refuse les fichiers compressés avec Draco, les ressources externes et les extensions obligatoires non prises en charge. Les extensions facultatives inconnues peuvent être supprimées. Au besoin, exportez depuis l'application source un GLB non compressé avec ressources intégrées.

Pour la liste des extensions et le comportement du moteur, consultez la documentation officielle de gltfpack. Le service web applique des validations et limites de ressources supplémentaires.

Charger des modèles gltfpack dans Three.js →