Format Load and Save Options

الحزمة: @aspose/3d (v24.12.0)

تتحكم فئات خيارات التنسيق في كيفية @aspose/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';

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, يقوم المُصدِّر بكتابة ملف GLB ثنائي مستقل. عندما `false`, يكتب JSON `.gltf` ملفًا مع مرافق `.bin` مخزن مؤقت.
`flipTexCoordV`	`boolean`	`true`	Enumerations `true`, إحداثيات UV V مقلوبة (`v = 1 - v`). مواصفة glTF 2.0 تستخدم أصل UV من أعلى اليسار، لذا فإن هذه العلامة هي `true` بشكل افتراضي لتطابق معظم اتفاقيات أدوات DCC.

Enumerations

تصدير المشهد كملف 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. لا يكشف عن خصائص إضافية موجهة للمستخدم في الإصدار الحالي؛ مرّر نسخة افتراضية لاستخدام الإعدادات الموصى بها.

Enumerations

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, يقوم المستورد بقراءة الـ `.mtl` مكتبة المواد المشار إليها من قبل الـ `mtllib` التوجيه ويملأ خصائص المواد على عقد الشبكة. اضبط إلى `false` لتخطي تحميل المواد.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, يتم تبديل محوري Y و Z أثناء الاستيراد لتحويل بين أنظمة الإحداثيات Y‑up و Z‑up.
`normalizeNormal`	`boolean`	`true`	Enumerations `true`,، يتم تطبيع الـ vertex normals المقروءة من الملف إلى طول وحدة أثناء الاستيراد.
`scale`	`number`	`1.0`	عامل مقياس موحد يُطبق على جميع الهندسة أثناء الاستيراد.

Enumerations

تحميل ملف 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 إلى رمي خطأ عملية غير مدعومة.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`,، ملف مرفق `.mtl` مكتبة المواد يُكتب إلى جانب الـ `.obj` الإخراج.
`pointCloud`	`boolean`	`false`	Enumerations `true`, الهندسة يتم تصديرها كسحابة نقطية (الرؤوس فقط، دون تعريفات للوجوه).
`verbose`	`boolean`	`false`	Enumerations `true`, يتم تضمين تعليقات تشخيصية إضافية في مخرجات OBJ.
`serializeW`	`boolean`	`false`	Enumerations `true`, يتم كتابة المكوّن W لإحداثيات الرؤوس المتجانسة إلى الملف.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, يتم تبديل محوري Y و Z أثناء التصدير.
`applyUnitScale`	`boolean`	`false`	Enumerations `true`, يتم تطبيق مقياس الوحدة للمشهد على جميع إحداثيات الهندسة أثناء التصدير.

StlSaveOptions

خيارات الحفظ لـ STL (.stl) مخرجات.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, يتم كتابة المخرجات كملف STL ثنائي (مضغوط، غير قابل للقراءة البشرية). عندما `false`, يتم كتابة STL بنص ASCII.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, يتم تبديل محوري Y و Z أثناء التصدير.
`scale`	`number`	`1.0`	عامل مقياس موحد يُطبق على جميع الهندسة أثناء التصدير.

Enumerations

حفظ شبكة كملف 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';

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`embedTextures`	`boolean`	`false`	Enumerations `true`,، تُدمج صور القوام المشار إليها داخل أرشيف FBX الثنائي. عندما `false`,، تُكتب مسارات القوام كمرجعيات خارجية.

Enumerations

تصدير ملف 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) ملفات. يدعم كل من FBX الثنائي و ASCII.

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

FbxLoadOptions يمتد LoadOptions ولا يكشف عن خصائص إضافية موجهة للمستخدم في الإصدار الحالي.

الفئات الأساسية

LoadOptions

إرجاع قيمة الخاصية المسماة، أو null إذا لم تكن الخاصية موجودة.

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).