IC Python API:RLPy RIDirectionalLight

From Reallusion Wiki!
Revision as of 02:09, 6 April 2020 by Chuck (RL) (Talk | contribs)

Jump to: navigation, search
Main article: Modules.
Last modified: 04/6/2020

Description

This class provides operations for Directional Lights, e.g. whether or not to cast shadows, the light's color, light strength, etc. You must first retrieve a directional light from the scene in order to use these operations.

Inheritance

Member Functions

SetCastShadow ( self, bEnable )

Turn on or off the directional light's cast shadow.

light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Dir. Light")

if light_object:
    light_object.SetCastShadow(True)
    light_object.SetCastShadow(False)

Parameters

bEnable [in] Enable or disable cast shadows for the light - bool

Returns

Success - RLPy.RStatus.Success
Failure - RLPy.RStatus.Failure

IsCastShadow ( self )

Check whether or not the light is casting shadows.

light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Dir. Light")

if light_object:
    light_object.SetCastShadow(True)
    print(light_object.IsCastShadow())

    light_object.SetCastShadow(False)
    print(light_object.IsCastShadow())

Returns

True if the light is casting shadows, else False - bool

SetDarkenShadowStrength ( self, kTime, fStrength )

Set the directional light's shadow strength at a given point in time (0 to 100).

light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Dir. Light")

if light_object:
  result = light_object.SetDarkenShadowStrength(RLPy.RGlobal.GetTime(), 50)
  print(result)

Parameters

fStrength [in] The Light shadow strength value - float

Returns

RLPy.RStatus.Success Success
RLPy.RStatus.Failure Fail

GetDarkenShadowStrength ( self )

Get the directional light's shadow strength at a given point in time (0 to 100).

Returns

The light's shadow strength value - float
light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Dir. Light")

if light_object:
  result = light_object.SetDarkenShadowStrength(RLPy.RGlobal.GetTime(), 50)
  print(light_object.GetDarkenShadowStrength())