Wie man 3D‑Modelle in TypeScript speichert

Aspose.3D FOSS für TypeScript speichert Szenen in alle unterstützten Formate mit einem einzigen scene.save() Aufruf. Das Ausgabeformat wird automatisch anhand der Dateierweiterung erkannt. Dieser Leitfaden 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('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`);

Formatunterstützungsmatrix

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 mit dem Namen output.xyz schlägt fehl.

.obj Datei wird gespeichert, aber Materialien fehlen

Beim Speichern von OBJ wird die Materialbibliothek (.mtl) automatisch zusammen mit dem .obj geschrieben. 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 anstelle von .gltf; es bündelt Binärdaten in einer einzigen eigenständigen Datei. Setzen Sie GltfSaveOptions.binaryMode = true, wenn Sie eine GltfSaveOptions‑Instanz übergeben.

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

Ä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() verwendet haben. Die Bibliothek schreibt in einen Puffer und dann auf die Festplatte.

Siehe auch

• Wie man 3D-Modelle in TypeScript lädt
• Wie man glTF in TypeScript exportiert
• Formatunterstützung
• API-Referenz