add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light (算子名称)
名称
add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light — Add a light source to a 3D scene.
参数签名
描述
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light adds a new light source to the scene
Scene3DScene3DScene3DScene3Dscene3Dscene_3d and returns its index in LightIndexLightIndexLightIndexLightIndexlightIndexlight_index. The kind of
the light source must be specified in LightKindLightKindLightKindLightKindlightKindlight_kind.
For LightKindLightKindLightKindLightKindlightKindlight_kind = 'point_light'"point_light""point_light""point_light""point_light""point_light", LightPositionLightPositionLightPositionLightPositionlightPositionlight_position is
interpreted as the position of the light source.
For LightKindLightKindLightKindLightKindlightKindlight_kind = 'directional_light'"directional_light""directional_light""directional_light""directional_light""directional_light", LightPositionLightPositionLightPositionLightPositionlightPositionlight_position
is interpreted as the vector of the directional light source.
Currently only one light source is supported, such that
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light overwrites the existing light source. This may
be changed in future versions.
If no light source is set, a point light source at [-100.0, -100.0, 0.0]
is used.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D scene.
LightPositionLightPositionLightPositionLightPositionlightPositionlight_position (input_control) real-array → HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Position of the new light source.
Default:
[-100.0,-100.0,0.0]
LightKindLightKindLightKindLightKindlightKindlight_kind (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Type of the new light source.
Default:
'point_light'
"point_light"
"point_light"
"point_light"
"point_light"
"point_light"
List of values:
'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 (output_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the new light source in the 3D scene.
结果
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light returns 2 (
H_MSG_TRUE)
if all parameters are
correct. 如有必要，将引发异常。
可能的前置算子
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
模块
3D Metrology