add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light添加场景三维光源（算子）
名称
add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light — 将光源添加到三维场景中。
签名
描述
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light 向场景 Scene3DScene3DScene3DScene3Dscene3Dscene_3d 添加新的光源，并将光源索引存储在 LightIndexLightIndexLightIndexLightIndexlightIndexlight_index 中。光源类型需通过 LightKindLightKindLightKindLightKindlightKindlight_kind 指定。当 LightKindLightKindLightKindLightKindlightKindlight_kind = 'point_light'"point_light""point_light""point_light""point_light""point_light" 时，LightPositionLightPositionLightPositionLightPositionlightPositionlight_position 表示光源位置；当 LightKindLightKindLightKindLightKindlightKindlight_kind = 'directional_light'"directional_light""directional_light""directional_light""directional_light""directional_light" 时，LightPositionLightPositionLightPositionLightPositionlightPositionlight_position 表示定向光源的方向向量。
目前仅支持单一光源，因此 add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light 会覆盖现有光源。此行为可能在未来版本中进行调整。
如未设置光源，则使用位于 [-100.0, -100.0, 0.0] 的点光源。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (输入控制) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
3D 场景的句柄。
LightPositionLightPositionLightPositionLightPositionlightPositionlight_position (输入控制) real-array → HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
新光源的位置。
默认值：
[-100.0,-100.0,0.0]
LightKindLightKindLightKindLightKindlightKindlight_kind (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
新光源的类型。
默认值：
'point_light'
"point_light"
"point_light"
"point_light"
"point_light"
"point_light"
值列表：
'directional_light'"directional_light""directional_light""directional_light""directional_light""directional_light", 'point_light'"point_light""point_light""point_light""point_light""point_light"
LightIndexLightIndexLightIndexLightIndexlightIndexlight_index (输出控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
3D 场景中新光源的索引。
结果
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light 在所有参数正确时返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的前趋
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d
可能的后继
set_scene_3d_light_paramset_scene_3d_light_paramSetScene3dLightParamSetScene3dLightParamSetScene3dLightParamset_scene_3d_light_param
另见
remove_scene_3d_lightremove_scene_3d_lightRemoveScene3dLightRemoveScene3dLightRemoveScene3dLightremove_scene_3d_light
模块
三维计量