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
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
binaryMode | boolean | false | Enumerations true, der Exporter schreibt eine eigenständige binäre GLB-Datei. Wenn false, schreibt er eine JSON .gltf Datei mit einem Begleit .bin Puffer. |
flipTexCoordV | boolean | true | Enumerations 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
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
enableMaterials | boolean | true | Enumerations 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. |
flipCoordinateSystem | boolean | false | Enumerations true, werden die Y‑ und Z‑Achsen beim Import vertauscht, um zwischen Y‑up‑ und Z‑up‑Koordinatensystemen zu konvertieren. |
normalizeNormal | boolean | true | Enumerations true, werden die aus der Datei gelesenen Scheitelnormale beim Import auf Einheitslänge normalisiert. |
scale | number | 1.0 | Einheitlicher 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
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
enableMaterials | boolean | true | Enumerations true, eine begleitende .mtl Materialbibliotheksdatei wird zusammen mit der .obj Ausgabe. |
pointCloud | boolean | false | Enumerations true, Geometrie wird als Punktwolke exportiert (nur Scheitelpunkte, keine Flächendefinitionen). |
verbose | boolean | false | Enumerations true, zusätzliche Diagnosekommentare werden in die OBJ-Ausgabe eingefügt. |
serializeW | boolean | false | Enumerations true, die W‑Komponente der homogenen Scheitelpunktkoordinaten wird in die Datei geschrieben. |
flipCoordinateSystem | boolean | false | Enumerations true, die Y‑ und Z‑Achsen werden beim Export vertauscht. |
applyUnitScale | boolean | false | Enumerations 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
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
binaryMode | boolean | false | Enumerations true, wird die Ausgabe als binäres STL (kompakt, nicht menschenlesbar) geschrieben. Wenn false, wird ASCII STL geschrieben. |
flipCoordinateSystem | boolean | false | Enumerations true, werden die Y- und Z-Achsen beim Export vertauscht. |
scale | number | 1.0 | Einheitlicher 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
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
embedTextures | boolean | false | Enumerations 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).