Format Load and Save Options

بسته: @aspose/3d (v24.12.0)

کلاس‌های گزینهٔ فرمت کنترل می‌کنند که چگونه @aspose/3d فایل‌های 3D خاص را می‌خواند و می‌نویسد. یک نمونهٔ گزینه‌ها را به‌عنوان آرگومان دوم به scene.open() (load options) یا scene.save() (گزینه‌های ذخیره). تمام کلاس‌های گزینه‌ها از یکی از 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

گزینه‌های ذخیره برای JSON glTF 2.0 (.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` بافر.
`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

گزینه‌های بارگذاری برای JSON glTF 2.0 (.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`, STL به صورت ASCII نوشته می‌شود.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, محورهای Y و Z در هنگام خروجی‌گیری جابجا می‌شوند.
`scale`	`number`	`1.0`	ضریب مقیاس یکنواخت بر تمام هندسه‌ها در هنگام خروجی‌گیری اعمال می‌شود.

ReferenceMode

BooleanOperation به‌عنوان متادیتا بر روی گره‌های تولید شده توسط واردکنندگان CSG ذخیره می‌شود. @aspose/3d ارزیابی بولی در زمان اجرا را انجام نمی‌دهد؛ این شمارش نیت ثبت‌شده در فایل منبع را توصیف می‌کند.

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

نحوهٔ ایندکس‌گذاری آرایهٔ دادهٔ عنصر راس را کنترل می‌کند.

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 و در نسخهٔ فعلی ویژگی‌های کاربری اضافی را در دسترس قرار نمی‌دهد.

تمام شمارش‌ها در @aspose/3d: ProjectionType, LightType, TextureMapping, BooleanOperation, VertexElementType, MappingMode, 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).