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

Aspose.3D FOSS for TypeScript

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

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

توثيق GitHub

مكتبة TypeScript مفتوحة المصدر لمعالجة ملفات ثلاثية الأبعاد

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

تُظهر المكتبة API مخطط مشهد مكتوب بالكامل مبنيًا حول 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 للرسوم البيانية المطبوعة

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

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

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

خيارات الصيغة الواحدة والتحكم بالتنسيق

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

خبرة المطورين

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

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

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

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

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 إلى GLB ثنائي

لإنتاج ملف GLB ثنائي مدمج بدلاً من glTF الافتراضي JSON، مرّر 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؟

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

ما هي الصيغ الثلاثية الأبعاد المدعومة؟

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

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

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

كيف أتركبه؟

تشغيل npm install @aspose/3d. لا تحتاج إلى حزم نظام إضافية أو ملحقات أصلية.

أي نسخ Node.js و TypeScript مدعومة؟

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

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

نعم. جميع الطبقات، الأساليب، enums، وأنواع الخيارات مكتوبة بالكامل مع noImplicitAny وstrictNullChecks تم تمكينها.

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

نعم. فئات خيارات لكل تنسيق مثل ObjLoadOptions وGltfSaveOptions تسمح لك بتحويل المحاور، وتعديل المقياس، والتطبيع العادي دون رمز تحليل مخصص.

أين يمكنني أن أجد الشفرة المصدر؟

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

  

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

 العربية