ההתקנה

מדריך זה מכסה את כל מה שאתה צריך כדי להתקין Aspose.3D FOSS עבור TypeScript ולוודא כי הוא עובד כראוי לפני שתכתוב את הסקריפט הראשון שלך עיבוד 3D.

Prerequisites

ודא שהמכשיר הבא מותקן על ידי 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.

שלב 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

תוצאות צפויות:

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

שם הקוטב השורש הוא שורה ריקה לפי דפוס - scene.rootNode הוא נוצר ללא תובנות שמות.

אם אתה מעדיף לפספס את השלב המורכב במהלך הפיתוח, לרוץ ישירות עם ts-node:

npx ts-node src/verify.ts

שלב 5: התחלה מהירה: להעלות את הסצנה ולדפוס מידע על נוטים

הסקריפט הבא מחזיק בקובץ 3D ומדפיס את שם וסוג האופי של כל כפתור בסצנה.זה עובד עם כל פורמט תומך: 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 עבור TypeScript יש בדיוק אחד זמן עבודה תלוי:

אין צורך להתקין xmldom תגיות: יופיע בך node_modules אין להן את הכתובת המלאה (אין להנות מהתכנית).node קבצים) ואין ספריית מערכת נדרשת.

שלבים הבאים

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

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

ראה גם

• Aspose.3D עבור TypeScript - מסמכים עסקיים