Instalacija

Ovaj vodič pokriva sve što je potrebno da instalirate Aspose.3D FOSS za TypeScript i potvrdite da ispravno radi pre nego što napišete svoj prvi 3D skript za obradu.

Preduslovi

Osigurajte da su sledeće instalirane i na vašem PATH pre nego što nastavite:

Da proverite svoje verzije:

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

Korak 1: Kreirajte projekat (ako je potrebno)

Ako dodajete Aspose.3D u postojeći TypeScript projekat, preskočite ovaj korak i pređite direktno na Korak 2.

Za novi projekat:

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 zavisnost, xmldom, automatski. Nisu potrebni dodatni sistemski paketi, nativni dodaci ili kompajleri. Instalacija je završena kada @aspose/3d se pojavi u vašem package.json ispod dependencies.

Potvrdite instalaciju:

ls node_modules/@aspose/3d

Trebalo bi da vidite direktorijum paketa sa package.json, datoteke definicija tipova (.d.ts), i kompajliranim JavaScript-om.

Korak 3: Konfigurišite TypeScript

Dodajte ili ažurirajte tsconfig.json u korenu vašeg projekta sa sledećim podešavanjima. Ovo je potrebno za potpunu kompatibilnost sa 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čna podešavanja i zašto su važna:

Korak 4: Potvrdite instalaciju

Kreiraj src/verify.ts sa sledeć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);

Kompajlirajte i pokrenite:

npx tsc
node dist/verify.js

Očekivani izlaz:

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

Naziv korenskog čvora je po podrazumevanju prazan string — scene.rootNode se kreira bez argumenta imena.

Ako želite da preskočite korak kompilacije tokom razvoja, pokrenite direktno sa ts-node:

npx ts-node src/verify.ts

Korak 5: Brzi početak: Učitajte scenu i odštampajte informacije o čvoru

Sledeći skript učitava 3D fajl i ispisuje ime i tip entiteta svakog čvora u sceni. Radi sa 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);

Sačuvajte ovo kao src/quickstart.ts i pokrenite ga:

npx ts-node src/quickstart.ts

Za OBJ fajl sa jednim mesh-om pod imenom Cube, izlaz će izgledati ovako:

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

Korenski čvor ima prazno ime (odštampano kao prazan prefiks). Podčvorovi nasleđuju svoja imena iz učitanog fajla.

Napomene o zavisnostima

Aspose.3D FOSS za TypeScript ima tačno jednu runtime zavisnost:

Ne morate da instalirate xmldom ručno. Pojaviće se u vašem node_modules nakon glavne komande za instalaciju. Nema nativnih dodataka (.node datoteke) i ne zahtevaju se sistemske biblioteke.

Sledeći koraci

Sada kada je biblioteka instalirana i verifikovana:

• Pročitajte Vodič za programere za potpuni pregled svih funkcionalnih oblasti.
• Pogledajte Karakteristike i funkcionalnosti za detalje o podršci formata, obrascima scene‑grafova, API‑jima za materijale i animacije, i potpunim TypeScript primerima koda.