Camera

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

Camera е Entity което определя гледна точка в 3D сцена. Тя контролира как сцената се проектира върху 2D равнина на изображението. Камера е прикрепена към Node за да я позиционира и ориентира в сцената.

class Camera(Entity):

Methods

A3DObjectSceneObjectEntityCamera


Забележки за имплементацията

В това издание на aspose-3d-foss, Camera класът е декларационен шаблон. Само projection_type и name се съхраняват функционално и могат да бъдат извлечени. Всички останали свойства (near_plane, far_plane, field_of_view, aspect_ratio, etc.) имат сетъри, които са без действие; зададените стойности не се запазват. При четене обратно на тези свойства се връща стойността по подразбиране на класа, независимо какво е било зададено.

При импортиране на данни за камера от 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}")

Вижте също

 Български