Format Load and Save Options

Format Load and Save Options

Paket: @aspose/3d (v24.12.0)

Formatoption-Klassen steuern, wie @aspose/3d spezifische 3D-Dateiformate gelesen und geschrieben werden. Übergeben Sie eine Optionsinstanz als zweites Argument an scene.open() (Ladeoptionen) oder scene.save() (Speicheroptionen). Alle Optionsklassen erben entweder von LoadOptions oder SaveOptions.

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

const opts = new ObjLoadOptions();
opts.enableMaterials = false;
scene.open('mesh.obj', opts);

// Save with options
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;
scene.save('output.glb', saveOpts);

GltfSaveOptions

Speicheroptionen für glTF 2.0 JSON (.gltf) und binäres GLB (.glb).

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
// or
import { GltfSaveOptions } from '@aspose/3d';

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
binaryModebooleanfalseEnumerations true, der Exporter schreibt eine eigenständige binäre GLB-Datei. Wenn false, schreibt er eine JSON .gltf Datei mit einem Begleit .bin Puffer.
flipTexCoordVbooleantrueEnumerations true, UV V-Koordinaten werden umgekehrt (v = 1 - v). Die glTF 2.0 Spezifikation verwendet einen UV-Ursprung oben links, sodass dieses Flag true standardmäßig, um den meisten DCC-Tool-Konventionen zu entsprechen.

Enumerations

Exportieren Sie eine Szene als binäres GLB, wobei die UV-Koordinaten unverändert erhalten bleiben.

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

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

const opts = new GltfSaveOptions();
opts.binaryMode = true;
opts.flipTexCoordV = false;

scene.save('output.glb', opts);
console.log('Saved as binary GLB without UV flip.');

GltfLoadOptions

Ladeoptionen für glTF 2.0 JSON (.gltf) und binäre GLB (.glb) Dateien.

import { GltfLoadOptions } from '@aspose/3d/formats/gltf';

GltfLoadOptions erweitert LoadOptions. Es stellt in der aktuellen Version keine zusätzlichen benutzerseitigen Eigenschaften bereit; übergeben Sie eine Standardinstanz, um empfohlene Vorgaben zu verwenden.

Enumerations

import { Scene } from '@aspose/3d';
import { GltfLoadOptions } from '@aspose/3d/formats/gltf';

const scene = new Scene();
scene.open('model.glb', new GltfLoadOptions());

ObjLoadOptions

Ladeoptionen für Wavefront OBJ (.obj) Dateien.

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

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
enableMaterialsbooleantrueEnumerations true, liest der Importer die .mtl Materialbibliothek, die von dem mtllib Direktiv referenziert wird, und füllt Materialeigenschaften in den Mesh‑Knoten aus. Setzen Sie auf false um das Laden von Materialien zu überspringen.
flipCoordinateSystembooleanfalseEnumerations true, werden die Y‑ und Z‑Achsen beim Import vertauscht, um zwischen Y‑up‑ und Z‑up‑Koordinatensystemen zu konvertieren.
normalizeNormalbooleantrueEnumerations true, werden die aus der Datei gelesenen Scheitelnormale beim Import auf Einheitslänge normalisiert.
scalenumber1.0Einheitlicher Skalierungsfaktor, der während des Imports auf alle Geometrie angewendet wird.

Enumerations

Laden Sie eine OBJ-Datei, ohne deren Materialbibliothek aufzulösen.

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

const opts = new ObjLoadOptions();
opts.enableMaterials = false;

const scene = new Scene();
scene.open('mesh.obj', opts);
console.log(`Root children: ${scene.rootNode.childNodes.length}`);

ObjSaveOptions

Speicheroptionen für Wavefront OBJ (.obj) Ausgabe.

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

