دليل المطور

Aspose.3D FOSS for TypeScript هو مكتبة مفتوحة مصممة بتمويل MIT التي تسمح للمطورين Node.js بإعادة إنتاج وتصنيع وتصدير صور 3D مع أمن نوع TypeScript الكامل. سواء كنت تُصنع خطوط الأصول أو خدمة تحويل المكونات أو أداة تحديد الجينومتر أو نسخة كتابة المحتوى 3D، هذا المكتبة توفر API خالصًا ومستمرًا يدعمها نموذج صورة تكوين التي تتبع فكرة 3D المعتمدة في الصناعة.

يغطي هذا دليل التطوير كل ما تحتاجه لتذهب إلى أكثر من إعداد البدء السريع وتصوير رمزًا معينًا لإنتاج 3D.

ما ستجد في هذا القسم

الميزات والفعاليات

ال الميزات الصفحة هي المرجع الأساسي للعمل مع Aspose.3D FOSS لـ TypeScript. تغطي:

  • دعم الصيغ: OBJ (مع مواد .mtl)، glTF 2.0 / GLB ثنائي، STL (ثنائي وASCII)، COLLADA (DAE)، 3MF، و FBX، مع فئات خيارات التحميل والحفظ لكل صيغة تشمل ObjLoadOptions و GltfSaveOptions.
  • مخطط المشهد: كيف Scene, Node, Entity, Transform, و SceneObject يتكوّن في تسلسل هرمي كامل للمشهد، بما في ذلك أنماط تجوال العقد الفرعية.
  • واجهة برمجة التطبيقات للجيومتري والشبكة: العمل مع Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, و ReferenceMode لمعالجة الهندسة.
  • نظام المواد: تطبيق LambertMaterial, PhongMaterial, و PbrMaterial (PBR for glTF) إلى عقد المشهد، وقراءة خصائص المواد المحملة من ملفات .mtl.
  • أدوات الرياضيات: استخدام Vector3, Vector4, Matrix4, Quaternion,، و BoundingBox للتحويلات، استعلامات الصناديق المحيطة، والحسابات الهندسية.
  • الرسوم المتحركة: الإنشاء والقراءة AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation,، و Extrapolation البيانات.
  • دعم البث والذاكرة المؤقتة: تحميل مشاهد ثلاثية الأبعاد من الذاكرة Buffer كائنات عبر scene.openFromBuffer() لحالات الاستخدام بدون خادم والبث.
  • أمثلة الاستخدام الكاملة: سكريبتات TypeScript شاملة من البداية إلى النهاية لتحميل OBJ، وتصدير GLB، وإعادة تحويل STL، وتصفح رسومات المشهد.
  • نصائح، مشكلات شائعة، والأسئلة المتكررة: إرشادات عملية لتجنب الأخطاء الشائعة في الاستخدام الإنتاجي.
  • ملخص مرجع API: قائمة مرجعية سريعة بجميع الفئات الرئيسية وأساليبها الأساسية.

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

رسم المشهد: جميع المحتوى ثلاثي الأبعاد في Aspose.3D FOSS يُمثَّل كشجرة من Node كائنات جذورها في scene.rootNode. يمكن لكل عقدة أن تحمل an Entity (مثل Mesh, Camera, أو Light) و a Transform الذي يضعه في التسلسل الهرمي.

API غير معتمد على الصيغة: يمكنك فتح أي صيغة مدعومة عبر scene.open() أو scene.openFromBuffer() وتُحفظ إلى أي صيغة مدعومة عبر scene.save(). تُستخدم نفس كائنات مخطط المشهد بغض النظر عن صيغة المصدر أو الوجهة.

أنواع TypeScript قوية: المكتبة تُوزَّع بإعدادات مترجم صارمة (noImplicitAny, strictNullChecks) وتعريفات نوعية كاملة. كل فئة، طريقة، وخصية خيار مكتوبة بالكامل، مما يمنحك إكمال تلقائي في IDE وأمان وقت الترجمة عبر كامل كود معالجة الـ3D الخاص بك.

اعتماد واحد: الاعتماد الوحيد أثناء التشغيل هو xmldom, الذي يتم تثبيته تلقائيًا عبر npm. لا توجد إضافات أصلية للتجميع ولا حزم نظام لتثبيتها.

البدء

إذا لم تقم بعد بتثبيت المكتبة، راجع الـ البدء قسم و الـ التثبيت دليل قبل المتابعة في القراءة.

المواضيع المتاحة

 العربية