Aspose.3D FOSS
Python
Camera

Camera

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

Camera adalah sebuah Entity yang mendefinisikan sudut pandang dalam sebuah adegan 3D. Ini mengontrol bagaimana adegan diproyeksikan ke bidang gambar 2D. Sebuah kamera terpasang pada sebuah Node untuk menempatkan dan mengorientasikan kamera dalam adegan.

class Camera(Entity):

Methods

A3DObject → SceneObject → Entity → Camera

Catatan Implementasi

Dalam edisi aspose-3d-foss ini, Camera kelas adalah sebuah stub deklarasi. Hanya projection_type dan name disimpan secara fungsional dan dapat diambil kembali. Semua properti lainnya (near_plane, far_plane, field_of_view, aspect_ratio, dll.) memiliki setter yang tidak melakukan apa-apa; nilai yang diberikan tidak disimpan. Membaca kembali properti ini mengembalikan nilai default kelas terlepas dari apa yang telah ditetapkan.

Saat mengimpor data kamera dari file 3D (glTF, FBX), projection_type diparse dengan benar. Atribut kamera lainnya tersedia jika format menyimpannya sebagai metadata grafik-adegan.

Methods 

Camera(name: str = None, projection_type: str = "PERSPECTIVE")
NameTypeAccessDescription
namestrRead/WriteGets or sets the name.
parent_nodes``ReadGets the parent nodes.
excludedboolRead/WriteGets or sets the excluded.
parent_node``Read/WriteGets or sets the parent node.
rotation_mode``Read/WriteGets or sets the rotation mode.
near_planefloatRead/WriteGets or sets the near plane.
far_planefloatRead/WriteGets or sets the far plane.
aspectfloatRead/WriteGets or sets the aspect.
ortho_heightfloatRead/WriteGets or sets the ortho height.
up``Read/WriteGets or sets the up.
look_at``Read/WriteGets or sets the look at.
direction``Read/WriteGets or sets the direction.
target``Read/WriteGets or sets the target.
aperture_mode``Read/WriteGets or sets the aperture mode.
field_of_viewfloatRead/WriteGets or sets the field of view.
field_of_view_xfloatRead/WriteGets or sets the field of view x.
field_of_view_yfloatRead/WriteGets or sets the field of view y.
widthfloatRead/WriteGets or sets the width.
heightfloatRead/WriteGets or sets the height.
aspect_ratiofloatRead/WriteGets or sets the aspect ratio.
magnification``Read/WriteGets or sets the magnification.
projection_typestrRead/WriteGets or sets the projection type.
scene``Read/WriteGets or sets the scene.
propertiesPropertyCollectionReadGets the properties.

Methods

SignatureDescription
__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

Contoh Penggunaan

Methods: Dalam edisi ini, hanya projection_type disimpan secara fungsional. Penetapan properti untuk near_plane, far_plane, field_of_view, dan aspect_ratio diterima tanpa error tetapi tidak bertahan.

Kamera Perspektif 

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

Kamera Ortografis 

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)

Baca Kamera Setelah Impor 

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

Lihat Juga

 Bahasa Indonesia