add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light (Operator)
Name
add_scene_3d_lightT_add_scene_3d_lightAddScene3dLightAddScene3dLightadd_scene_3d_light — Hinzufügen einer Lichtquelle zu einer 3D-Szene.
Signatur
Beschreibung
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light fügt ein neue Lichtquelle zur 3D-Szene
Scene3DScene3DScene3DScene3Dscene3Dscene_3d hinzu und gibt ihren Index in LightIndexLightIndexLightIndexLightIndexlightIndexlight_index zurück.
Der Typ der Lichtquelle wird in LightKindLightKindLightKindLightKindlightKindlight_kind festgelegt. Für
LightKindLightKindLightKindLightKindlightKindlight_kind = 'point_light'"point_light""point_light""point_light""point_light""point_light" entspricht LightPositionLightPositionLightPositionLightPositionlightPositionlight_position
der Position der Lichtquelle.
Für LightKindLightKindLightKindLightKindlightKindlight_kind = 'directional_light'"directional_light""directional_light""directional_light""directional_light""directional_light" entspricht
LightPositionLightPositionLightPositionLightPositionlightPositionlight_position dem Vektor der gerichteten Lichtquelle.
Momentan wird nur eine Lichtquelle unterstützt. Deshalb überschreibt
add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light die bestehende Lichtquelle. Dieses Verhalten
kann sich in zukünftigen Versionen ändern.
Wird keine Lichtquelle gesetzt, wird eine Punktlichtquelle an der
Position [-100.0, -100.0, 0.0] verwendet.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der 3D-Szene.
LightPositionLightPositionLightPositionLightPositionlightPositionlight_position (input_control) real-array → HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Position der neuen Lichtquelle.
Defaultwert: [-100.0,-100.0,0.0]
LightKindLightKindLightKindLightKindlightKindlight_kind (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Typ der neuen Lichtquelle.
Defaultwert:
'point_light'
"point_light"
"point_light"
"point_light"
"point_light"
"point_light"
Werteliste: '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 der neuen Lichtquelle in der 3D-Szene.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert add_scene_3d_lightadd_scene_3d_lightAddScene3dLightAddScene3dLightAddScene3dLightadd_scene_3d_light
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d
Nachfolger
set_scene_3d_light_paramset_scene_3d_light_paramSetScene3dLightParamSetScene3dLightParamSetScene3dLightParamset_scene_3d_light_param
Siehe auch
remove_scene_3d_lightremove_scene_3d_lightRemoveScene3dLightRemoveScene3dLightRemoveScene3dLightremove_scene_3d_light
Modul
3D Metrology