1. المنتجات
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS لـ TypeScript

حمّل، أنشئ، حوّل، وصدر المشاهد ثلاثية الأبعاد من Node.js — مُعَرَّفة بالكامل، مفتوحة المصدر، وجاهزة للإنتاج مع تثبيت npm واحد.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

توثيق GitHub

مكتبة TypeScript مفتوحة المصدر لمعالجة ملفات 3D

Aspose.3D FOSS for TypeScript هي مكتبة مرخصة بموجب رخصة MIT للعمل مع صيغ ملفات 3D في تطبيقات Node.js باستخدام TypeScript. قم بتثبيتها بأمر واحد npm install @aspose/3d وابدأ بقراءة، إنشاء، وكتابة مشاهد 3D في TypeScript فورًا، دون الحاجة إلى إضافات أصلية للترجمة، دون SDKs خارجية للتثبيت، ولا يتطلب أي مُعالج عرض.

المكتبة تُظهر واجهة برمجة تطبيقات رسومية للمشهد مكتوبة بالكامل بالأنواع، مبنية حول Scene، Node، Entity، Mesh، Camera، Light، وTransform، وهو نفس النموذج المفاهيمي المستخدم في أدوات 3D الاحترافية. دعم الصيغ يشمل OBJ (Wavefront، مع تحميل مواد .mtl)، glTF 2.0 وGLB الثنائي (مواد PBR)، STL (ثنائي وASCII، دورة كاملة)، COLLADA (DAE)، 3MF، وFBX. فئات الخيارات الخاصة بكل صيغة مثل ObjLoadOptions وGltfSaveOptions تمنحك تحكمًا دقيقًا في توجيه نظام الإحداثيات، المقياس، تطبيع القواعد، الإخراج الثنائي مقابل JSON، وتحميل المواد.

Aspose.3D FOSS يستهدف Node.js 18، 20، و22+ مع TypeScript 5.0+ ويُترجم إلى CommonJS. تُصدر المكتبة بإعدادات صارمة لمترجم TypeScript (noImplicitAny، strictNullChecks) بحيث يوفر بيئتك المتكاملة إكمالًا تلقائيًا كاملًا وسلامة أثناء التجميع. الاعتماد الوحيد في وقت التشغيل هو xmldom، يتم تثبيته تلقائيًا.

دعم صيغ 3D وAPI مخطط المشهد Typed

  • OBJ / MTL: تحميل ملفات Wavefront OBJ مع تعريفات المواد المصاحبة.
  • glTF 2.0 / GLB: تحميل مواد PBR وإخراج GLB ثنائي عبر GltfSaveOptions.
  • STL: قراءة وكتابة كل من STL الثنائي وASCII مع تحقق كامل من الدورة.
  • COLLADA, 3MF, FBX: دعم إضافي للصيغ مع فئات خيارات خاصة بكل صيغة.
  • أنواع TypeScript الكاملة: كل فئة، طريقة، وخيار مكتوب بنوع قوي باستخدام noImplicitAny وstrictNullChecks.

أين يمكن استخدام Aspose.3D FOSS

  • خطوط أنابيب الأصول في Node.js: استيراد ملفات OBJ، التحقق وإعادة توجيه الهندسة، وتصديرها كـ GLB في بيئة التكامل المستمر.
  • أدوات الألعاب: معالجة دفعة من الشبكات ثلاثية الأبعاد دون الحاجة إلى محرك أو عارض أصلي.
  • سير عمل الطباعة ثلاثية الأبعاد: قراءة، التحقق، وإعادة تصدير ملفات STL و3MF.
  • الخدمات الخلفية بدون خادم: تشغيل نقاط نهاية تحويل 3D في Lambda أو Cloud Functions.
  • ترحيل المحتوى: التحويل بين عائلات الصيغ على نطاق واسع من نص برمجي واحد.

