Tiny Online Tools
Le validateur officiel, dans votre navigateur
Ce n'est pas une réimplémentation. L'outil exécute le glTF-Validator de Khronos — le moteur même qui alimente le validateur officiel en ligne et les contrôles d'export intégrés à plusieurs logiciels DCC — compilé en JavaScript et exécuté localement sur votre machine.
Cette différence compte quand c'est vous qui devez annoncer à un fournisseur que son export est cassé. « Le validateur officiel de Khronos signale ACCESSOR_INDEX_OOB à /meshes/3/primitives/0/indices » est une conversation qui se termine vite. « Un site m'a dit que ça n'allait pas » beaucoup moins.
Lire les niveaux de gravité
Le validateur rapporte quatre niveaux, qui ne sont pas également alarmants.
Les erreurs signifient que le fichier viole la spécification glTF 2.0. Une visionneuse permissive peut tout de même l'ouvrir — three.js est particulièrement indulgent — mais vous n'avez aucune garantie pour les autres implémentations. Corrigez-les.
Les avertissements signalent des choses licites mais presque certainement involontaires : un accessor dont les min/max déclarés ne correspondent pas aux données, une texture sans image, un nœud avec une transformation identité et sans enfants.
Les informations et les conseils sont indicatifs. UNUSED_OBJECT et NODE_EMPTY apparaissent dans quantité d'assets de production parfaitement sains : l'exporteur a laissé un nœud auxiliaire, rien de plus. Un fichier propre avec neuf conseils reste un fichier propre.
Valider un .gltf avec des fichiers externes
Un .gltf est un document JSON qui pointe vers des tampons .bin et des images séparés. Si vous validez le JSON seul, chacune de ces références est signalée comme ressource manquante et le rapport devient inutilisable.
Ajoutez les fichiers associés dans le second sélecteur et ils seront correctement résolus. Ce qui manque encore est listé explicitement — ce qui constitue en soi un vrai constat, car un .gltf livré sans son .bin est une livraison incomplète.
Constats fréquents et ce qu'ils signifient
ACCESSOR_INDEX_OOB— un tampon d'indices référence un sommet inexistant. Presque toujours un exporteur défaillant ou un fichier tronqué.ACCESSOR_MIN_MISMATCH/ACCESSOR_MAX_MISMATCH— les bornes déclarées ne correspondent pas aux données réelles. Casse le culling par frustum et tout consommateur qui se fie à l'en-tête.MESH_PRIMITIVE_NO_POSITION— une primitive sans positions de sommets. Rien ne peut la rendre.UNSUPPORTED_EXTENSION— le fichier utilise une extension que le validateur ne connaît pas. Pas forcément incorrect, mais à vérifier auprès de votre moteur cible.MESH_PRIMITIVE_TANGENT_WITHOUT_NORMAL— des tangentes sans normales, ce qui n'a aucun sens.UNUSED_OBJECT— un élément défini et jamais référencé. Inoffensif, mais c'est du poids mort dans le fichier.
Le récapitulatif de l'asset
Au-delà de la liste des problèmes, le validateur donne les chiffres qui comptent pour la performance : appels de rendu, totaux de sommets et de triangles, nombre maximal de jeux d'UV et nombre maximal d'influences d'os par sommet. Ce dernier mérite l'attention : beaucoup de pipelines mobiles plafonnent à quatre influences, et un modèle créé avec huit se déformera mal au lieu d'échouer franchement.
Confidentialité
Le validateur s'exécute en JavaScript dans votre navigateur. Aucun fichier, tampon ni texture n'est téléversé, ce qui le rend sûr pour les travaux clients et les assets non publiés.