Installasjon

Denne guiden dekker alt du trenger for å installere Aspose.3D FOSS for TypeScript og bekrefte at den fungerer korrekt før du skriver ditt første 3D-behandlingsskript.

Forutsetninger

Sørg for at følgende er installert og på din PATH før du fortsetter:

For å sjekke versjonene dine:

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

Steg 1: Opprett et prosjekt (om nødvendig)

Hvis du legger til Aspose.3D i et eksisterende TypeScript-prosjekt, hopp over dette steget og gå direkte til Steg 2.

For et nytt prosjekt:

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

Steg 2: Installer @aspose/3d

npm install @aspose/3d

Dette installerer pakken og dens eneste transitive avhengighet, xmldom, automatisk. Ingen ekstra systempakker, native tillegg eller kompilatorer er nødvendig. Installeringen er fullført når @aspose/3d vises i din package.json under dependencies.

Bekreft installasjonen:

ls node_modules/@aspose/3d

Du bør se pakkemappen med package.json, type-definisjonsfiler (.d.ts), og kompilert JavaScript.

Steg 3: Konfigurer TypeScript

Legg til eller oppdater tsconfig.json i rotmappen til prosjektet ditt med følgende innstillinger. Disse er påkrevd for full kompatibilitet med bibliotekets type-definisjoner og CommonJS-utdata:

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

Viktige innstillinger og hvorfor de er viktige:

Steg 4: Bekreft installasjonen

Opprett src/verify.ts med følgende minimale importtest:

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

Kompiler og kjør:

npx tsc
node dist/verify.js

Forventet utdata:

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

Rotnode-navnet er en tom streng som standard — scene.rootNode opprettes uten navneargument.

Hvis du foretrekker å hoppe over kompileringstrinnet under utvikling, kjør direkte med ts-node:

npx ts-node src/verify.ts

Steg 5: Rask start: Last inn en scene og skriv ut nodeinformasjon

Følgende skript laster en 3D-fil og skriver ut navnet og entitetstypen til hver node i scenen. Det fungerer med alle støttede formater: OBJ, glTF, GLB, STL, 3MF, FBX eller 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);

Lagre dette som src/quickstart.ts og kjør den:

npx ts-node src/quickstart.ts

For en OBJ-fil med ett mesh kalt Cube, vil utdataene se slik ut:

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

Rotnoden har et tomt navn (skrevet ut som et tomt prefiks). Barne‑noder arver navnene sine fra den innlastede filen.

Avhengighetsnotater

Aspose.3D FOSS for TypeScript har nøyaktig én kjøretidsavhengighet:

Du trenger ikke å installere xmldom manuelt. Det vil vises i din node_modules etter hovedinstallasjonskommandoen. Det finnes ingen native-tillegg (.node filer) og ingen systembiblioteker kreves.

Neste steg

Nå som biblioteket er installert og verifisert:

• Les Utviklerveiledning for en komplett gjennomgang av alle funksjonsområder.
• Se Funksjoner og egenskaper for detaljer om formatstøtte, scene‑grafmønstre, material‑ og animasjons‑API‑er, og komplette TypeScript‑kodeeksempler.