Wie man 3D‑Modelle in TypeScript speichert

Aspose.3D FOSS für TypeScript speichert Szenen in allen unterstützten Formaten mit einem einzigen scene.save() Aufruf. Das Ausgabeformat wird automatisch anhand der Dateierweiterung erkannt. Dieses Handbuch behandelt das Speichern in jedes Format und die Verwendung format‑spezifischer Optionen.

Schritt-für-Schritt-Anleitung

npm install @aspose/3d

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

// Load from file
const scene = new Scene();
scene.open('source.obj', new ObjLoadOptions());

// Or create a new empty scene
const emptyScene = new Scene();

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('input.obj', new ObjLoadOptions());

// Save as binary glTF
scene.save('output.glb');

// Save as JSON glTF
scene.save('output.gltf');

// Save as STL
scene.save('output.stl');

// Save as OBJ
scene.save('output.obj');

// Save as FBX
scene.save('output.fbx');

// Save as 3MF
scene.save('output.3mf');

// Save as COLLADA
scene.save('output.dae');

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

// Export to GLB with specific options
const saveOptions = new GltfSaveOptions();
saveOptions.binaryMode = true;   // produce GLB (binary glTF)

scene.save('output.glb', saveOptions);

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

const buffer = scene.saveToBuffer('output.glb');
console.log(`Buffer size: ${buffer.length} bytes`);

// Send via HTTP, upload to S3, etc.

import * as fs from 'fs';

const stats = fs.statSync('output.glb');
console.log(`Saved output.glb: ${stats.size} bytes`);

Matrix der Formatunterstützung

Häufige Probleme und Lösungen

Error: Unsupported format beim Speichern

Stellen Sie sicher, dass die Dateierweiterung einem unterstützten Format entspricht. Die Bibliothek verwendet die Erweiterung, um das Format zu erkennen; eine Datei namens output.xyz wird fehlschlagen.

.obj Datei wird gespeichert, aber Materialien fehlen

Beim Speichern von OBJ wird die Materialbibliothek (.mtl) wird automatisch zusammen mit dem .obj. Beide Dateien müssen beim erneuten Öffnen im selben Verzeichnis liegen. Wenn Sie nur Geometrie benötigen, setzen Sie ObjSaveOptions.enableMaterials = false.

Groß .gltf mit separaten Texturen

Verwenden Sie .glb statt .gltf; es bündelt Binärdaten in einer einzigen eigenständigen Datei. Set GltfSaveOptions.binaryMode = true wenn Sie ein GltfSaveOptions Instanz.

Häufig gestellte Fragen

Kann ich in einem Durchlauf in mehrere Formate speichern?

Ja; rufen Sie scene.save() mehrfach mit unterschiedlichen Pfaden auf:

scene.save('output.glb');
scene.save('output.stl');
scene.save('output.obj');

Verändert das Speichern die Szene?

Nein. scene.save() ist ein schreibgeschützter Vorgang im Szenengraphen. Sie können dieselbe Szene in mehrere Formate speichern, ohne dass Nebenwirkungen auftreten.

Kann ich die Quelldatei überschreiben?

Ja. Übergeben Sie denselben Pfad an scene.save() den Sie in scene.open(). Die Bibliothek schreibt in einen Puffer und schreibt dann auf die Festplatte.

Siehe auch

• Wie man 3D‑Modelle in TypeScript lädt
• Wie exportiere ich glTF in TypeScript
• Formatunterstützung
• API‑Referenz