مدقق GLTF وGLB

المدقق الرسمي، داخل متصفحك

هذه ليست نسخة مُعاد كتابتها. إنها تشغّل مدقق Khronos glTF-Validator — المحرك نفسه الذي يقوم عليه المدقق الرسمي على الإنترنت وفحوص التصدير المدمجة في عدة برامج DCC — مُصرَّفًا إلى JavaScript ومنفَّذًا محليًا على جهازك.

هذا الفارق مهم حين تكون أنت من يخبر مورّدًا بأن تصديره معطوب. فجملة «يبلّغ مدقق Khronos الرسمي عن ACCESSOR_INDEX_OOB عند /meshes/3/primitives/0/indices» تنهي النقاش سريعًا، أما «موقع ما قال إن فيه خطأ» فلا.

كيف تقرأ مستويات الخطورة

يبلّغ المدقق عن أربعة مستويات، وهي ليست متساوية في الخطورة.

الأخطاء تعني أن الملف يخالف مواصفة glTF 2.0. قد يفتحه عارض متساهل — وthree.js متسامح بوجه خاص — لكن لا ضمانة لأي تطبيق آخر. صحّح هذه.

التحذيرات تشير إلى أمور مسموح بها لكنها شبه مؤكدة أنها غير مقصودة: مُوصِّل (accessor) لا تطابق قيمه المعلنة min/max بياناته الفعلية، أو قوام بلا صورة، أو عقدة بتحويل محايد وبلا أبناء.

المعلومات والتلميحات إرشادية فقط. فرسائل UNUSED_OBJECT وNODE_EMPTY تظهر في كثير من الأصول الإنتاجية السليمة تمامًا: ترك المصدِّر عقدة مساعدة، لا أكثر. الملف النظيف الذي يحمل تسعة تلميحات يبقى ملفًا نظيفًا.

التحقق من ملف ‎.gltf‎ مع ملفات خارجية

ملف .gltf هو مستند JSON يشير إلى مخازن .bin وصور منفصلة. وإذا دقّقت الـ JSON وحده، فسيُبلَّغ عن كل مرجع منها كمورد مفقود ويصبح التقرير بلا فائدة.

أضف الملفات المرافقة في المنتقي الثاني لتُحلّ المراجع كما ينبغي. وما يبقى مفقودًا يُذكر صراحةً، وهذا بحد ذاته نتيجة حقيقية: فملف .gltf يُسلَّم بدون ملف .bin الخاص به هو تسليم ناقص.

نتائج شائعة ومعناها

• ACCESSOR_INDEX_OOB — يشير مخزن الفهارس إلى رأس غير موجود. والسبب غالبًا مصدِّر معطوب أو ملف مبتور.
• ACCESSOR_MIN_MISMATCH / ACCESSOR_MAX_MISMATCH — الحدود المعلنة لا تطابق البيانات الفعلية. يعطّل ذلك الاقتطاع بالهرم البصري وكل مستهلك يثق بالترويسة.
• MESH_PRIMITIVE_NO_POSITION — عنصر أولي بلا مواضع رؤوس، فلا شيء يستطيع رسمه.
• UNSUPPORTED_EXTENSION — يستخدم الملف امتدادًا لا يعرفه المدقق. ليس خطأً بالضرورة، لكن يُستحسن التأكد من دعم محركك المستهدف له.
• MESH_PRIMITIVE_TANGENT_WITHOUT_NORMAL — مماسّات بلا نواظم، وهو أمر بلا معنى.
• UNUSED_OBJECT — عنصر مُعرَّف ولا يُشار إليه أبدًا. غير ضار، لكنه وزن زائد داخل الملف.

ملخّص الأصل

إلى جانب قائمة المشكلات، يعرض المدقق الأرقام التي تهم الأداء: نداءات الرسم، وإجمالي الرؤوس والمثلثات، وأقصى عدد لمجموعات UV، وأقصى عدد لتأثيرات العظام لكل رأس. وهذا الأخير يستحق الانتباه، إذ تحدّد كثير من مسارات العمل على الأجهزة المحمولة السقف عند أربعة تأثيرات، والنموذج المصنوع بثمانية سيتشوّه بصمت بدل أن يفشل بوضوح.

الخصوصية

يعمل المدقق بلغة JavaScript داخل متصفحك. لا يُرفع أي ملف أو مخزن أو قوام، ما يجعله آمنًا لأعمال العملاء والأصول غير المنشورة.