Instalacija

Ovaj vodič pokriva sve što trebate za instalaciju Aspose.3D FOSS za TypeScript i potvrdu da ispravno radi prije nego što napišete svoj prvi 3D skript za obradu.

Preduvjeti

Provjerite da su sljedeće instalirane i na vašem PATH prije nastavka:

Za provjeru vaših verzija:

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

Korak 1: Stvorite projekt (ako je potrebno)

Ako Aspose.3D dodajete u postojeći TypeScript projekt, preskočite ovaj korak i izravno prijeđite na Korak 2.

Za novi projekt:

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

Korak 2: Instalirajte @aspose/3d

npm install @aspose/3d

Ovo instalira paket i njegovu jedinu transitivnu ovisnost, xmldom, automatski. Nisu potrebni dodatni sustavni paketi, izvorni dodatci ili kompajleri. Instalacija je dovršena kada @aspose/3d se pojavi u vašem package.json u dependencies.

Provjerite instalaciju:

ls node_modules/@aspose/3d

Trebali biste vidjeti direktorij paketa s package.json, datoteke definicija tipova (.d.ts), i kompajliranim JavaScript-om.

Korak 3: Konfigurirajte TypeScript

Dodajte ili ažurirajte tsconfig.json u korijenu vašeg projekta s sljedećim postavkama. Ovo je potrebno za potpunu kompatibilnost s definicijama tipova biblioteke i CommonJS izlazom:

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

Ključne postavke i zašto su važne:

Korak 4: Provjerite instalaciju

Kreiraj src/verify.ts sa sljedećim minimalnim testom uvoza:

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

Kompilirajte i pokrenite:

npx tsc
node dist/verify.js

Expected output:

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

Naziv korijenskog čvora je po zadanom prazan string — scene.rootNode se stvara bez argumenta naziva.

Ako radije preskočite korak kompilacije tijekom razvoja, pokrenite izravno s ts-node:

npx ts-node src/verify.ts

Korak 5: Brzi početak: Učitajte scenu i ispišite informacije o čvorovima

Sljedeći skript učitava 3D datoteku i ispisuje naziv i tip entiteta svakog čvora u sceni. Radi s bilo kojim podržanim formatom: OBJ, glTF, GLB, STL, 3MF, FBX ili 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);

Spremite ovo kao src/quickstart.ts i pokrenite ga:

npx ts-node src/quickstart.ts

Za OBJ datoteku s jednim mrežom pod nazivom Cube, izlaz će izgledati ovako:

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

Korijenski čvor ima prazan naziv (ispisan kao prazni prefiks). Podčvorovi nasljeđuju svoje nazive iz učitane datoteke.

Napomene o ovisnostima

Aspose.3D FOSS za TypeScript ima točno jednu runtime ovisnost:

Ne trebate instalirati xmldom ručno. Pojavit će se u vašem node_modules nakon glavne naredbe za instalaciju. Nema izvornih dodataka (.node datoteke) i ne zahtijevaju se sustavne biblioteke.

Sljedeći koraci

Sada kada je biblioteka instalirana i provjerena:

• Pročitajte Vodič za programere za potpuni pregled svih područja značajki.
• Pogledajte Značajke i funkcionalnosti za detalje o podršci formata, obrascima scene-graph, API-ima za materijale i animacije, te potpune TypeScript primjere koda.