Camera
Methods: aspose.threed.entities (aspose-3d-foss)
Camera bir Entity 3D bir sahnede bakış açısını tanımlayan bir şeydir. Sahnenin 2D bir görüntü düzlemine nasıl yansıtıldığını kontrol eder. Bir kamera bir Node sahnedeki konumunu ve yönünü ayarlamak için.
class Camera(Entity):Methods
A3DObject → SceneObject → Entity → Camera
Uygulama Notları
aspose-3d-foss’un bu sürümünde, Camera sınıf bir bildirim taslağı. Sadece projection_type ve name fonksiyonel olarak depolanır ve geri alınabilir. Diğer tüm özellikler (near_plane, far_plane, field_of_view, aspect_ratio, vb.) ayarlayıcıları etkisizdir; atanan değerler tutulmaz. Bu özelliklerin geri okunması, atanan ne olursa olsun sınıfın varsayılan değerini döndürür.
3D dosyadan (glTF, FBX) kamera verileri içe aktarılırken, projection_type doğru bir şekilde ayrıştırılır. Diğer kamera öznitelikleri, format bunları sahne grafiği meta verisi olarak depoluyorsa kullanılabilir.
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 |
Kullanım Örnekleri
Methods: Bu sürümde, yalnızca projection_type işlevsel olarak depolanır. Özellik atamaları için near_plane, far_plane, field_of_view, ve aspect_ratio hatasız kabul edilir ancak kalıcı değildir.
Perspektif 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")Ortografik 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)İçe Aktarmadan Sonra Kamerayı Oku
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}")