خيارات لكل صيغة والتحكم في الإحداثيات

  • توجيه نظام الإحداثيات: عكس المحاور وضبط المقياس حسب الصيغة باستخدام فئات الخيارات.
  • تطبيع المتجهات العمودية: تطبيع تلقائي للمتجهات العمودية للرؤوس عند التحميل أو الحفظ.
  • الإخراج الثنائي مقابل JSON: اختر GLB المدمج أو glTF القابل للقراءة عبر GltfSaveOptions.
  • التحكم في تحميل المواد: تمكين أو تعطيل تحميل ملفات MTL/الملمس لتسريع التحليل.
  • دقة الجولة الكاملة: يتم الحفاظ على عقد الرسم البياني للمشهد غير المعروفة حرفيًا عند إعادة الحفظ.

تجربة المطور

Aspose.3D برنامج مفتوح المصدر لـ TypeScript يمكن تثبيته بأمر واحد npm install @aspose/3d. لا توجد إضافات أصلية تحتاج إلى تجميع. المكتبة مكتوبة بالكامل بـ TypeScript/JavaScript وتحتوي على تبعية واحدة تُثبت تلقائيًا (xmldom).

توفر واجهة برمجة التطبيقات ذات الأنواع القوية إكمال تلقائي كامل في IDE لكل فئة في مخطط المشهد وخيار الصيغة. تستهدف المكتبة Node.js 18–22+ و TypeScript 5.0+، وتعمل بشكل متماثل على أنظمة Linux CI runners ومحطات عمل المطورين، وهي مرخصة تحت رخصة MIT مع متعقب قضايا مفتوح على GitHub.

تحميل مشهد OBJ وتصديره كـ glTF

قم بالتثبيت باستخدام npm، ثم استخدم الطريقة المتزامنة scene.open() مع ObjLoadOptions لتحميل النموذج مع ملف المادة MTL الخاص به. استدعاء scene.save() بامتداد .gltf يكتب JSON قياسي لـ glTF 2.0؛ يتم استنتاج الصيغة تلقائيًا من امتداد الملف.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";

const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());

// تصدير كملف glTF 2.0 JSON
scene.save("model.gltf");

تحويل STL إلى GLB ثنائي

لإنتاج ملف GLB ثنائي مدمج بدلاً من JSON glTF الافتراضي، مرّر GltfSaveOptions مع binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// حفظ كملف GLB ثنائي مدمج
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

الأسئلة الشائعة

ما هو Aspose.3D FOSS لـ TypeScript؟

إنها مكتبة مجانية مرخصة بموجب MIT لـ TypeScript/Node.js لتحميل، ومعالجة، وحفظ المشاهد ثلاثية الأبعاد دون تثبيت أي ملحق أصلي أو SDK خارجي.

ما هي صيغ 3D المدعومة؟

OBJ (مع .mtl)، glTF 2.0 و GLB، STL (ثنائي و ASCII)، COLLADA (DAE)، 3MF، و FBX. كل تنسيق له فئة خيارات مكتوبة بنوع مخصص.

هل يتطلب إضافات Node.js الأصلية؟

لا. Aspose.3D FOSS لـ TypeScript هو JavaScript/TypeScript نقي. لا يتطلب خطوة تجميع وله اعتماد تشغيل واحد (xmldom) يتم تثبيته تلقائيًا عبر npm.

كيف أقوم بتثبيته؟

نفّذ npm install @aspose/3d. لا توجد حزم نظام إضافية أو ملحقات أصلية مطلوبة.

ما إصدارات Node.js و TypeScript المدعومة؟

Node.js 18، 20، و 22+. TypeScript 5.0+. المكتبة تُترجم إلى CommonJS وتعمل مع إعدادات TypeScript الصارمة.

هل يأتي مع تعريفات TypeScript للأنواع؟

نعم. جميع الفئات، والطرق، والعدادات، وأنواع الخيارات مُعرفة بالكامل باستخدام noImplicitAny و strictNullChecks مفعّلين.

هل يمكنني التحكم في اتجاه نظام الإحداثيات؟

نعم. فئات خيارات لكل تنسيق مثل ObjLoadOptions و GltfSaveOptions تتيح لك عكس المحاور، وضبط المقياس، وتطبيع المتجهات العمودية دون الحاجة إلى كود تحليل مخصص.

أين يمكنني العثور على شفرة المصدر؟

المكتبة مرخصة بموجب رخصة MIT ومستضافة على GitHub. تقارير الأخطاء وطلبات السحب مرحب بها.

  

الدعم وموارد التعلم

 العربية