چگونه با Aspose.3D FOSS برای TypeScript شروع کنیم
@aspose/3d برای TypeScript یک بسته رایگان و مجوز MIT برای بارگذاری، دستکاری و… ذخیره فایل های 3D در Node.js - هیچ دوگانه بومی مورد نیاز، قابل نصب از npm.
راهنمای گام به گام
مرحله اول: نصب بسته بندی
نصب از npm (Node.js 18 یا بالاتر مورد نیاز است):
npm install @aspose/3d@24.12.0بررسی نصب شده به درستی:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");مرحله دوم: کلاس های مورد نیاز واردات
کلاسهای مورد نیاز خود را وارد کنید:
import { Scene, Node } from "@aspose/3d";مرحله 3: فایل 3D را بارگذاری کنید.
استفاده از scene.open() برای هر فرمت پشتیبانی شده، کتابخانه می تواند فرم را تشخیص دهد. به صورت اتوماتیک از فایل افزونه:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);یا از روش کارخانه ای استاتیک استفاده کنید:
const scene = Scene.fromFile("model.glb");مرحله چهارم: از روی صحنه عبور کنید.
یک صحنه بارگذاری شده، درختی است که در آن Node اشیاء ریشه دار در scene.rootNode:
import { Scene, Node } from "@aspose/3d";
function walk(node: Node, depth: number = 0): void {
const indent = " ".repeat(depth * 2);
console.log(`${indent}Node: ${node.name}`);
for (const child of node.childNodes) {
walk(child, depth + 1);
}
}
const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);مرحله 3: ذخیره به فرمت هدف
استفاده از scene.save() برای هر نوع از کتابخانه ها، به صورت زیر می توانید آن را مشاهده کنید. فرمت خروجی از فایل افزونه:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");مشکلات رایج و راهحلها
Error: ENOENT وقتی تماس می گیرند scene.open() راهی که از آن عبور کرده اید وجود ندارد، از یک مسیر مطلق استفاده کنید یا… path.resolve() برای اطمینان از مسیر فایل درست است.
خطای ناشناخته فرمت اطمینان حاصل کنید که فایل ها با فرمت واقعی مطابقت دارند.کتابخانه فرم را تشخیص می دهد تمدید برای open() و fromFile().یک پارامتر مشخصی را برای عبور از آن وارد کنید.
صحنه خالی پس از بارگذاری برخی از فرمت های باینری ممکن است نیاز به گزینه های بار خاص داشته باشند. سعی کنید با استفاده از بیش از حد صریح با گزینه های خاص فرمت اگر بار پیش فرض یک صحنه خالی تولید می کند.
خطای واردات TypeScript تعریف نوع با بسته بندی همراه است.مطالعه "moduleResolution": "bundler" یا "node16" در آن قرار گرفته است که شما tsconfig.json.
سوالات متداول
آیا @aspose/3d نیاز به هر دوگانه بومی دارد؟?
بسته خالص جاوا اسکریپت / نوع اسکرپٹ با هیچ وابستگی های بومی است. آن را در هر پلت فرم پشتیبانی از Node.js 18 یا بالاتر اجرا می شود.
کدام نسخه های Node.js پشتیبانی می شوند؟?
Node.js 18 یا بعد از آن. این بسته در ویندوز، macOS و لینوکس اجرا می شود.
آیا کتابخانه برای استفاده تجاری رایگان است؟?
بله، تحت مجوز MIT منتشر می شود.شما می توانید آن را برای هر هدف از جمله برنامه های تجاری استفاده کنید، ویرایش و توزیع مجدد.
چه فرمت های 3D را می توانم بخوانم و بنویسم؟?
این بسته از OBJ، STL، glTF 2.0 / GLB، FBX، COLLADA و PLY برای هر دو خواندن پشتیبانی می کند. و نوشتن.استفاده از گسترش مبتنی بر scene.save() برای هر فرمت پشتیبانی شده.
آیا می توانم یک صحنه 3D را از اسکاتچ ایجاد کنم؟?
بله، ساختن یک Scene بدون هیچ گونه استدلال، اضافه کردن گره های کودک به scene.rootNode,و به فرمت مورد نظر برسید.