Camera

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

Camera jest Entity który definiuje punkt widzenia w scenie 3D. Kontroluje, jak scena jest rzutowana na płaszczyznę obrazu 2D. Kamera jest dołączona do Node aby ustawić i skierować ją w scenie.

class Camera(Entity):

Methods

A3DObjectSceneObjectEntityCamera


Uwagi implementacyjne

W tej edycji aspose-3d-foss, Camera klasa jest szkielet deklaracji. Tylko projection_type i name są funkcjonalnie przechowywane i dostępne. Wszystkie inne właściwości (near_plane, far_plane, field_of_view, aspect_ratio, itp.) mają settery, które nie robią nic; przypisane wartości nie są zachowywane. Odczyt tych właściwości zwraca domyślną wartość klasy, niezależnie od tego, co zostało przypisane.

Podczas importowania danych kamery z pliku 3D (glTF, FBX), the projection_type jest prawidłowo parsowany. Inne atrybuty kamery są dostępne, jeśli format przechowuje je jako metadane grafu sceny.


Methods

Camera(name: str = None, projection_type: str = "PERSPECTIVE")
MethodsMethodsMethodsMethods
name`strNone`None
projection_typestr"PERSPECTIVE"Początkowy typ projekcji. Użyj ProjectionType.PERSPECTIVE lub ProjectionType.ORTHOGRAPHIC.

Methods

MethodsMethodsMethods
projection_typestrTryb projekcji: "PERSPECTIVE" lub "ORTHOGRAPHIC". Ustaw za pomocą ProjectionType stałymi.
near_planefloatOdległość do najbliższej płaszczyzny przycinania. Geometria bliższa niż ta nie jest renderowana. Domyślnie 0.1.
far_planefloatOdległość do najdalszej płaszczyzny przycinania. Geometria dalsza niż ta nie jest renderowana. Domyślnie 1000.0.
field_of_viewfloatPionowy kąt widzenia w stopniach (tylko kamery perspektywiczne). Domyślnie 0.0.
field_of_view_xfloatPoziomy kąt widzenia w stopniach. Domyślnie 0.0.
field_of_view_yfloatPionowy kąt widzenia w stopniach (tak samo jak field_of_view). Domyślnie 0.0.
aspect_ratiofloatStosunek szerokości do wysokości obrazu wyjściowego. Domyślnie 1.0.
ortho_heightfloatWysokość objętości widoku ortograficznego w jednostkach świata (tylko kamery ortograficzne). Domyślnie 100.0.
namestrNazwa obiektu kamery.

Przykłady użycia

Methods: W tej edycji, tylko projection_type jest funkcjonalnie przechowywany. Przypisania właściwości dla near_plane, far_plane, field_of_view, oraz aspect_ratio są akceptowane bez błędu, ale nie są zachowywane.

Kamera perspektywiczna

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 ortograficzna

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)

Odczyt kamery po imporcie

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

Zobacz także

 Polski