1. محصولات
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

بارگذاری، ساخت، تبدیل و استخراج صحنه‌های سه‌بعدی از Node.js — به‌صورت کاملاً تایپ‌شده، منبع باز و آماده برای تولید با یک نصب npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

مستندات GitHub

کتابخانه تایپ اسکریپت منبع باز برای پردازش فایل 3D

Aspose.3D FOSS برای TypeScript یک کتابخانه تحت مجوز MIT برای کار با فرمت‌های فایل 3D در برنامه‌های Node.js است. آن را با یک فرمان npm install @aspose/3d نصب کنید و بلافاصله شروع به خواندن، ساخت و نوشتن صحنه‌های 3D در TypeScript کنید، بدون نیاز به افزونه‌های بومی برای کامپایل، بدون نیاز به SDKهای خارجی برای نصب، و بدون نیاز به رندرر.

کتابخانه یک API گراف صحنه کاملاً تایپ‌شده را ارائه می‌دهد که حول Scene، Node، Entity، Mesh، Camera، Light و Transform ساخته شده است، همان مدل مفهومی که ابزارهای حرفه‌ای 3D استفاده می‌کنند. پشتیبانی از فرمت‌ها شامل OBJ (Wavefront، با بارگذاری مواد .mtl)، glTF 2.0 و باینری GLB (مواد PBR)، STL (باینری و ASCII، دورگرد کامل)، COLLADA (DAE)، 3MF و FBX است. کلاس‌های گزینه‌ای برای هر فرمت مانند ObjLoadOptions و GltfSaveOptions به شما کنترل دقیق بر جهت‌گیری سیستم مختصات، مقیاس، نرمال‌سازی نرمال‌ها، خروجی باینری در مقابل JSON، و بارگذاری مواد می‌دهند.

Aspose.3D FOSS هدف‌گذاری شده برای Node.js 18، 20 و 22+ با TypeScript 5.0+ است و به CommonJS کامپایل می‌شود. کتابخانه با تنظیمات سختگیرانه کامپایلر TypeScript (noImplicitAny، strictNullChecks) ارائه می‌شود تا IDE شما تکمیل خودکار کامل و ایمنی زمان کامپایل را فراهم کند. تنها وابستگی زمان اجرا آن، xmldom، به‌صورت خودکار نصب می‌شود. برای خانواده محصولات سازمانی، به Aspose.3D — Enterprise Product Family مراجعه کنید.

پشتیبانی از فرمت های 3D و API گراف صحنه تایپ شده

  • ** OBJ / MTL:** فایل های Wavefront OB J را با تعریف مواد همراه کنید.
  • glTF 2.0 / GLB: بارگذاری مواد PBR و خروجی GDB دوگانه از طریق GltfSaveOptions.
  • STL: خواندن و نوشتن هر دو STL باینری و ASCII با تأیید کامل سفر.
  • COLLADA، 3MF, FBX: پشتیبانی از فرمت های اضافی با کلاس گزینه در هر فرمی.
  • ** انواع TypeScript کامل:** هر کلاس، روش و گزینه به شدت با noImplicitAny و strictNullChecks تایپ می شود.

جایی که Aspose.3D FOSS می تواند مورد استفاده قرار گیرد

  • نودهای دارایی Node.js: وارد کردن فایل های OBJ، تأیید و تغییر جهت دادن هندسه، و صادرات به عنوان GLB در CI.
  • ** ابزار بازی:** شبکه های سه بعدی بدون موتور بومی یا رندرر.
  • ** جریان های کاری چاپ سه بعدی:** خواندن، تأیید و باز صادر کردن فایل های STL و 3MF.
  • ** backends بدون سرور:** اجرا 3D تبدیل نقاط پایان در Lambda یا Cloud Functions.
  • ** انتقال محتوا:** تبدیل بین خانواده های فرمت در مقیاس از یک اسکریپت واحد.

