Aspose.3D FOSS
Python
Light

Light

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

Light 是一个 Entity 向 3D 场景添加光源的组件。类似 Camera,，它附加到一个 Node 以控制其位置和方向。.

class Light(Camera):

Properties

A3DObject → SceneObject → Entity → Camera → Light

Light 继承自 Camera. Light 类本身并未公开除从 Camera 和 Entity. LightType 枚举用于对灯光进行分类，但没有 light_type 属性在 Light 类。.

Properties 

Light(name: str = None)
NameTypeAccessDescription
namestrRead/WriteGets or sets the name.
parent_nodes``ReadGets the parent nodes.
excludedboolRead/WriteGets or sets the excluded.
parent_node``Read/WriteGets or sets the parent node.
rotation_mode``Read/WriteGets or sets the rotation mode.
near_planefloatRead/WriteGets or sets the near plane.
far_planefloatRead/WriteGets or sets the far plane.
aspectfloatRead/WriteGets or sets the aspect.
ortho_heightfloatRead/WriteGets or sets the ortho height.
up``Read/WriteGets or sets the up.
look_at``Read/WriteGets or sets the look at.
direction``Read/WriteGets or sets the direction.
target``Read/WriteGets or sets the target.
aperture_mode``Read/WriteGets or sets the aperture mode.
field_of_viewfloatRead/WriteGets or sets the field of view.
field_of_view_xfloatRead/WriteGets or sets the field of view x.
field_of_view_yfloatRead/WriteGets or sets the field of view y.
widthfloatRead/WriteGets or sets the width.
heightfloatRead/WriteGets or sets the height.
aspect_ratiofloatRead/WriteGets or sets the aspect ratio.
magnification``Read/WriteGets or sets the magnification.
projection_typestrRead/WriteGets or sets the projection type.
scene``Read/WriteGets or sets the scene.
propertiesPropertyCollectionReadGets the properties.

Properties

SignatureDescription
__init__(name: str, light_type)
move_forward(distance: float)
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)
get_property(property: str)
set_property(property: str, value)Sets the property value.
find_property(property: str)

Light 也继承所有 Camera 属性（near_plane, far_plane,，等等），尽管这些对光对象没有意义。注意： Light 类未公开 a light_type 当前 API 表面的属性。.

LightType 值 

from aspose.threed.entities import LightType
PropertiesPropertiesProperties
LightType.POINT"POINT"从单一点向所有方向均匀发光。.
LightType.DIRECTIONAL"DIRECTIONAL"来自无限远源（如阳光）的平行光线。.
LightType.SPOT"SPOT"锥形光束；位置和方向很重要。.
LightType.AREA"AREA"从矩形区域发出的光。.
LightType.VOLUME"VOLUME"体积/全局光照光。.

使用示例

点光源 

from aspose.threed import Scene, FileFormat
from aspose.threed.entities import Light, LightType

scene = Scene()

light = Light("PointLight")
node = scene.root_node.create_child_node("light", light)
node.transform.set_translation(0.0, 10.0, 0.0)

scene.save("lit-scene.glb", FileFormat.GLTF)

方向光源 

from aspose.threed import Scene
from aspose.threed.entities import Light, LightType

scene = Scene()

sun = Light("Sun")
node = scene.root_node.create_child_node("sun", sun)
# Direction is controlled by the node's rotation
node.transform.set_euler_angles(-45.0, 30.0, 0.0)  # degrees

scene.save("directional-light.glb")

同时添加相机和光源 

from aspose.threed import Scene, FileFormat
from aspose.threed.entities import Camera, Light, LightType, ProjectionType

scene = Scene()

# Camera
cam = Camera("Cam", ProjectionType.PERSPECTIVE)
cam.field_of_view = 60.0
cam_node = scene.root_node.create_child_node("camera", cam)
cam_node.transform.set_translation(0.0, 5.0, 15.0)

# Directional light
light = Light("DirLight")
light_node = scene.root_node.create_child_node("light", light)
light_node.transform.set_euler_angles(-30.0, 45.0, 0.0)

scene.save("camera-and-light.glb", FileFormat.GLTF)

枚举导入场景中的光源 

from aspose.threed import Scene
from aspose.threed.entities import Light

scene = Scene()
scene.open("model.glb")

def find_lights(node, depth=0):
    if isinstance(node.entity, Light):
        print(f"{'  ' * depth}Light: {node.name}")
    for child in node.child_nodes:
        find_lights(child, depth + 1)

find_lights(scene.root_node)

另见

 中文