Installation

هذا الدليل يغطي كل ما تحتاجه لتثبيت Aspose.3D FOSS لـ TypeScript وتأكيد أنه يعمل بشكل صحيح قبل كتابة أول برنامج معالجة ثلاثية الأبعاد الخاص بك.

المتطلبات المسبقة

تأكد من تثبيت ما يلي وعلى نظامك PATH قبل المتابعة:

للتحقق من إصداراتك:

node --version   # v18.x.x or later
npm --version    # 7.x or later
npx tsc --version  # Version 5.x.x

الخطوة 1: إنشاء مشروع (إذا لزم الأمر)

إذا كنت تضيف Aspose.3D إلى مشروع TypeScript موجود، فتخط هذه الخطوة وانتقل مباشرة إلى الخطوة 2.

لمشروع جديد:

mkdir my-3d-project && cd my-3d-project
npm init -y
npm install -D typescript ts-node @types/node

الخطوة 2: تثبيت @aspose/3d

npm install @aspose/3d

يقوم هذا بتثبيت الحزمة واعتمادها المتسلسل الوحيد،, xmldom,، تلقائيًا. لا توجد حزم نظام إضافية أو إضافات أصلية أو مترجمات مطلوبة. يكتمل التثبيت عندما @aspose/3d يظهر في جهازك package.json تحت dependencies.

تحقق من التثبيت:

ls node_modules/@aspose/3d

يجب أن ترى دليل الحزمة مع package.json, ملفات تعريف الأنواع (.d.ts), و JavaScript المترجم.

الخطوة 3: تكوين TypeScript

أضف أو حدّث tsconfig.json في جذر مشروعك مع الإعدادات التالية. هذه مطلوبة لضمان التوافق الكامل مع تعريفات الأنواع للمكتبة وإخراج CommonJS:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

الإعدادات الرئيسية ولماذا هي مهمة:

الخطوة 4: التحقق من التثبيت

إنشاء src/verify.ts مع اختبار الاستيراد الأدنى التالي:

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

const scene = new Scene();
console.log('Aspose.3D FOSS for TypeScript is installed correctly.');
console.log('rootNode name:', scene.rootNode.name);

قم بالترجمة والتشغيل:

npx tsc
node dist/verify.js

Expected output:

Aspose.3D FOSS for TypeScript is installed correctly.
rootNode name:

اسم العقدة الجذرية هو سلسلة فارغة افتراضيًا — scene.rootNode يتم إنشاؤه بدون معامل الاسم.

إذا كنت تفضل تخطي خطوة التجميع أثناء التطوير، فقم بالتشغيل مباشرةً باستخدام ts-node:

npx ts-node src/verify.ts

الخطوة 5: البدء السريع: تحميل مشهد وطباعة معلومات العقدة

السكريبت التالي يحمل ملفًا ثلاثي الأبعاد ويطبع اسم ونوع الكيان لكل عقدة في المشهد. يعمل مع أي تنسيق مدعوم: OBJ، glTF، GLB، STL، 3MF، FBX، أو COLLADA.

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

function printNode(node: Node, depth: number = 0): void {
  const indent = '  '.repeat(depth);
  const entityType = node.entity ? node.entity.constructor.name : '(no entity)';
  console.log(`${indent}${node.name} [${entityType}]`);
  for (const child of node.childNodes) {
    printNode(child, depth + 1);
  }
}

const scene = new Scene();

// Replace 'model.obj' with any supported 3D file path.
// Format is detected automatically from binary magic numbers.
scene.open('model.obj');

console.log('Scene loaded. Node hierarchy:');
printNode(scene.rootNode);

احفظ هذا باسم src/quickstart.ts و قم بتشغيله:

npx ts-node src/quickstart.ts

لملف OBJ يحتوي على شبكة واحدة باسم Cube,، سيظهر الناتج كالتالي:

Scene loaded. Node hierarchy:
 [(no entity)]
  Cube [Mesh]

عقدة الجذر لها اسم فارغ (يُطبع كبادئة فارغة). العقد الفرعية ترث أسمائها من الملف المحمَّل.

ملاحظات الاعتماديات

Aspose.3D FOSS for TypeScript لديها اعتماد تشغيل واحد فقط:

ليس عليك تثبيت xmldom يدويًا. سيظهر في node_modules بعد أمر التثبيت الرئيسي. لا توجد إضافات أصلية (.node ملفات) ولا توجد مكتبات نظام مطلوبة.

الخطوات التالية

الآن بعد أن تم تثبيت المكتبة والتحقق منها:

• اقرأ دليل المطور للحصول على شرح كامل لجميع مجالات الميزة.
• انظر الميزات والوظائف لتفاصيل دعم الصيغ، أنماط مخطط المشهد، واجهات برمجة التطبيقات للمواد والرسوم المتحركة، وأمثلة كاملة على كود TypeScript.