Instalasi

Panduan ini mencakup semua yang Anda perlukan untuk menginstal Aspose.3D FOSS untuk TypeScript dan memastikan bahwa ia berfungsi dengan benar sebelum Anda menulis skrip pemrosesan 3D pertama Anda.

Prasyarat

Pastikan hal berikut terpasang dan ada di PATH sebelum melanjutkan:

Untuk memeriksa versi Anda:

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

Langkah 1: Buat Proyek (jika diperlukan)

Jika Anda menambahkan Aspose.3D ke proyek TypeScript yang sudah ada, lewati langkah ini dan langsung ke Langkah 2.

Untuk proyek baru:

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

Langkah 2: Instal @aspose/3d

npm install @aspose/3d

Ini menginstal paket dan satu ketergantungan transitive-nya, xmldom, secara otomatis. Tidak diperlukan paket sistem tambahan, addon native, atau kompiler. Instalasi selesai ketika @aspose/3d muncul di package.json di bawah dependencies.

Verifikasi instalasi:

ls node_modules/@aspose/3d

Anda harus melihat direktori paket dengan package.json, file definisi tipe (.d.ts), dan JavaScript yang telah dikompilasi.

Langkah 3: Konfigurasikan TypeScript

Tambahkan atau perbarui tsconfig.json di root proyek Anda dengan pengaturan berikut. Ini diperlukan untuk kompatibilitas penuh dengan definisi tipe perpustakaan dan output CommonJS:

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

Pengaturan kunci dan mengapa penting:

Langkah 4: Verifikasi Instalasi

Buat src/verify.ts dengan tes impor minimal berikut:

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);

Kompilasi dan jalankan:

npx tsc
node dist/verify.js

Expected output:

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

Nama node akar secara default adalah string kosong — scene.rootNode dibuat tanpa argumen nama.

Jika Anda lebih suka melewatkan langkah kompilasi selama pengembangan, jalankan langsung dengan ts-node:

npx ts-node src/verify.ts

Langkah 5: Memulai Cepat: Muat Scene dan Cetak Info Node

Skrip berikut memuat file 3D dan mencetak nama serta tipe entitas setiap node dalam scene. Skrip ini bekerja dengan semua format yang didukung: OBJ, glTF, GLB, STL, 3MF, FBX, atau 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);

Simpan ini sebagai src/quickstart.ts dan jalankan:

npx ts-node src/quickstart.ts

Untuk file OBJ dengan satu mesh bernama Cube, outputnya akan terlihat seperti:

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

Node akar memiliki nama kosong (dicetak sebagai awalan kosong). Node anak mewarisi nama mereka dari file yang dimuat.

Catatan Ketergantungan

Aspose.3D FOSS for TypeScript memiliki tepat satu ketergantungan runtime:

Anda tidak perlu menginstal xmldom secara manual. Itu akan muncul di node_modules setelah perintah instalasi utama. Tidak ada addon native (.node file) dan tidak memerlukan pustaka sistem.

Langkah Selanjutnya

Sekarang library telah diinstal dan diverifikasi:

• Baca Panduan Pengembang untuk panduan lengkap semua area fitur.
• Lihat Fitur dan Fungsionalitas untuk detail dukungan format, pola scene-graph, API material dan animasi, serta contoh kode TypeScript lengkap.