Camera
Methods: aspose.threed.entities (aspose-3d-foss)
Camera è un Entity che definisce un punto di vista in una scena 3D. Controlla come la scena viene proiettata su un piano immagine 2D. Una fotocamera è collegata a Node per posizionarlo e orientarlo nella scena.
class Camera(Entity):Methods
A3DObject → SceneObject → Entity → Camera
Note di implementazione
In questa edizione di aspose-3d-foss, il Camera class è un stub di dichiarazione. Solo projection_type e name sono funzionalmente memorizzati e recuperabili. Tutte le altre proprietà (near_plane, far_plane, field_of_view, aspect_ratio, ecc.) hanno dei setter che sono no‑ops; i valori assegnati non vengono conservati. Il recupero di queste proprietà restituisce il valore predefinito della classe indipendentemente da ciò che è stato assegnato.
Quando si importano i dati della fotocamera da un file 3D (glTF, FBX), il projection_type viene analizzato correttamente. Altri attributi della fotocamera sono disponibili se il formato li memorizza come metadati del grafo della scena.
Methods
Camera(name: str = None, projection_type: str = "PERSPECTIVE")| Methods | Methods | Methods | Methods |
|---|---|---|---|
name | `str | None` | None |
projection_type | str | "PERSPECTIVE" | Tipo di proiezione iniziale. Usa ProjectionType.PERSPECTIVE o ProjectionType.ORTHOGRAPHIC. |
Methods
| Methods | Methods | Methods |
|---|---|---|
projection_type | str | Modalità di proiezione: "PERSPECTIVE" oppure "ORTHOGRAPHIC". Imposta con ProjectionType costanti. |
near_plane | float | Distanza al piano di ritaglio vicino. La geometria più vicina di questa non viene renderizzata. Predefinito 0.1. |
far_plane | float | Distanza al piano di ritaglio lontano. La geometria più lontana di questa non viene renderizzata. Predefinito 1000.0. |
field_of_view | float | Campo visivo verticale in gradi (solo telecamere prospettiche). Predefinito 0.0. |
field_of_view_x | float | Campo visivo orizzontale in gradi. Predefinito 0.0. |
field_of_view_y | float | Campo visivo verticale in gradi (stesso di field_of_view). Predefinito 0.0. |
aspect_ratio | float | Rapporto larghezza-altezza dell’immagine di output. Predefinito 1.0. |
ortho_height | float | Altezza del volume di visualizzazione ortografico in unità del mondo (solo telecamere ortografiche). Predefinito 100.0. |
name | str | Nome dell’oggetto telecamera. |
Esempi d’uso
Methods: In questa edizione, solo projection_type è memorizzato funzionalmente. Assegnazioni di proprietà per near_plane, far_plane, field_of_view, e aspect_ratio sono accettati senza errore ma non persistono.
Telecamera prospettica
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")Telecamera ortografica
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)Leggi la telecamera dopo l’importazione
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}")