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 קבצים) ואין צורך בספריות מערכת.

צעדים הבאים

עכשיו שהספרייה מותקנת ומאומתת:

• קרא את מדריך למפתחים להדרכה מלאה על כל תחומי הפונקציונליות.
• ראה תכונות ופונקציונליות לפרטים על תמיכת פורמטים, תבניות גרף סצנה, API של חומרים והנפשה, ולדוגמאות קוד TypeScript מלאות.