Installation

Dieser Leitfaden deckt alles ab, was Sie benötigen, um Aspose.3D FOSS für TypeScript zu installieren und zu bestätigen, dass es korrekt funktioniert, bevor Sie Ihr erstes 3D-Verarbeitungsskript schreiben.

Voraussetzungen

Stellen Sie sicher, dass Folgendes installiert ist und sich auf Ihrem PATH bevor Sie fortfahren:

Um Ihre Versionen zu prüfen:

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

Schritt 1: Ein Projekt erstellen (falls erforderlich)

Wenn Sie Aspose.3D zu einem bestehenden TypeScript-Projekt hinzufügen, überspringen Sie diesen Schritt und gehen Sie direkt zu Schritt 2.

Für ein neues Projekt:

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

Schritt 2: @aspose/3d installieren

npm install @aspose/3d

Dies installiert das Paket und seine einzige transitive Abhängigkeit, xmldom, automatisch. Es sind keine zusätzlichen Systempakete, nativen Add-ons oder Compiler erforderlich. Die Installation ist abgeschlossen, wenn @aspose/3d erscheint in Ihrem package.json unter dependencies.

Installation überprüfen:

ls node_modules/@aspose/3d

Sie sollten das Paketverzeichnis sehen mit package.json, Typdefinitionsdateien (.d.ts), und kompiliertes JavaScript.

Schritt 3: TypeScript konfigurieren

Hinzufügen oder aktualisieren tsconfig.json im Stammverzeichnis Ihres Projekts mit den folgenden Einstellungen. Diese sind für die vollständige Kompatibilität mit den Typdefinitionen der Bibliothek und der CommonJS‑Ausgabe erforderlich:

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

Wichtige Einstellungen und warum sie wichtig sind:

Schritt 4: Installation überprüfen

Erstellen src/verify.ts mit dem folgenden minimalen 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);

Kompilieren und ausführen:

npx tsc
node dist/verify.js

Expected output:

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

Der Name des Wurzelknotens ist standardmäßig ein leerer String — scene.rootNode wird ohne Namensargument erstellt.

Wenn Sie den Kompilierungsschritt während der Entwicklung überspringen möchten, führen Sie direkt aus mit ts-node:

npx ts-node src/verify.ts

Schritt 5: Schnellstart: Szene laden und Knoteninformationen ausgeben

Das folgende Skript lädt eine 3D-Datei und gibt den Namen sowie den Entitätstyp jedes Knotens in der Szene aus. Es funktioniert mit allen unterstützten Formaten: OBJ, glTF, GLB, STL, 3MF, FBX oder 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);

Speichern Sie dies als src/quickstart.ts und führe es aus:

npx ts-node src/quickstart.ts

Für eine OBJ-Datei mit einem Mesh namens Cube, die Ausgabe sieht folgendermaßen aus:

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

Der Wurzelknoten hat einen leeren Namen (als leeres Präfix ausgegeben). Kindknoten übernehmen ihre Namen aus der geladenen Datei.

Hinweise zu Abhängigkeiten

Aspose.3D FOSS für TypeScript hat genau eine Laufzeitabhängigkeit:

Sie müssen nicht installieren xmldom manuell. Es wird in Ihrem node_modules nach dem Hauptinstallationsbefehl. Es gibt keine nativen Add-ons (.node Dateien) und es werden keine Systembibliotheken benötigt.

Nächste Schritte

Jetzt, da die Bibliothek installiert und verifiziert ist:

• Lesen Sie die Entwicklerhandbuch für eine vollständige Schritt‑für‑Schritt‑Anleitung aller Funktionsbereiche.
• Siehe Funktionen und Funktionalitäten für Details zur Formatunterstützung, Szenengraph‑Muster, Material‑ und Animations‑APIs sowie vollständige TypeScript‑Codebeispiele.