Aspose.3D FOSS
Python
Camera

Camera

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

Camera является Entity который определяет точку зрения в 3D‑сцене. Он контролирует, как сцена проецируется на 2D‑плоскость изображения. Камера прикреплена к Node для позиционирования и ориентации её в сцене.

class Camera(Entity):

Methods

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 парсится корректно. Другие атрибуты камеры доступны, если формат сохраняет их как метаданные графа сцены.

Methods 

Camera(name: str = None, projection_type: str = "PERSPECTIVE")
MethodsMethodsMethodsMethods
name`strNone`None
projection_typestr"PERSPECTIVE"Начальный тип проекции. Используйте ProjectionType.PERSPECTIVE или ProjectionType.ORTHOGRAPHIC.

Methods

MethodsMethodsMethods
projection_typestrРежим проекции: "PERSPECTIVE" или "ORTHOGRAPHIC". Устанавливается с ProjectionType константами.
near_planefloatРасстояние до ближней плоскости отсечения. Геометрия, находящаяся ближе этого расстояния, не рендерится. По умолчанию 0.1.
far_planefloatРасстояние до дальней плоскости отсечения. Геометрия, находящаяся дальше этого расстояния, не рендерится. По умолчанию 1000.0.
field_of_viewfloatВертикальное поле зрения в градусах (только для перспективных камер). По умолчанию 0.0.
field_of_view_xfloatГоризонтальное поле зрения в градусах. По умолчанию 0.0.
field_of_view_yfloatВертикальное поле зрения в градусах (то же, что и field_of_view). По умолчанию 0.0.
aspect_ratiofloatСоотношение ширины к высоте выходного изображения. По умолчанию 1.0.
ortho_heightfloatВысота объёма ортографического просмотра в мировых единицах (только ортографические камеры). По умолчанию 100.0.
namestrИмя объекта камеры.

Примеры использования

Methods: В этом издании только projection_type функционально сохраняется. Присваивания свойств для near_plane, far_plane, field_of_view, и aspect_ratio принимаются без ошибки, но не сохраняются.

Перспективная камера 

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

Ортографическая камера 

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

См. также

 Русский