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) פלט.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, המייצא כותב קובץ בינארי GLB עצמאי. כאשר `false`, הוא כותב JSON `.gltf` קובץ עם נלווה `.bin` מאגר.
`flipTexCoordV`	`boolean`	`true`	ColladaSaveOptions `true`, קואורדינטות UV V הפוכות (`v = 1 - v`). מפרט glTF 2.0 משתמש במקור UV בצד שמאל למעלה, ולכן דגל זה הוא `true` כברירת מחדל כדי להתאים לרוב קונבנציות כלי DCC.

ColladaSaveOptions

ייצאו סצנה כ‑GLB בינארי כאשר קואורדינטות ה‑UV נשמרות כפי שהן.

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. הוא אינו חושף תכונות נוספות המוצגות למשתמש בגרסה הנוכחית; העבר מופע ברירת מחדל כדי להשתמש בערכי ברירת המחדל המומלצים.

ColladaSaveOptions

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, המייבא קורא את `.mtl` ספריית החומרים שמופנית על ידי ה `mtllib` הוראה וממלא את תכונות החומר על צמתי הרשת. הגדר ל `false` כדי לדלג על טעינת חומרים.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, צירי Y ו‑Z מוחלפים במהלך הייבוא כדי להמיר בין מערכות קואורדינטות Y‑up ו‑Z‑up.
`normalizeNormal`	`boolean`	`true`	ColladaSaveOptions `true`, נורמליות הקודקודים שנקראו מהקובץ מנורמלות לאורך יחידה במהלך הייבוא.
`scale`	`number`	`1.0`	גורם קנה מידה אחיד המיושם על כל הגאומטריה במהלך הייבוא.

ColladaSaveOptions

טען קובץ OBJ מבלי לפתור את ספריית החומרים שלו.

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 עלול לגרום לשגיאת פעולה לא נתמכת.

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, בן לוויה `.mtl` קובץ ספריית החומר נכתב לצד `.obj` פלט.
`pointCloud`	`boolean`	`false`	ColladaSaveOptions `true`, הגאומטריה מיוצאת כענן נקודות (קודקודים בלבד, ללא הגדרות פנים).
`verbose`	`boolean`	`false`	ColladaSaveOptions `true`, הערות אבחון נוספות נכללות בפלט OBJ.
`serializeW`	`boolean`	`false`	ColladaSaveOptions `true`, רכיב ה‑W של קואורדינטות קודקוד הומוגניות נכתב לקובץ.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, צירי Y ו‑Z מוחלפים במהלך הייצוא.
`applyUnitScale`	`boolean`	`false`	ColladaSaveOptions `true`, קנה המידה של היחידות של הסצנה מוחל על כל קואורדינטות הגאומטריה במהלך הייצוא.

StlSaveOptions

אפשרויות שמירה ל‑STL (.stl) פלט.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, הפלט נכתב כ‑STL בינארי (קומפקטי, לא קריא לבני אדם). כאשר `false`, נכתב STL בפורמט ASCII.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, צירי Y ו‑Z מוחלפים במהלך הייצוא.
`scale`	`number`	`1.0`	גורם קנה מידה אחיד מוחל על כל הגאומטריה במהלך הייצוא.

ColladaSaveOptions

שמור רשת כ‑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) קבצים. גם STL בפורמט ASCII וגם בינארי נתמכים אוטומטית; אין מאפיין ששולט בזיהוי.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`embedTextures`	`boolean`	`false`	ColladaSaveOptions `true`, תמונות מרקם שהוזכרו משובצות בתוך ארכיון בינארי של FBX. כאשר `false`, נתיבי מרקם נכתבים כהפניות חיצוניות.

ColladaSaveOptions

ייצא קובץ 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) קבצים. תומך גם ב‑binary וגם ב‑ASCII FBX.

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

FbxLoadOptions מרחיב LoadOptions ולא חושף תכונות נוספות המוצגות למשתמש בגרסה הנוכחית.

מחלקות בסיס

LoadOptions

מחלקת בסיס לכל אובייקטי אפשרויות טעינה.

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

העבר a LoadOptions מופע של תת‑מחלקה ל scene.open(filePath, options) או scene.openFromBuffer(buffer, options).

SaveOptions

הפנייה ל‑LoadOptions, SaveOptions ולכל מחלקות האפשרויות הספציפיות לפורמט (OBJ, glTF, STL, FBX, COLLADA) המשמשות לשליטה בהתנהגות הייבוא והייצוא.

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

העבר a SaveOptions מופע של תת‑מחלקה ל scene.save(filePath, options).