مثال بيانات التعريف الهيكلية لـ glTF

قراءة البيانات الوصفية الهيكلية من ملفات glTF

يُظهر هذا المثال كيفية قراءة البيانات الوصفية الهيكلية من ملف glTF يحتوي على امتداد EXT_structural_metadata باستخدام واجهة برمجة التطبيقات Aspose.3D.

شرح الكود

يقوم الكود C# التالي بتحميل مشهد glTF مع بيانات وصفية هيكلية، ثم يقرأ ويعرض معلومات حول جداول الخصائص وخصائصها:

// تحميل مشهد glTF مع EXT_structural_metadata من ملف
var scene = Scene.FromFile("ComplexType.gltf");

// تحميل البيانات الوصفية الهيكلية من المشهد
var metadata = StructuralMetadata.From(scene);
Console.WriteLine("جارٍ استخراج البيانات الوصفية الهيكلية من ملف glTF المدخل:");

// التنقل عبر جميع جداول الخصائص في البيانات الوصفية
foreach (var propTable in metadata.PropertyTables)
{
    // الحصول على الفئة الهيكلية لجدول الخصائص
    Console.WriteLine($"جدول الخصائص {propTable.Name}، اسم النوع : {propTable.MetaClass.Name}");

    // التنقل عبر جميع الخصائص المعرفة في الفئة الهيكلية
    foreach (var propertyDefinition in propTable.MetaClass.Properties)
    {
        // الحصول على بيانات الخاصية المعرفة في EXT_structural_metadata
        object property = propTable.Values[propertyDefinition.Name];
        
        // استخراج اسم الخاصية، نوعه وقيمة
        Console.WriteLine($"{propertyDefinition.Name} : {propertyDefinition.Type} = {property}");
    }
}

المفاهيم الأساسية

البيانات الوصفية الهيكلية

• توفر فئة StructuralMetadata الوصول إلى البيانات المعرفة في امتداد EXT_structural_metadata
• يسمح هذا الامتداد بتخزين المعلومات الدلالية عن الكائنات ثلاثية الأبعاد
• يمكن أن تحتوي البيانات الوصفية على جداول خصائص تحدد سمات للكائنات في المشهد

جداول الخصائص

• يمثلها فئة PropertyTable
• تحتوي كل جدول على:
  • اسم
  • فئة هيكلية تحدد البنية
  • قيم تحتوي على بيانات الخصائص الفعلية

الفئات الهيكلية

• تُعرّف بواسطة فئة MetaClass
• تصف بنية جدول الخصائص
• تحتوي على مجموعة من تعريفات الخصائص
• يحدد كل تعريف:
  • اسم الخاصية
  • نوع الخاصية
  • سمات البيانات الوصفية الأخرى

الوصول إلى الخصائص

• يتم الوصول إلى الخصائص من خلال القاموس Values لجدول الخصائص
• يكون المفتاح هو اسم الخاصية كما هو محدد في الفئة الهيكلية
• يتم تحويل القيم تلقائيًا إلى الأنواع المناسبة عند الإمكان

يوضح هذا المثال كيفية استخدام Aspose.3D لقراءة ومعالجة البيانات الوصفية الهيكلية من ملفات glTF، مما يتيح للمطورين الوصول إلى معلومات دلالية غنية مخزنة مع هندسة ثلاثية الأبعاد.