گزینه های فرمت و کنترل هماهنگی

  • ** جهت گیری سیستم مختصات:** محورها را تغییر دهید و مقیاس هر فرمت با کلاس های گزینه ای تنظیم کنید.
  • طبعیت عادی: به طور خودکار در بارگذاری یا ذخیره کردن، نورمالیزاسیون نوک ستون ها را انجام دهید.
  • خرید ثنائی در مقابل JSON: GLB فشرده یا glTF قابل خواندن را از طریق GltfSaveOptions انتخاب کنید.
  • ** کنترل بارگذاری مواد:** فعال یا غیرفعال کردن MTL/بارگیری بافت برای تجزیه سریع تر.
  • توفيق سفر دور: گره های ناشناخته صحنه-گراف در حفظ مجدد به طور لفظی محفوظ می شوند.

تجربه توسعه دهنده

Aspose.3D FOSS برای TypeScript با یک دستور npm install @aspose/3d نصب می شود. هیچ افزونه بومی ای برای کامپایل وجود ندارد. این کتابخانه خالص تایپ اسکریپت / جاوا اسکرپتی است که دارای یک وابستگی خودکار (xmldom) است .

این API به شدت تایپ شده ، تکمیل خودکار کامل IDE را برای هر کلاس و گزینه قالب صحنه ارائه می دهد. کتابخانه Node.js 1822 + و TypeScript 5.0 + را هدف قرار داده است ، در اجراکنندگان لینوکس CI و ایستگاه های کاری توسعه دهندگان یکسان اجرا می شود و دارای مجوز MIT با ردیابی مسئله باز در GitHub است.

بارگذاری یک صحنه OBJ و صادرات به عنوان glTF

با npm نصب کنید، سپس از scene.open() با ObjLoadOptions برای بارگذاری مش همراه با فایل مواد MTL آن استفاده کنید. هر دو open() و save() به صورت همزمان هستند — نیازی به await یا زنجیره‌سازی Promise نیست. فراخوانی scene.save() با پسوند .gltf، استاندارد glTF 2.0 JSON را می‌نویسد — فرمت به‌صورت خودکار از پسوند فایل استخراج می‌شود.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

تبدیل STL به GLB باینری

برای تولید GLB دوگانه فشرده به جای glTF JSON پیش فرض، GltfSaveOptions را با binaryMode = true منتقل کنید. هر دو open() و save() همگام هستند نیازی به await نیست.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

سوالات متداول

Aspose.3D FOSS برای TypeScript چیست؟

این یک کتابخانه رایگان با مجوز MIT TypeScript / Node.js برای بارگیری، دستکاری و ذخیره کردن صحنه های 3D بدون نصب هر گونه افزونه بومی یا SDK خارجی است.

چه فرمت های سه بعدی پشتیبانی می شوند؟

OBJ (با .mtl) ، glTF 2.0 و GLB، STL (بینری و ASCII) COLLADA (DAE) 3MF و FBX. هر فرمت دارای یک کلاس اختصاصی گزینه های تایپ شده است.

آیا نیاز به افزونه های Node.js بومی دارد؟

نه. Aspose.3D FOSS برای TypeScript خالص JavaScript / Type Script است. این نیاز به هیچ مرحله کامپایل و دارای یک وابستگی زمان اجرا (xmldom) نصب شده توسط npm.

چطوري نصبش کنم؟

npm install @aspose/3d را اجرا کنید. هیچ بسته های اضافی سیستم یا افزونه بومی مورد نیاز نیست.

چه نسخه های Node.js و TypeScript پشتیبانی می شوند؟

Node.js 18, 20 و 22+. TypeScript 5.0+ این کتابخانه به CommonJS کامپایل می شود و با تنظیمات سختگیرانه Type Script کار می کند.

آیا این با تعریف نوع TypeScript ارسال می شود؟

بله. تمام کلاس ها، روش ها و انواع گزینه با noImplicitAny و strictNullChecks فعال شده اند.

ميتونم جهت گيري سيستم مختصات رو کنترل کنم؟

بله. کلاس های گزینه به صورت هر فرمت مانند ObjLoadOptions و GltfSaveOptions اجازه می دهد که محورها را تغییر دهید، مقیاس تنظیم کنید و بدون کد تجزیه سفارشی عادی شوید.

کجاش میتونم کد منبع رو پیدا کنم؟

این کتابخانه دارای مجوز MIT است و در GitHub میزبانی می شود. گزارشات خطا و درخواست های کشیدن خوش آمدید هستند.

  

منابع پشتیبانی و آموزش

 فارسی