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 מייד, ללא תוספים מקומיים לקימפול, ללא SDKs חיצוניים להתקנה, וללא צורך במנוע רינדור.

הספרייה חושפת 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.

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

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

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

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

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

  • כיוון מערכת הקואורדינטות: הפוך צירים והתאם קנה מידה לפי פורמט עם מחלקות אפשרות.
  • נרמול נורמליים: נרמול אוטומטי של נורמליות הקודקוד בטעינה או בשמירה.
  • פלט בינארי מול 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+, פועלת באופן זהה על רצות CI של Linux ועל תחנות עבודה של מפתחים, והיא ברישיון MIT עם מערכת מעקב בעיות פתוחה ב-GitHub.

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

התקן באמצעות npm, ואז השתמש ב-scene.open() עם ObjLoadOptions כדי לטעון את הרשת יחד עם קובץ החומר MTL שלה. שניהם open() ו-save() הם סינכרוניים — אין צורך ב-await או בשרשרת Promise. קריאה ל-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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

המרת STL ל‑Binary 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 לטעינה, מניפולציה ושמירת סצנות תלת‑ממדיות ללא צורך בהתקנת תוסף מקורי או SDK חיצוני.

אילו פורמטים 3D נתמכים?

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

האם הוא דורש תוספים מקומיים של 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?

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

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

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

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

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

  

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

 עברית