Camera — Aspose.3D FOSS for Python API Reference
Overview: aspose.threed.entities (aspose-3d-foss)
Camera เป็น Entity ซึ่งกำหนดมุมมองในฉาก 3D มันควบคุมว่าฉากจะถูกฉายลงบนระนาบภาพ 2D อย่างไร กล้องจะถูกแนบกับ Node เพื่อกำหนดตำแหน่งและทิศทางของมันในฉาก.
class Camera(Entity):Overview
A3DObject → SceneObject → Entity → Camera
หมายเหตุการใช้งาน
ในรุ่นนี้ของ aspose-3d-foss, Camera คลาสเป็น สเตบการประกาศ. เฉพาะ projection_type และ name ถูกจัดเก็บและดึงคืนได้ตามการทำงาน ทั้งคุณสมบัติอื่น ๆ (near_plane, far_plane, field_of_view, aspect_ratio, เป็นต้น) มีตัวตั้งค่าที่ไม่มีผล; ค่าที่กำหนดจะไม่ถูกเก็บไว้ การอ่านค่ากลับของคุณสมบัติเหล่านี้จะคืนค่าตั้งต้นของคลาสไม่ว่าค่าที่กำหนดจะเป็นอะไร.
เมื่อทำการนำเข้าข้อมูลกล้องจากไฟล์ 3D (glTF, FBX), projection_type จะถูกแยกวิเคราะห์อย่างถูกต้อง คุณลักษณะกล้องอื่น ๆ จะพร้อมใช้งานหากรูปแบบไฟล์เก็บไว้เป็นเมทาดาต้าในกราฟฉาก.
Overview
Camera(name: str = None, projection_type: str = "PERSPECTIVE")| Overview | Overview | Overview | Overview |
|---|---|---|---|
name | `str | None` | None |
projection_type | str | "PERSPECTIVE" | ประเภทการฉายเริ่มต้น. ใช้ ProjectionType.PERSPECTIVE หรือ ProjectionType.ORTHOGRAPHIC. |
Overview
| Overview | Overview | Overview |
|---|---|---|
projection_type | str | โหมดการฉาย: "PERSPECTIVE" หรือ "ORTHOGRAPHIC". ตั้งค่าด้วย ProjectionType ค่าคงที่. |
near_plane | float | ระยะทางถึงระนาบตัดใกล้ที่สุด เรขาคณิตที่อยู่ใกล้กว่านี้จะไม่ถูกเรนเดอร์ ค่าเริ่มต้น 0.1. |
far_plane | float | ระยะทางถึงระนาบตัดไกลที่สุด เรขาคณิตที่อยู่ไกลกว่านี้จะไม่ถูกเรนเดอร์ ค่าเริ่มต้น 1000.0. |
field_of_view | float | มุมมองแนวตั้งเป็นองศา (สำหรับกล้อง perspective เท่านั้น) ค่าเริ่มต้น 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 | ชื่อของอ็อบเจกต์กล้อง. |
ตัวอย่างการใช้งาน
Overview: ในฉบับนี้, มีเพียง projection_type ถูกจัดเก็บในเชิงฟังก์ชัน. การกำหนดค่าคุณสมบัติสำหรับ near_plane, far_plane, field_of_view, และ aspect_ratio จะถูกยอมรับโดยไม่มีข้อผิดพลาดแต่จะไม่คงอยู่.
กล้อง Perspective
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")กล้อง Orthographic
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}")