مقدمة
ونحن سعداء أن نعلن عن توافر Aspose.3D FOSS لـ TypeScript كما هو الحال مع @aspose/3d هذا المكتبة مرخصة من MIT يجلب جودة الإنتاج معالجة المشهد 3D إلى تطبيقات TypeScript و Node.js دون الحاجة إلى البنود الأصلية، وسلاسل الأدوات المنصوص عليها في المنصة، أو التراخيص التجارية.
تم تصميم المكتبة حول مساحة بسيطة. Scene API: تحميل ملف 3D مع scene.open(), فحص أو تحويل الرسم البياني للمشهد, وكتب النتيجة مع scene.save().تعريفات نوع TypeScript الكاملة مترابطة؛ لا تفرق بينها. @types/ الحزمة مطلوبة.
الميزات الرئيسية
تنسيق متعدد I/O. ويقرأ الحزمة ويكتب ستة تنسيقات 3D الرئيسية في تثبيت واحد. OBJ، glTF 2.0، GLB، STL، 3MF، و COLLADA كلها تدعم كل من الواردات والتصدير. FBX المستورد / الصادرات الفصول موجودة ولكن لا يوجد بعد التعرف الذاتي على النموذج، لذلك لا يمكن تحميل ملفات FB X عبر scene.open().
الدعم الأول TypeScript. جميع الفصول العامة، والقوائم، ونوع الخيارات مكتوبة بالكامل. IDEs مع دعم خدمة اللغة TypeScript (VS Code، WebStorm، إلخ) توفر التكملة الذاتية الدقيقة وتوثيق خطوط لكل مكالمة API.
Node.js 18-22+ متوافق مع نظام التشغيل. يتم اختبار الحزمة ضد إصدارات Node.js 18 و 20 و 22 LTS. لا يتم تجميع الإضافات الأصلية أثناء التثبيت ، لذلك يعمل على جميع المنصات التي تدعمها Noda.js.
إحدى الإدمانات المباشرة. والسبب الوحيد في الاعتماد هو xmldom,، تستخدم حصريًا لـ COLLADA XML parsing. جميع النماذج الأخرى هي تنفيذه JavaScript النقي.
مجوز MIT . استخدام @aspose/3d في المشاريع التجارية أو المفتوحة المصدر، أو الداخلية دون قيود.
بدء سريع
قم بتثبيت الحزمة :
asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.تحميل ملف OBJ وتحويلها إلى GLB ثنائي:
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';
const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true; // produce a single .glb file
scene.save('output.glb', GltfFormat.getInstance(), saveOpts);
console.log('Converted to GLB successfully');
إطالة فوق عقدة المشهد لفحص الهندسة:
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
for (const node of scene.rootNode.childNodes) {
console.log(`Node: ${node.name}`);
if (node.entity) {
console.log(` Entity type: ${node.entity.constructor.name}`);
}
}
تنسيقات مدعومة
| شكل | التمديد | استيراد | تصدير | ملاحظات |
|---|---|---|---|---|
| OBJ | .obj | نعم | نعم | Wavefront OBJ؛ القراءة / الكتابة .mtl المواد الملفات |
| GLTF | .gltf / .glb | نعم | نعم | GLTF 2.0 JSON و GLB الثنائية |
| STL | .stl | نعم | نعم | ASCII و STL الثنائي |
| 3MF | .3mf | نعم | نعم | أرشيف الاتفاقية المفتوحة للتعبئة والتغليف |
| FBX | .fbx | لا * | لا * | المستورد/المصدر موجود ولكن تنسيق الكشف الذاتي غير مدمج |
| COLLADA | .dae | نعم | نعم | مطلوبات مترابطة xmldom الاعتماد |
مزايا TypeScript
العمل مع @aspose/3d في TypeScript يلتقط أخطاء الفئة في وقت النسخ بدلاً من في الوقت الحالي. scene.save(), يثبت المكون أن الخيارات الموضوع يتوافق مع المتوقع SaveOptions خيارات تحميل و حفظ محددة النموذج يظهر فقط الخصائص ذات الصلة لهذا النمط؛ لا يوجد كيس الخيارات غير المسمى للتخمين.
على سبيل المثال،, GltfSaveOptions.binaryMode هو نوع من boolean,ورفض الكاتب saveOpts.binaryMode = 'yes' قبل أي رمز يعمل. خصائص الرسوم المتحركة على AnimationClip,قنوات المواد على PbrMaterial,- أنواع العناصر المتصلة على VertexElement يتم كتابة جميعها بشكل مماثل ويمكن اكتشافها من خلال IntelliSense دون استشارة الوثائق الخارجية.
المصدر المفتوح
يتم نشر هذا الحزمة تحت رخصة MIT.يتوفر رمز المصدر على موقع GitHub.المساهمات، وتقارير الأخطاء، وطلبات دعم النموذج مرحبا بكم من خلال متابعة المشكلة في المستودع.
يمتلك المكتبة إحدى أوقات العمل: xmldom (^0.6.0) ، تستخدم فقط عند قراءة أو كتابة ملفات COLLADA. جميع المراسلين والكاتب الآخرين هي التطبيقات النقية جوجل ذاتية الحفاظ مع لا مكونات ثنائية.
بدءاً من
- npm:
npm install @aspose/3d - قاعدة المعرفة: كيفية تحميل النماذج 3D في TypeScript
- قاعدة المعرفة: كيفية تصدير المشاهد 3D إلى glTF/GLB في TypeScript
- إشارة API: Aspose.3D FOSS لـ TypeScript: مرجع الدرجة الكاملة
- GitHub: أسيوط 3D / الأسيوطي 3d
استنتاجات
@aspose/3d الإصدار 24.12.0 يوفر أساسًا مستقرًّا ومكتوبًًَّا ومتأثرًًَى لمعالجة الملفات 3D في TypeScript و Node.js سواء كان حالة الاستخدام تحويل النموذج أو فحص المشهد أو استخراج الهندسة الجيومترية أو دمج الأنابيب ، فإن مكتبة تغطي أكثر تنسيقات التبادل 3d شيوعً.
قم بتثبيته اليوم واتركنا نعرف ما تقوم بإنشائه.