การติดตั้ง

คู่มือนี้ครอบคลุมทุกอย่างที่คุณต้องการเพื่อติดตั้ง Aspose.3D FOSS สำหรับ 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

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

ผลลัพธ์ที่คาดหวัง:

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 for TypeScript มีการพึ่งพา runtime เพียงหนึ่งรายการ:

คุณไม่จำเป็นต้องติดตั้ง xmldom ด้วยตนเอง. มันจะปรากฏในของคุณ node_modules หลังจากคำสั่งติดตั้งหลัก. ไม่มีส่วนเสริมเนทีฟ (.node ไฟล์) และไม่ต้องการไลบรารีระบบ.

ขั้นตอนต่อไป

ตอนนี้ไลบรารีได้ถูกติดตั้งและตรวจสอบเรียบร้อยแล้ว:

• อ่าน คู่มือผู้พัฒนา เพื่อการเดินผ่านอย่างครบถ้วนของทุกพื้นที่ฟีเจอร์.
• ดู ฟีเจอร์และฟังก์ชันการทำงาน สำหรับรายละเอียดการสนับสนุนรูปแบบ, รูปแบบกราฟฉาก, API วัสดุและแอนิเมชัน, และตัวอย่างโค้ด TypeScript เต็มรูปแบบ.