Camera
Methods: aspose.threed.entities (aspose-3d-foss)
Camera הוא Entity שמגדיר נקודת מבט בסצנה תלת‑ממדית. הוא שולט כיצד הסצנה מוצגת על מישור תמונה דו‑ממדי. מצלמה מחוברת ל‑ Node כדי למקם ולסובב אותה בסצנה.
class Camera(Entity):Methods
A3DObject → SceneObject → Entity → Camera
הערות יישום
בגרסה זו של aspose-3d-foss, ה‑ Camera המחלקה היא תבנית הצהרה. רק projection_type ו name מתועדים בפונקציונליות וניתנים לשחזור. כל שאר המאפיינים (near_plane, far_plane, field_of_view, aspect_ratio, וכו’) כוללים setters שהם no-ops; הערכים שהוקצו אינם נשמרים. קריאה חזרה של מאפיינים אלה מחזירה את ערך ברירת המחדל של המחלקה ללא קשר למה שהוקצה.
בעת ייבוא נתוני מצלמה מקובץ תלת‑ממדי (glTF, FBX), ה projection_type מתפרש כראוי. מאפייני מצלמה נוספים זמינים אם הפורמט שומר אותם כנתוני מטא של גרף‑סצנה.
Methods
Camera(name: str = None, projection_type: str = "PERSPECTIVE")| Methods | Methods | Methods | Methods |
|---|---|---|---|
name | `str | None` | None |
projection_type | str | "PERSPECTIVE" | סוג ההקרנה הראשוני. השתמש ב ProjectionType.PERSPECTIVE או ProjectionType.ORTHOGRAPHIC. |
Methods
| Methods | Methods | Methods |
|---|---|---|
projection_type | str | מצב פרויקטיה: "PERSPECTIVE" או "ORTHOGRAPHIC". הגדר עם ProjectionType קבועים. |
near_plane | float | מרחק למישור החיתוך הקרוב. גאומטריה הקרובה יותר מזה אינה מוצגת. ברירת מחדל 0.1. |
far_plane | float | מרחק למישור החיתוך הרחוק. גאומטריה הרחוקה יותר מזה אינה מוצגת. ברירת מחדל 1000.0. |
field_of_view | float | שדה ראייה אנכי במעלות (מצלמות פרספקטיביות בלבד). ברירת מחדל 0.0. |
field_of_view_x | float | שדה ראייה אופקי במעלות. ברירת מחדל 0.0. |
field_of_view_y | float | שדה ראייה אנכי במעלות (זהה ל field_of_view). ברירת מחדל 0.0. |
aspect_ratio | float | יחס רוחב-לגובה של תמונת הפלט. ברירת מחדל 1.0. |
ortho_height | float | גובה נפח תצוגה אורטוגרפי ביחידות עולם (רק למצלמות אורטוגרפיות). ברירת מחדל 100.0. |
name | str | שם של אובייקט המצלמה. |
דוגמאות שימוש
Methods: בגרסה זו, רק projection_type נשמר פונקציונלית. הקצאות מאפיינים עבור near_plane, far_plane, field_of_view, ו aspect_ratio מתקבלים ללא שגיאה אך אינם נשמרים.
מצלמת פרספקטיבה
from aspose.threed import Scene
from aspose.threed.entities import Camera
from aspose.threed.entities import ProjectionType
scene = Scene()
# projection_type is stored and saved
cam = Camera("MainCamera", ProjectionType.PERSPECTIVE)
node = scene.root_node.create_child_node("camera", cam)
# Position the camera using node transform (this does persist)
node.transform.set_translation(0.0, 5.0, 20.0)
scene.save("scene-with-camera.glb")מצלמת אורטוגרפית
from aspose.threed import Scene, FileFormat
from aspose.threed.entities import Camera, ProjectionType
scene = Scene()
# Only projection_type is retained; other property assignments are no-ops
cam = Camera("OrthoCamera", ProjectionType.ORTHOGRAPHIC)
scene.root_node.create_child_node("ortho_cam", cam)
scene.save("ortho-scene.glb", FileFormat.GLTF)קריאת מצלמה לאחר ייבוא
from aspose.threed import Scene
from aspose.threed.entities import Camera
scene = Scene()
scene.open("model.glb")
for node in scene.root_node.child_nodes:
if isinstance(node.entity, Camera):
cam = node.entity
# projection_type is reliably populated; other numeric properties
# return default values (0.0 / 1.0) regardless of file content
print(f"Camera '{cam.name}': {cam.projection_type}")