Installation

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

Prerequisites

Stellen Sie sicher, dass die folgenden installiert sind und auf Ihrem PATH Vor dem Verfahren:

Um Ihre Versionen zu überprüfen:

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

Schritt 1: Erstellen eines Projekts (wenn nötig)

Wenn Sie Aspose.3D zu einem vorhandenen TypeScript-Projekt hinzufügen, gehen Sie diesen Schritt los und gehen direkt zum 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: Installation @aspose/3d

Dies installiert das Paket und seine einzige transitive Abhängigkeit, xmldom, automatisch. Keine zusätzlichen Systempakete, native Addons oder Compilatoren sind erforderlich. Die Installation ist fertig, wenn @aspose/3d erscheint in deinem package.json Unter dependencies.

Überprüfen Sie die Installation:

ls node_modules/@aspose/3d

Sie sollten das Paket-Dokument mit package.json, die Form der Datei Definition (.d.tsund JavaScript zusammengestellt.

Schritt 3: Konfigurieren von TypeScript

Aktualisieren oder hinzufügen tsconfig.json in Ihrer Projektwurzel mit den folgenden Einstellungen. Diese sind erforderlich, um vollständige Kompatibilität mit der Typdefinition der Bibliothek und CommonJS-Ausgang:

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

Die wichtigsten Einstellungen und warum sie bedeuten:

Schritt 4: Überprüfen Sie die Installation

Kreativität src/verify.ts mit dem folgenden Mindestimporttests:

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 runnen:

npx tsc
node dist/verify.js

Erwartete Produktion:

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

Der Root-Node ist ein leer String nach Vorwahl - scene.rootNode Es wird mit keinem Namen Argument geschaffen.

Wenn Sie während der Entwicklung den kompilierten Schritt überwinden möchten, fahren Sie direkt mit dem ts-node:

npx ts-node src/verify.ts

Schritt 5: Schnelle Start: Laden Sie eine Szenen- und Drucknoteninformationen herunter

Das folgende Script laden ein 3D-Datei herunter und drucken den Namen und die Entitätstyp jedes Node in der Szene. Es funktioniert mit jedem unterstützten Format: OBJ, glTF, GLB, STL, 3MF 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);

So sparen Sie das als src/quickstart.ts Und runzt es:

npx ts-node src/quickstart.ts

Für eine OBJ-Datei mit einem Mesh namens Cube,Die Produktion wird wie:

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

Die Wurzelnode hat einen leeren Namen (druckt als weißer Vorwahl). Kinder Noden erfassen ihre Namen aus dem ladenen Datei.

Abhängigkeit Notes

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

Sie müssen nicht installieren xmldom manuell. es wird in deinem node_modules Nach der Hauptinstallation. es gibt keine native Addons (.node Dateien) und keine Systembibliotheken erforderlich.

Nächste Schritte

Jetzt, wenn die Bibliothek installiert und verifiziert ist:

• Lesen Sie die Entwickler Guide für einen vollständigen Spaziergang aller Funktionsgebiete.
• Sehen Sie Eigenschaften und Funktionen für Format-Supportdetails, Scene-Graphmuster, Material und Animation APIs sowie vollständige TypeScript-Code Beispiele.

Siehe auch

• Aspose.3D für TypeScript – Enterprise Documentation