1. מוצרים
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS עבור TypeScript

טען, בנה, שנה וצא סצנות תלת‑ממד מ‑Node.js — עם טיפוסים מלאים, קוד פתוח, ומוכן לייצור עם התקנה אחת של npm.

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

לִלמוֹד GitHub

ספרייה בקוד פתוח של TypeScript לעיבוד קבצי תלת‑ממד

Aspose.3D FOSS עבור TypeScript היא ספרייה ברישיון MIT לעבודה עם פורמטים של קבצים תלת‑ממדיים ביישומי Node.js. התקינו אותה עם פקודה אחת npm install @aspose/3d והתחילו לקרוא, לבנות ולכתוב סצנות תלת‑ממדיות ב‑TypeScript מייד, ללא תוספים מקומיים לקימפול, ללא SDK חיצוני להתקנה, וללא צורך במנוע רינדור.

הספרייה חושפת API של גרף‑סצנה עם טיפוסים מלאים, המבוסס על Scene, Node, Entity, Mesh, Camera, Light ו‑Transform, אותו מודל מושגי שבו משתמשים כלי תלת‑ממד מקצועיים. התמיכה בפורמטים כוללת 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, מותקנת אוטומטית.

תמיכה בפורמטים תלת‑ממדיים ו‑API של גרף‑סצנה טיפוסי

  • OBJ / MTL: טען קבצי Wavefront OBJ עם הגדרות חומרים נלוות.
  • glTF 2.0 / GLB: טעינת חומרים PBR ופלט GLB בינארי דרך GltfSaveOptions.
  • STL: קרא וכתוב קבצי STL בינאריים ו‑ASCII עם אימות סיבוב מלא.
  • COLLADA, 3MF, FBX: תמיכה נוספת בפורמטים עם מחלקות אפשרויות לכל פורמט.
  • Full TypeScript types: כל מחלקה, מתודה ואפשרות מוקפדים בטיפוסים חזקים עם noImplicitAny ו‑strictNullChecks.

היכן ניתן להשתמש ב-Aspose.3D FOSS

  • צינורות נכסים ב-Node.js: ייבא קבצי OBJ, אמת והפנה מחדש את הגאומטריה, וייצא כ-GLB ב-CI.
  • כלי פיתוח משחקים: עיבוד אצווה של רשתות תלת‑ממדיות ללא מנוע או רנדרר מקורי.
  • תהליכי הדפסת תלת‑ממד: קרא, אמת וייצא מחדש קבצי STL ו‑3MF.
  • Serverless backends: הפעל נקודות קצה של המרת 3D ב‑Lambda או ב‑Cloud Functions.
  • Content migration: המר בין משפחות פורמטים בקנה מידה גדול מתוך סקריפט יחיד.

אפשרויות לכל פורמט ושליטה בקואורדינטות

  • כיוון מערכת הקואורדינטות: הפוך צירים והתאם קנה מידה לפי פורמט עם מחלקות אפשרות.
  • נרמול נורמליים: נרמל באופן אוטומטי נורמליות קודקוד בזמן טעינה או שמירה.
  • פלט בינארי מול JSON: בחר GLB קומפקטי או glTF קריא דרך GltfSaveOptions.
  • בקרת טעינת חומרים: אפשר או בטל טעינת MTL/טקסטורה לקבלת ניתוח מהיר יותר.
  • אמינות סיבובית: צמתים לא ידועים בגרף הסצנה נשמרים במדויק בעת שמירה מחדש.

חוויית מפתח

Aspose.3D FOSS להתקנות TypeScript עם פקודה יחידה npm install @aspose/3d. אין תוספים מקומיים שיש לקמפל. הספרייה היא TypeScript/JavaScript טהורה עם תלות אחת המותקנת אוטומטית (xmldom).

ה‑API החזק‑טיפוס מספק השלמה מלאה ב‑IDE לכל מחלקת גרף‑סצנה ולכל אפשרות פורמט. הספרייה ממוקדת Node.js 18–22+ ו‑TypeScript 5.0+, פועלת זהה על ראנרים של Linux CI ותחנות עבודה של מפתחים, והיא ברישיון MIT עם מערכת ניהול תקלות פתוחה ב‑GitHub.

טען סצנת OBJ וייצא כ‑glTF

התקן באמצעות npm, ואז השתמש במתודה הסינכרונית scene.open() עם ObjLoadOptions לטעון את הרשת יחד עם קובץ החומרה MTL שלה. קריאה ל‑scene.save() עם סיומת .gltf כותבת JSON סטנדרטי של glTF 2.0; הפורמט ננחש אוטומטית מהסיומת של הקובץ.

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());

// ייצא כ‑glTF 2.0 JSON
scene.save("model.gltf");

המר STL ל‑GLB בינארי

כדי לייצר GLB בינארי קומפקטי במקום glTF JSON ברירת המחדל, העבירו GltfSaveOptions עם binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// שמור כ‑GLB בינארי קומפקטי
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

מהו Aspose.3D FOSS עבור TypeScript?

זהו ספרייה חינמית, ברישיון MIT, של TypeScript/Node.js לטעינה, מניפולציה ושמירת סצנות 3D ללא צורך בהתקנת תוסף מקורי או SDK חיצוני.

אילו פורמטים תלת‑ממד נתמכים?

OBJ (עם .mtl), glTF 2.0 ו-GLB, STL (בינארי ו-ASCII), COLLADA (DAE), 3MF, ו-FBX. לכל פורמט יש מחלקת אפשרויות Typed ייעודית.

האם הוא דורש תוספים מקומיים של Node.js?

לא. Aspose.3D FOSS עבור TypeScript הוא JavaScript/TypeScript טהור. הוא אינו דורש שלב קומפילציה ויש לו תלות ריצה יחידה (xmldom) המותקנת אוטומטית על ידי npm.

איך אני מתקין את זה?

הפעל npm install @aspose/3d. אין צורך בחבילות מערכת נוספות או בתוספים מקומיים.

אילו גרסאות של Node.js ו-TypeScript נתמכות?

Node.js 18, 20, ו‑22+. TypeScript 5.0+. הספרייה מתורגמת ל‑CommonJS ופועלת עם הגדרות TypeScript קפדניות.

האם הוא מגיע עם הגדרות סוגים של TypeScript?

כן. כל המחלקות, השיטות, ה‑enums וסוגי האפשרויות מתוייגים במלואם עם noImplicitAny ו‑strictNullChecks מופעלים.

האם אני יכול לשלוט בכיוון מערכת הקואורדינטות?

כן. מחלקות אפשרויות לכל פורמט כגון ObjLoadOptions ו‑GltfSaveOptions מאפשרות לך להפוך צירים, לכוונן קנה מידה, ולנרמל נורמליות ללא קוד ניתוח מותאם אישית.

היכן ניתן למצוא את קוד המקור?

הספרייה בעלת רישיון MIT ומתארחת ב‑GitHub. דיווחי באגים ובקשות משיכה (pull requests) מוזמנים.

  

משאבי תמיכה ולמידה

 עברית