كيفية البدء مع Aspose.3D FOSS لـ TypeScript

كيفية البدء مع Aspose.3D FOSS لـ TypeScript

@aspose/3d بالنسبة إلى TypeScript هو حزمة مجانية مرخصة من MIT للشحن والتلاعب، و حفظ الملفات 3D في Node.js - لا تحتاج إلى البنود الأصلية، قابلة للتثبيت من npm.

خطوة بخطوة دليل

الخطوة 1: قم بتثبيت الحزمة

تثبيت من npm (تطلب Node.js 18 أو أحدث):

npm install @aspose/3d@24.12.0

تحقق من التحميل الصحيح:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

الخطوة 2: استيراد الدروس المطلوبة

استيراد الفصول التي تحتاجها من الحزمة:

import { Scene, Node } from "@aspose/3d";

الخطوة 3: تحميل ملف 3D

استخدام scene.open() تحميل أي تنسيق مدعوم.المكتبة تحدد النموذج تلقائيًا من ملف التمديد:

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

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

أو استخدام طريقة المصنع الثابتة:

const scene = Scene.fromFile("model.glb");

الخطوة 4: اجتياز المسرحية الرسمي

المشهد المزدحم هو شجرة من Node الأجسام التي تُدخل في scene.rootNode:

import { Scene, Node } from "@aspose/3d";

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);

الخطوة 5: حفظ إلى تنسيق مختلف

استخدام scene.save() لتصديرها إلى أي تنسيق إخراج مدعوم.المكتبة تظهر تنسيق النسخة من ملف التمديد:

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

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

مشكلات و تصحيحات مشتركة

Error: ENOENT عندما يطلب scene.open() الطريق الذي مرّت به لا يوجد.استخدم مسارًا مطلقًّا أو path.resolve() لضمان مسار الملفات صحيح.

خطأ في النموذج غير المعروف تأكد من أن ملحق الملف يتطابق مع النموذج الحقيقي.تكتشف المكتبة تنسيقًا بواسطة التمديد لـ open() و fromFile().قم بتحويل معيار تنسيق واضح إلى مبالغ.

المشهد الفارغ بعد تحميل بعض تنسيقات الثنائية قد تتطلب خيارات الحمل المحددة.حاول استخدام الإفراط في التحميل الصريح مع خيارات محددة للتنسيق إذا كان الحمل الافتراضي ينتج مشهد فارغ.

خطأ في استيراد TypeScript يتم ربط تعريفات النوع مع الحزمة.مضمون "moduleResolution": "bundler" أو "node16" يُنصَر فيك tsconfig.json.

الأسئلة المتكررة

هل @aspose/3d يتطلب أي بائنات أصلية؟?

لا. الحزمة هي جافا سكريبت / نوعية خالصة مع لا تعتمد على الأصلي. فإنه يعمل على أي منصة تدعم Node.js 18 أو أحدث.

ما هي الإصدارات التي يتم دعمها من Node.js؟?

Node.js 18 أو أحدث.الخريطة تعمل على Windows و macOS و Linux.

هل المكتبة مجانية للاستخدام التجاري؟?

نعم يتم إصدارها بموجب ترخيص MIT. يمكنك استخدامها وتعديلها وإعادة توزيعها لأي غرض، بما في ذلك التطبيقات التجارية.

ما هي الأشكال 3D التي يمكنني قراءة الكتابة؟?

يدعم الحزمة OBJ، STL، glTF 2.0 / GLB، FBX، COLLADA، و PLY لكل من القراءة وكتب.استخدم التمديد القائم على scene.save() - التصدير إلى أي شكل مدعوم.

هل يمكنني إنشاء مشهد 3D من الخرسانة؟?

نعم، بناء A Scene لا توجد أسباب، إضافة الأطفال إلى scene.rootNode,و ، و يُحفظ في النموذج المطلوب.

انظر أيضا

 العربية