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

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

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

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

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

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

  • תמיכת פורמט: OBJ (עם חומרים .mtl), STL (בינארי ו‑ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, וה‑tokenizer של FBX בתהליך פיתוח, עם מחלקות אפשרויות טעינה ושמירה לכל פורמט.
  • גרף סצנה: איך Scene, Node, Entity, Transform, ו GlobalTransform להרכיב היררכיית סצנה מלאה, כולל דפוסי מעבר של צמתים ילדים.
  • Mesh API: עבודה עם control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, ו VertexElementSmoothingGroup לעיבוד גאומטריה.
  • מערכת חומרים: יישום LambertMaterial ו PhongMaterial לצמתים של הסצנה, ולקריאת תכונות חומר שנקראו מקבצי .mtl.
  • כלי מתמטיקה: שימוש ב Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, ו BoundingBox להמרות, שאילתות תיבת גבול וחישובים גאומטריים.
  • הנפשה: בנייה וקריאה AnimationClip, AnimationNode, KeyFrame, ו KeyframeSequence נתונים.
  • אפשרויות טעינה ושמירה: מחלקות אפשרויות לפי פורמט כגון ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • דוגמאות שימוש מלאות:סקריפטים מקצה לקצה של Python לטעינת OBJ, ייצוא STL, המרה חזרה של glTF, וניווט בגרפי סצנה.
  • טיפים, בעיות נפוצות ו-FAQ: הדרכה מעשית להימנעות ממלכודות נפוצות בשימוש בייצור.
  • סיכום תיעוד API: רשימת ייחוס מהירה של כל המחלקות המרכזיות.

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

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

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

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

התחלה

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

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

 עברית