Aspose.3D FOSS
Python
Camera

Camera

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

Camera ir Entity kas definē skatpunktu 3D ainas. Tas kontrolē, kā aina tiek projekcēta uz 2D attēla plaknes. Kamera ir pievienota Node lai to novietotu un orientētu ainas vidū.

class Camera(Entity):

Methods

A3DObject → SceneObject → Entity → Camera

Implementācijas piezīmes

Šajā aspose-3d-foss izdevumā, Camera klase ir deklarācijas šablons. Tikai projection_type un name tiek funkcionāli saglabāti un atgūti. Visas citas īpašības (near_plane, far_plane, field_of_view, aspect_ratio, utt.) ir ar iestatītājiem, kas nav operācijas; piešķirtās vērtības netiek saglabātas. Atgriežot šīs īpašības, tiek atgriezta klases noklusējuma vērtība neatkarīgi no tam piešķirtā.

Importējot kameras datus no 3D faila (glTF, FBX), projection_type tiek pareizi parsēts. Citi kameras atribūti ir pieejami, ja formāts saglabā tos kā ainas grafika metadatus.

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

Lietošanas piemēri

Methods: Šajā izdevumā tiek saglabāts tikai projection_type tiek funkcionāli saglabāts. Īpašību piešķiršanas priekš near_plane, far_plane, field_of_view, un aspect_ratio tiek pieņemti bez kļūdām, bet neturpinās.

Perspektīva kamera 

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

Ortogrāfiska kamera 

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)

Kameras nolasīšana pēc importēšanas 

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

Skatīt arī

 Latviešu