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

Див. також

 Українська