التثبيت

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

المعايير

تأكد من أن التالي يتم تثبيته على 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

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

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

ls node_modules/@aspose/3d

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

الخطوة الثالثة: إعداد 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

الناتج المتوقع :

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

اسم العقد الجذر هو شريط فارغ بشكل افتراضي - scene.rootNode وخلقها بدون اسم.

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

npx ts-node src/verify.ts

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

يُحمل السيناريو التالي ملفًا 3D ويطبع اسم ونوع الكيان لكل عقدة في المشهد، ويعمل بأي شكل مدعوم: OBJ أو GLTF أو 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 الملفات) ولا مكتبات النظام مطلوبة.

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

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

• اقرأ The دليل المطور لمرور كامل من جميع المناطق المميزة.
• انظر الخصائص والوظائف لتفاصيل دعم النموذج، ومحاكاة المسرحية، والمواد والرسائل الرسومية، وعينات كاملة من رمز TypeScript.