Format Load and Save Options

Πακέτο: @aspose/3d (v24.12.0)

Οι κλάσεις επιλογών μορφής ελέγχουν πώς @aspose/3d διαβάζει και γράφει συγκεκριμένες μορφές αρχείων 3D. Περνάτε ένα στιγμιότυπο επιλογών ως δεύτερο όρισμα στο scene.open() (load options) ή scene.save() (save options). Όλες οι κλάσεις επιλογών κληρονομούν είτε LoadOptions ή 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

Επιλογές αποθήκευσης για glTF 2.0 JSON (.gltf) και δυαδικό GLB (.glb) έξοδο.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`binaryMode`	`boolean`	`false`	ReferenceMode `true`, ο εξαγωγέας γράφει ένα αυτόνομο δυαδικό αρχείο GLB. Όταν `false`, γράφει ένα JSON `.gltf` αρχείο με ένα συνοδευτικό `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	ReferenceMode `true`, οι συντεταγμένες UV V αντιστρέφονται (`v = 1 - v`). Η προδιαγραφή glTF 2.0 χρησιμοποιεί προέλευση UV στην επάνω αριστερή γωνία, έτσι αυτή η σημαία είναι `true` από προεπιλογή για να ταιριάζει με τις περισσότερες συμβάσεις εργαλείων DCC.

ReferenceMode

Μοντέλο προβολής κάμερας.

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

Επιλογές φόρτωσης για glTF 2.0 JSON (.gltf) και δυαδικό GLB (.glb) αρχεία.

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

GltfLoadOptions επεκτείνει LoadOptions. Δεν εκθέτει πρόσθετες ιδιότητες προς το χρήστη στην τρέχουσα έκδοση· περάστε μια προεπιλεγμένη παρουσία για να χρησιμοποιήσετε τις προτεινόμενες προεπιλογές.

ReferenceMode

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

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

ObjLoadOptions

Επιλογές φόρτωσης για Wavefront OBJ (.obj) αρχεία.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`enableMaterials`	`boolean`	`true`	ReferenceMode `true`, ο εισαγωγέας διαβάζει το `.mtl` βιβλιοθήκη υλικών που αναφέρεται από το `mtllib` οδηγία και γεμίζει τις ιδιότητες υλικού στους κόμβους του πλέγματος. Ορίστε σε `false` για παράλειψη φόρτωσης υλικού.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, οι άξονες Y και Z ανταλλάσσονται κατά την εισαγωγή για να μετατραπούν μεταξύ συστημάτων συντεταγμένων Y-up και Z-up.
`normalizeNormal`	`boolean`	`true`	ReferenceMode `true`, οι κανονικές κορυφές που διαβάζονται από το αρχείο κανονικοποιούνται σε μονάδα μήκους κατά την εισαγωγή.
`scale`	`number`	`1.0`	Ομοιόμορφος συντελεστής κλίμακας που εφαρμόζεται σε όλη τη γεωμετρία κατά την εισαγωγή.

ReferenceMode

Example.

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

Επιλογές αποθήκευσης για Wavefront OBJ (.obj) έξοδος.

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

Σημείωση: Εξαγωγή OBJ (canExport: false) δεν υποστηρίζεται πλήρως σε αυτήν την έκδοση της βιβλιοθήκης. Η προσπάθεια αποθήκευσης σε OBJ μπορεί να προκαλέσει σφάλμα μη υποστηριζόμενης λειτουργίας.

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`enableMaterials`	`boolean`	`true`	ReferenceMode `true`, ένας σύντροφος `.mtl` το αρχείο βιβλιοθήκης υλικών γράφεται παράλληλα με το `.obj` αποτέλεσμα.
`pointCloud`	`boolean`	`false`	ReferenceMode `true`, η γεωμετρία εξάγεται ως σύννεφο σημείων (μόνο κορυφές, χωρίς ορισμούς προσώπων).
`verbose`	`boolean`	`false`	ReferenceMode `true`, επιπλέον διαγνωστικά σχόλια περιλαμβάνονται στην έξοδο OBJ.
`serializeW`	`boolean`	`false`	ReferenceMode `true`, το συστατικό W των ομογενοποιημένων συντεταγμένων κορυφής γράφεται στο αρχείο.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, οι άξονες Y και Z ανταλλάσσονται κατά την εξαγωγή.
`applyUnitScale`	`boolean`	`false`	ReferenceMode `true`, η κλίμακα μονάδας της σκηνής εφαρμόζεται σε όλες τις συντεταγμένες γεωμετρίας κατά την εξαγωγή.

StlSaveOptions

Επιλογές αποθήκευσης για STL (.stl) έξοδο.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`binaryMode`	`boolean`	`false`	ReferenceMode `true`, η έξοδος γράφεται ως δυαδικό STL (συμπαγές, μη αναγνώσιμο από άνθρωπο). Όταν `false`, γράφεται ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, οι άξονες Y και Z ανταλλάσσονται κατά την εξαγωγή.
`scale`	`number`	`1.0`	Εφαρμόζεται ομοιόμορφος συντελεστής κλίμακας σε όλη τη γεωμετρία κατά την εξαγωγή.

ReferenceMode

Αποθήκευση ενός πλέγματος ως δυαδικό 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

Επιλογές φόρτωσης για STL (.stl) αρχεία. Και τα ASCII και τα δυαδικά STL υποστηρίζονται αυτόματα· καμία ιδιότητα δεν ελέγχει την ανίχνευση.

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

StlLoadOptions επεκτείνει LoadOptions και δεν εκθέτει πρόσθετες ιδιότητες προς τον χρήστη στην τρέχουσα έκδοση.

FbxSaveOptions

Επιλογές αποθήκευσης για FBX (.fbx) έξοδος.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`embedTextures`	`boolean`	`false`	ReferenceMode `true`, οι αναφερόμενες εικόνες υφής είναι ενσωματωμένες μέσα στο δυαδικό αρχείο FBX. Όταν `false`, οι διαδρομές υφής γράφονται ως εξωτερικές αναφορές.

ReferenceMode

Εξαγωγή αρχείου FBX με όλες τις υφές ενσωματωμένες.

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

Επιλογές φόρτωσης για FBX (.fbx) αρχεία. Υποστηρίζει τόσο δυαδικά όσο και ASCII FBX.

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

FbxLoadOptions επεκτείνει LoadOptions και δεν εκθέτει πρόσθετες ιδιότητες προς το χρήστη στην τρέχουσα έκδοση.

ReferenceMode

LoadOptions

Βασική κλάση για όλα τα αντικείμενα επιλογών φόρτωσης.

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

Περάστε ένα LoadOptions αντίγραφο υποκλάσης σε scene.open(filePath, options) ή scene.openFromBuffer(buffer, options).

SaveOptions

Βασική κλάση για όλα τα αντικείμενα επιλογών αποθήκευσης.

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

Περάστε ένα SaveOptions αντίγραφο υποκλάσης σε scene.save(filePath, options).