Aspose.3D FOSS
Python
Camera

Camera — Aspose.3D FOSS for Python API Reference

Package: aspose.threed.entities (aspose-3d-foss)

Camera is an Entity that defines a viewpoint in a 3D scene. It controls how the scene is projected onto a 2D image plane. A camera is attached to a Node to position and orient it in the scene.

class Camera(Entity):

Inheritance

A3DObject → SceneObject → Entity → Camera

Implementation Notes

In this edition of aspose-3d-foss, the Camera class is a declaration stub. Only projection_type and name are functionally stored and retrievable. All other properties (near_plane, far_plane, field_of_view, aspect_ratio, etc.) have setters that are no-ops; the assigned values are not retained. Read-back of these properties returns the class default value regardless of what was assigned.

When importing camera data from a 3D file (glTF, FBX), the projection_type is parsed correctly. Other camera attributes are available if the format stores them as scene-graph metadata.

Constructor 

Camera(name: str = None, projection_type: str = "PERSPECTIVE")
ParameterTypeDefaultDescription
namestr | NoneNoneOptional name for the camera node.
projection_typestr"PERSPECTIVE"Initial projection type. Use ProjectionType.PERSPECTIVE or ProjectionType.ORTHOGRAPHIC.

Properties

PropertyTypeDescription
projection_typestrProjection mode: "PERSPECTIVE" or "ORTHOGRAPHIC". Set with ProjectionType constants.
near_planefloatDistance to the near clipping plane. Geometry closer than this is not rendered. Default 0.1.
far_planefloatDistance to the far clipping plane. Geometry farther than this is not rendered. Default 1000.0.
field_of_viewfloatVertical field of view in degrees (perspective cameras only). Default 0.0.
field_of_view_xfloatHorizontal field of view in degrees. Default 0.0.
field_of_view_yfloatVertical field of view in degrees (same as field_of_view). Default 0.0.
aspect_ratiofloatWidth-to-height ratio of the output image. Default 1.0.
ortho_heightfloatHeight of the orthographic view volume in world units (orthographic cameras only). Default 100.0.
namestrName of the camera object.

Usage Examples

Note: In this edition, only projection_type is functionally stored. Property assignments for near_plane, far_plane, field_of_view, and aspect_ratio are accepted without error but do not persist.

Perspective Camera 

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 Camera 

from aspose.threed import Scene
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")

Read Camera After Import 

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

See Also