מדריך למפתחים

Aspose.3D FOSS עבור TypeScript היא ספרייה קוד פתוח ברישיון MIT המאפשרת למפתחים ב‑Node.js לטעון, לבנות, לשנות ולייצא סצנות 3D עם בטיחות טיפוס מלאה של TypeScript. בין אם אתם בונים צינור נכסים, שירות המרת פורמטים, כלי אימות גאומטריה, או סקריפט עריכת תוכן 3D, ספרייה זו מספקת API נקי ועקבי הנתמך במודל גרף סצנה המשקף מושגים סטנדרטיים בתעשייה.

מדריך מפתחים זה מכסה את כל מה שנדרש כדי לחרוג מההתקנה המהירה ולכתוב קוד עיבוד 3D באיכות ייצור.

מה שתמצאו בחלק זה

תכונות ופונקציונליות

ה תכונות הדף הוא המקור העיקרי לעבודה עם Aspose.3D FOSS עבור TypeScript. הוא מכסה:

  • תמיכת פורמט: OBJ (עם חומרים .mtl), glTF 2.0 / GLB בינארי, STL (בינארי ו‑ASCII), COLLADA (DAE), 3MF, ו‑FBX, עם מחלקות אפשרויות טעינה ושמירה לכל פורמט כולל ObjLoadOptions ו GltfSaveOptions.
  • גרף סצנה: איך Scene, Node, Entity, Transform, ו SceneObject מתרכבים למבנה היררכי מלא של סצנה, כולל תבניות מעבר של צמתים ילדים.
  • ממשק API לגאומטריה ורשת: עבודה עם Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ו ReferenceMode לעיבוד גאומטריה.
  • מערכת חומרים: יישום LambertMaterial, PhongMaterial, ו PbrMaterial (PBR for glTF) לצמתי סצנה, וקריאת תכונות חומר שנקראו מקבצי .mtl.
  • כלי מתמטיקה: בשימוש Vector3, Vector4, Matrix4, Quaternion, ו BoundingBox עבור טרנספורמציות, שאילתות תיבת-גבול, וחישובים גאומטריים.
  • הנפשה: בנייה וקריאה AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, ו Extrapolation נתונים.
  • תמיכה בזרם ובבופר: טעינת סצנות תלת-ממד מזיכרון Buffer אובייקטים דרך scene.openFromBuffer() למקרים של serverless וזרימה.
  • דוגמאות שימוש מלאות: סקריפטים של TypeScript מקצה לקצה לטעינת OBJ, ייצוא GLB, המרה חוזרת של STL, וניווט בגרפי סצנה.
  • טיפים, בעיות נפוצות, ושאלות נפוצות: הדרכה מעשית למניעת מלכודות נפוצות בשימוש בייצור.
  • סיכום התייחסות ל‑API: רשימת ייחוס מהירה של כל המחלקות המרכזיות ושיטותיהן העיקריות.

מושגים מרכזיים

גרף סצנה: כל תוכן תלת‑ממדי ב-Aspose.3D FOSS מיוצג כעץ של Node אובייקטים שמקורים ב scene.rootNode. כל צומת יכול לשאת Entity (כגון a Mesh, Camera, או Light) Transform שממקם אותו במבנה ההיררכי.

API בלתי תלוי בפורמט: אתה פותח כל פורמט נתמך דרך scene.open() או scene.openFromBuffer() ושומר לכל פורמט נתמך דרך scene.save(). אותם עצמים של גרף הסצנה משמשים ללא קשר לפורמט המקור או היעד.

הקלטה חזקה של TypeScript: הספרייה מגיעה עם הגדרות מהדר קפדניות (noImplicitAny, strictNullChecks) והגדרות טיפוסים מלאות. כל מחלקה, שיטה, ו‑property של אפשרות מוקצית במלואה, מה שמספק השלמה אוטומטית ב‑IDE ובטיחות בזמן הקומפילציה לאורך כל קוד העיבוד התלת‑ממדי שלך.

תלות יחידה: התלות היחידה בזמן ריצה היא xmldom, שמותקנת אוטומטית על ידי npm. אין תוספים מקומיים לקימפול ואין חבילות מערכת להתקנה.

התחלה

אם עדיין לא התקנת את הספרייה, ראה את התחלה הקטע וה התקנה מדריך לפני המשך הקריאה.

נושאים זמינים

 עברית