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 للعمل مع صيغ الملفات ثلاثية الأبعاد في تطبيقات Node.js. قم بتثبيتها بأمر npm install @aspose/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) بحيث يوفّر بيئتك المتكاملة IDE إكمالًا تلقائيًا كاملًا وسلامةً أثناء التجميع. اعتماده الوحيد في وقت التشغيل، xmldom، يتم تثبيته تلقائيًا. لعائلة منتجات المؤسسة، راجع Aspose.3D — Enterprise Product Family.

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

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

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

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

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

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

تجربة المطور

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

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

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

قم بالتثبيت باستخدام npm، ثم استخدم scene.open() مع ObjLoadOptions لتحميل الشبكة مع ملف المادة MTL الخاص بها. كلا open() وsave() متزامنان — لا حاجة إلى await أو ربط الـ Promise. استدعاء 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

تحويل STL إلى Binary GLB

لإنتاج ملف GLB ثنائي مدمج بدلاً من JSON glTF الافتراضي، مرّر GltfSaveOptions مع binaryMode = true. كل من open() وsave() متزامنان — لا يلزم await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary 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. تقارير الأخطاء وطلبات السحب مرحب بها.

  

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

 العربية