Camera

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")

Name	Type	Access	Description
`name`	`str`	Read/Write	Gets or sets the name.
`parent_nodes`	``	Read	Gets the parent nodes.
`excluded`	`bool`	Read/Write	Gets or sets the excluded.
`parent_node`	``	Read/Write	Gets or sets the parent node.
`rotation_mode`	``	Read/Write	Gets or sets the rotation mode.
`near_plane`	`float`	Read/Write	Gets or sets the near plane.
`far_plane`	`float`	Read/Write	Gets or sets the far plane.
`aspect`	`float`	Read/Write	Gets or sets the aspect.
`ortho_height`	`float`	Read/Write	Gets or sets the ortho height.
`up`	``	Read/Write	Gets or sets the up.
`look_at`	``	Read/Write	Gets or sets the look at.
`direction`	``	Read/Write	Gets or sets the direction.
`target`	``	Read/Write	Gets or sets the target.
`aperture_mode`	``	Read/Write	Gets or sets the aperture mode.
`field_of_view`	`float`	Read/Write	Gets or sets the field of view.
`field_of_view_x`	`float`	Read/Write	Gets or sets the field of view x.
`field_of_view_y`	`float`	Read/Write	Gets or sets the field of view y.
`width`	`float`	Read/Write	Gets or sets the width.
`height`	`float`	Read/Write	Gets or sets the height.
`aspect_ratio`	`float`	Read/Write	Gets or sets the aspect ratio.
`magnification`	``	Read/Write	Gets or sets the magnification.
`projection_type`	`str`	Read/Write	Gets or sets the projection type.
`scene`	``	Read/Write	Gets or sets the scene.
`properties`	`PropertyCollection`	Read	Gets the properties.

Overview

Signature	Description
`__init__(name: str, projection_type)`
`move_forward(distance: float)`	Moves the camera forward by the specified distance
`get_bounding_box()`	Returns the bounding box.
`get_entity_renderer_key()`	Not implemented in the FOSS edition — throws at runtime. Returns the entity renderer key.
`remove_property(property)`	Removes a custom property identified by the given property object
`remove_property(property_name: str)`
`get_property(property: str)`	Retrieves the value of a custom property by its identifier
`set_property(property: str, value)`	Sets the property value.
`find_property(property: str)`	Searches for a custom property and returns it if found

ตัวอย่างการใช้งาน

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}")

Camera

Overview

หมายเหตุการใช้งาน

Overview

Overview

ตัวอย่างการใช้งาน

กล้อง Perspective

กล้อง Orthographic

อ่านกล้องหลังการนำเข้า

ดูเพิ่มเติม