Camera
Methods: aspose.threed.entities (aspose-3d-foss)
Camera egy Entity ami meghatároz egy nézőpontot egy 3D jelenetben. Szabályozza, hogyan vetül a jelenet egy 2D képsíkra. Egy kamera csatlakozik egy Node a pozíciójának és tájolásának beállításához a jelenetben.
class Camera(Entity):Methods
A3DObject → SceneObject → Entity → Camera
Implementációs megjegyzések
Ebben a aspose-3d-foss kiadásban a Camera osztály egy deklarációs helyőrző. Csak projection_type és name funkcionálisan tárolódnak és lekérhetők. Az összes többi tulajdonság (near_plane, far_plane, field_of_view, aspect_ratio, stb.) olyan beállítókkal rendelkeznek, amelyek nem csinálnak semmit; a hozzárendelt értékek nem maradnak meg. Ezeknek a tulajdonságoknak a visszaolvasása a osztály alapértelmezett értékét adja vissza, függetlenül attól, hogy mi lett hozzárendelve.
3D fájlból (glTF, FBX) kameradata importálásakor a projection_type helyesen van értelmezve. Más kameraattribútumok elérhetők, ha a formátum a jelenetgrafikon metaadataiként tárolja őket.
Methods
Camera(name: str = None, projection_type: str = "PERSPECTIVE")| Name | Type | Access | Description |
|---|---|---|---|
name | str | Read/Write | Gets or sets the name. |
parent_nodes | `` | Read | Gets the parent nodes. |
excluded | bool | Read/Write | Gets or sets the excluded. |
parent_node | `` | Read/Write | Gets or sets the parent node. |
rotation_mode | `` | Read/Write | Gets or sets the rotation mode. |
near_plane | float | Read/Write | Gets or sets the near plane. |
far_plane | float | Read/Write | Gets or sets the far plane. |
aspect | float | Read/Write | Gets or sets the aspect. |
ortho_height | float | Read/Write | Gets or sets the ortho height. |
up | `` | Read/Write | Gets or sets the up. |
look_at | `` | Read/Write | Gets or sets the look at. |
direction | `` | Read/Write | Gets or sets the direction. |
target | `` | Read/Write | Gets or sets the target. |
aperture_mode | `` | Read/Write | Gets or sets the aperture mode. |
field_of_view | float | Read/Write | Gets or sets the field of view. |
field_of_view_x | float | Read/Write | Gets or sets the field of view x. |
field_of_view_y | float | Read/Write | Gets or sets the field of view y. |
width | float | Read/Write | Gets or sets the width. |
height | float | Read/Write | Gets or sets the height. |
aspect_ratio | float | Read/Write | Gets or sets the aspect ratio. |
magnification | `` | Read/Write | Gets or sets the magnification. |
projection_type | str | Read/Write | Gets or sets the projection type. |
scene | `` | Read/Write | Gets or sets the scene. |
properties | PropertyCollection | Read | Gets the properties. |
Methods
| Signature | Description |
|---|---|
__init__(name: str, projection_type) | |
move_forward(distance: float) | Moves the camera forward by the specified distance |
get_bounding_box() | Returns the bounding box. |
get_entity_renderer_key() | Not implemented in the FOSS edition — throws at runtime. Returns the entity renderer key. |
remove_property(property) | Removes a custom property identified by the given property object |
remove_property(property_name: str) | |
get_property(property: str) | Retrieves the value of a custom property by its identifier |
set_property(property: str, value) | Sets the property value. |
find_property(property: str) | Searches for a custom property and returns it if found |
Használati példák
Methods: Ebben a kiadásban csak projection_type funkcionálisan tárolva van. Tulajdonság hozzárendelések a near_plane, far_plane, field_of_view, és aspect_ratio elfogadva hiba nélkül, de nem maradnak meg.
Perspektív kamera
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")Ortográfiai kamera
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)Kamera kiolvasása importálás után
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}")