Aspose.3D FOSS
Python
Camera

Camera

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

Camera é um Entity que define um ponto de vista em uma cena 3D. Ele controla como a cena é projetada em um plano de imagem 2D. Uma câmera é anexada a um Node para posicioná‑la e orientá‑la na cena.

class Camera(Entity):

Methods

A3DObject → SceneObject → Entity → Camera

Observações de Implementação

Nesta edição do aspose-3d-foss, o Camera classe é um esboço de declaração. Apenas projection_type e name são armazenados funcionalmente e recuperáveis. Todas as outras propriedades (near_plane, far_plane, field_of_view, aspect_ratio, etc.) têm setters que são no‑ops; os valores atribuídos não são mantidos. A leitura dessas propriedades devolve o valor padrão da classe independentemente do que foi atribuído.

Ao importar dados de câmera de um arquivo 3D (glTF, FBX), o projection_type é analisado corretamente. Outros atributos da câmera estão disponíveis se o formato os armazenar como metadados do grafo de cena.

Methods 

Camera(name: str = None, projection_type: str = "PERSPECTIVE")
MethodsMethodsMethodsMethods
name`strNone`None
projection_typestr"PERSPECTIVE"Tipo inicial de projeção. Use ProjectionType.PERSPECTIVE ou ProjectionType.ORTHOGRAPHIC.

Methods

MethodsMethodsMethods
projection_typestrModo de projeção: "PERSPECTIVE" ou "ORTHOGRAPHIC". Defina com ProjectionType constantes.
near_planefloatDistância ao plano de recorte próximo. Geometria mais próxima que isso não é renderizada. Padrão 0.1.
far_planefloatDistância ao plano de recorte distante. Geometria mais distante que isso não é renderizada. Padrão 1000.0.
field_of_viewfloatCampo de visão vertical em graus (apenas câmeras em perspectiva). Padrão 0.0.
field_of_view_xfloatCampo de visão horizontal em graus. Padrão 0.0.
field_of_view_yfloatCampo de visão vertical em graus (mesmo que field_of_view). Padrão 0.0.
aspect_ratiofloatProporção largura/altura da imagem de saída. Padrão 1.0.
ortho_heightfloatAltura do volume de visualização ortográfica em unidades do mundo (apenas câmeras ortográficas). Padrão 100.0.
namestrNome do objeto câmera.

Exemplos de Uso

Methods: Nesta edição, apenas projection_type é armazenado funcionalmente. Atribuições de propriedade para near_plane, far_plane, field_of_view, e aspect_ratio são aceitas sem erro, mas não persistem.

Câmera Perspectiva 

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

Câmera Ortográfica 

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)

Ler Câmera Após Importação 

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

Veja Também

 Português