Hinweis: OBJ-Export (canExport: false) wird in dieser Version der Bibliothek nicht vollständig unterstützt. Der Versuch, im OBJ zu speichern, kann einen Fehler wegen nicht unterstützter Operation auslösen.

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
enableMaterialsbooleantrueEnumerations true, eine begleitende .mtl Materialbibliotheksdatei wird zusammen mit der .obj Ausgabe.
pointCloudbooleanfalseEnumerations true, Geometrie wird als Punktwolke exportiert (nur Scheitelpunkte, keine Flächendefinitionen).
verbosebooleanfalseEnumerations true, zusätzliche Diagnosekommentare werden in die OBJ-Ausgabe eingefügt.
serializeWbooleanfalseEnumerations true, die W‑Komponente der homogenen Scheitelpunktkoordinaten wird in die Datei geschrieben.
flipCoordinateSystembooleanfalseEnumerations true, die Y‑ und Z‑Achsen werden beim Export vertauscht.
applyUnitScalebooleanfalseEnumerations true, die Einheitsskala der Szene wird beim Export auf alle Geometriekoordinaten angewendet.

StlSaveOptions

Speicheroptionen für STL (.stl) Ausgabe.

import { StlSaveOptions } from '@aspose/3d/formats/stl';
// or
import { StlSaveOptions } from '@aspose/3d';

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
binaryModebooleanfalseEnumerations true, wird die Ausgabe als binäres STL (kompakt, nicht menschenlesbar) geschrieben. Wenn false, wird ASCII STL geschrieben.
flipCoordinateSystembooleanfalseEnumerations true, werden die Y- und Z-Achsen beim Export vertauscht.
scalenumber1.0Einheitlicher Skalierungsfaktor, der auf alle Geometrie beim Export angewendet wird.

Enumerations

Speichern Sie ein Mesh als binäres STL.

import { Scene } from '@aspose/3d';
import { StlSaveOptions } from '@aspose/3d/formats/stl';

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

const opts = new StlSaveOptions();
opts.binaryMode = true;
scene.save('output.stl', opts);
console.log('Saved binary STL.');

StlLoadOptions

Ladeoptionen für STL (.stl) Dateien. Sowohl ASCII- als auch binäres STL werden automatisch unterstützt; keine Eigenschaft steuert die Erkennung.

import { StlLoadOptions } from '@aspose/3d/formats/stl';

StlLoadOptions erweitert LoadOptions und stellt in der aktuellen Version keine zusätzlichen benutzerseitigen Eigenschaften bereit.


FbxSaveOptions

Speicheroptionen für FBX (.fbx) Ausgabe.

import { FbxSaveOptions } from '@aspose/3d/formats/fbx';
// or
import { FbxSaveOptions } from '@aspose/3d';

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
embedTexturesbooleanfalseEnumerations true, referenzierte Texturbilder sind im FBX-Binärarchiv eingebettet. Wenn false, Texturpfade werden als externe Verweise geschrieben.

Enumerations

Exportieren Sie eine FBX-Datei mit allen eingebetteten Texturen.

import { Scene } from '@aspose/3d';
import { FbxSaveOptions } from '@aspose/3d/formats/fbx';

const scene = new Scene();
scene.open('character.gltf');

const opts = new FbxSaveOptions();
opts.embedTextures = true;
scene.save('character-embedded.fbx', opts);
console.log('Saved FBX with embedded textures.');

FbxLoadOptions

Ladeoptionen für FBX (.fbx) Dateien. Unterstützt sowohl binäres als auch ASCII-FBX.

import { FbxLoadOptions } from '@aspose/3d/formats/fbx';

FbxLoadOptions erweitert LoadOptions und stellt in der aktuellen Version keine zusätzlichen benutzerseitigen Eigenschaften bereit.


Basisklassen

LoadOptions

Basisklasse für alle Ladeoptionsobjekte.

import { LoadOptions } from '@aspose/3d';

Übergebe ein LoadOptions Unterklasseninstanz an scene.open(filePath, options) oder scene.openFromBuffer(buffer, options).

SaveOptions

Diese drei Klassen bilden die Basis der Klassenhierarchie von @aspose/3d. Jedes öffentliche Objekt in der Bibliothek erbt letztlich von A3DObject, das den Namen und das dynamische Eigenschaftssystem bereitstellt. SceneObject fügt die Verfolgung der Szenenmitgliedschaft hinzu. Entity ist die Basis für alle Objekte, die an einen Node als dessen primäre Entität angehängt werden können (Meshes, Kameras, Lichter usw.).

import { SaveOptions } from '@aspose/3d';

Übergib ein SaveOptions Unterklasseninstanz an scene.save(filePath, options).

 Deutsch