كيفية تحويل النماذج ثلاثية الأبعاد في TypeScript

يقوم Aspose.3D FOSS for TypeScript بتحويل بين صيغ 3D عن طريق تحميلها إلى تمثيل محايد Scene وحفظها إلى الصيغة المستهدفة. يوضح هذا الدليل أكثر التحويلات شيوعًا.

دليل خطوة بخطوة

npm install @aspose/3d

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

const scene = new Scene();
const opts = new ObjLoadOptions();
opts.enableMaterials = true;
scene.open('model.obj', opts);

// OBJ → glTF binary (GLB)
scene.save('output.glb');

// OBJ → STL
scene.save('output.stl');

// OBJ → COLLADA
scene.save('output.dae');

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

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
scene.save('model.glb');
console.log('Converted OBJ → GLB');

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

const scene = new Scene();
scene.open('model.glb');
scene.save('model.stl');
console.log('Converted GLB → STL');

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

const scene = new Scene();
scene.open('model.dae');
scene.save('model.3mf');
console.log('Converted COLLADA → 3MF');

import * as fs from 'fs';
import * as path from 'path';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const inputDir = './input';
const outputDir = './output';

fs.mkdirSync(outputDir, { recursive: true });

const objFiles = fs.readdirSync(inputDir).filter(f => f.endsWith('.obj'));

for (const file of objFiles) {
    const inputPath = path.join(inputDir, file);
    const outputFile = file.replace('.obj', '.glb');
    const outputPath = path.join(outputDir, outputFile);

    const scene = new Scene();
    scene.open(inputPath, new ObjLoadOptions());
    scene.save(outputPath);

    console.log(`Converted ${file} → ${outputFile}`);
}

مصفوفة التحويل المدعومة

FBX غير مدعوم عبر واجهة برمجة التطبيقات عالية المستوى open()/save() — التنسيق غير مدمج في الكشف التلقائي. جميع خلايا FBX أعلاه هي ✗.

المشكلات الشائعة والحلول

يتم فقدان المواد بعد التحويل

يتم تحميل مواد OBJ (usemtl، .mtl ملف) عندما ObjLoadOptions.enableMaterials = true. عند الحفظ إلى glTF، يتم تعيين خصائص مادة PBR تلقائيًا. قد يتم تحويل المواد المعقدة (إجرائية، متعددة الطبقات) بدقة منخفضة.

المجسم يظهر بمقاس غير صحيح

تستخدم الصيغ المختلفة وحدات افتراضية مختلفة (ملليمترات لـ STL، أمتار لـ glTF). استخدم ObjLoadOptions.scale عند التحميل أو StlSaveOptions.scaleFactor عند الحفظ لتطبيع الوحدات.

عدم توافق نظام الإحداثيات (النموذج مقلوب أو مدور)

بعض الصيغ تستخدم الاتجاه Y للأعلى على الجانب الأيمن، والبعض الآخر Z للأعلى. استخدم ObjLoadOptions.flipCoordinateSystem = true أو طبّق دورانًا على العقدة الجذرية بعد التحميل.

الأسئلة المتكررة

هل تحتفظ عملية التحويل بالرسوم المتحركة؟

يتم الحفاظ على بيانات الرسوم المتحركة عند التحويل بين الصيغ التي تدعمها (مثال: COLLADA → glTF). لا تحمل صيغ STL و OBJ بيانات الرسوم المتحركة. لا يتم دعم FBX عبر scene.open()/scene.save()، لذا لا تتوفر جولات الرسوم المتحركة لـ FBX عبر واجهة برمجة التطبيقات عالية المستوى.

هل يتم حفظ بيانات القوام؟

الملمس المشار إليه بمواد OBJ أو المدمج في glTF يتم نقله إلى مخطط المشهد. عند الحفظ إلى GLB (binaryMode = true)، يتم تضمين المخزن الثنائي في ملف واحد. بالنسبة لإخراج OBJ، يتم حفظ الملمس كملفات منفصلة إلى جانب .obj.

هل يمكنني تحويل العديد من الملفات بالتوازي؟

scene.open() و scene.save() متزامنان. استخدم Node.js worker_threads للمعالجة المتوازية.

انظر أيضًا

• كيفية تحميل نماذج ثلاثية الأبعاد في TypeScript
• كيفية حفظ نماذج ثلاثية الأبعاد في TypeScript
• دعم الصيغ
• مرجع API