IC8 Python API:RLPy RIPointLight

Main article: iC8 Modules.

Last modified: 10/21/2026

Description

This class provides operations specific to Point Lights. Besides the inherited member functions from RILight, the point light's range value can also be adjusted.

Class Methods

RLPy.RIPointLight.ClearRectTexture(self)

Clear rectangle texture of this light.

Experimental API

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.GetInverseSquare(self)

Get if light's intensity follows inverse-square law in physics.

Experimental API

Returns

True if light's intensity follows inverse-square law, False if it is not - bool

1 # No example

RLPy.RIPointLight.GetRange(self)

Get the light range.

Experimental API

Returns

The value of the "range" attribute of the light node - float

1 # use light name to find object
2 light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Point light")
3 #get light range
4 print(light_object.GetRange())

RLPy.RIPointLight.GetRectWidthHeight(self)

Get the light's rectangle's width & height.

Experimental API

Returns

rectangle's width & height - RLPy.RVector2f

Parameters

kTime[in] The time at which to set the multiplier.

fMultiplier[in] The Light multiplier value.

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.GetTubeLength(self)

Get the light's tube length.

Experimental API

Returns

light's tube length - float

1 # No example

RLPy.RIPointLight.GetTubeRadius(self)

Get the light's tube Radius.

Experimental API

Returns

light's tube Radius - float

1 # No example

RLPy.RIPointLight.GetTubeSoftRadius(self)

Get the light's tube SoftRadius.

Experimental API

Returns

light's tube SoftRadius - float

1 # No example

RLPy.RIPointLight.IsCastShadow(self)

Get the light if cast shadow enable.

Experimental API

Returns

True if light is cast shadow enable, False if not - bool

1 # No example

RLPy.RIPointLight.IsRectangleShape(self)

Get if light's shape is a rectangle.

Experimental API

Returns

True if light's shape is a rectangle, False if it is not - bool

1 # No example

RLPy.RIPointLight.IsTubeShape(self)

Get if light's shape is a tube, sphere is also considered a tube with zero length.

Experimental API

Returns

True if light's shape is a tube, False if it is not - bool

1 # No example

RLPy.RIPointLight.LoadIes(self, strIesFilePath)

Load an IES file for this light.

Experimental API

Parameters

strIesFilePath[in] The IES file path you want to load - string

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.LoadRectTexture(self, strTexturePath)

Load a rectangle texture for this light.

Experimental API

Parameters

strTexturePath[in] The texture path you want to load - string

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SaveIes(self, strIesFilePath)

Save the IES file of this light.

Experimental API

Parameters

strIesFilePath[in] The IES file path you want to save - string

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SaveRectTexture(self, strTexturePath)

Save the rectangle texture of this light.

Experimental API

Parameters

strTexturePath[in] The texture path you want to save - string

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetCastShadow(self, bEnable)

Set the light's cast shadow is enable.

Experimental API

Parameters

bEnable[in] If light's cast shadow is enable - bool

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetInverseSquare(self, b)

Set light's intensity to follow inverse-square law in physics.

Experimental API

Parameters

b[in] If light's intensity follows inverse-square law - bool

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetRange(self, kTime, fRange)

Set the light range.

Experimental API

Parameters

kTime[in] The time at which to set the beam - RLPy.RLTime

fRange[in] The Light range value - float

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 light_object = RLPy.RScene.FindObject(RLPy.EObjectType_Light, "Point light") # use light name to find object
2 
3 #set light range
4 light_object.SetRange(RLPy.RTime(0), 1000.0)
5 print(light_object.GetRange())

RLPy.RIPointLight.SetRectangleShape(self, bRectangle)

Set the light's shape to rectangle.

Experimental API

Parameters

bRectangle[in] If light's shape is a rectangle - bool

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetRectWidthHeight(self, vWidthHeight)

Set the light's rectangle's width & height.

Experimental API

Parameters

vWidthHeight[in] rectangle's width & height - RLPy.RVector2f

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetTubeLength(self, fLength)

Set the light's tube length.

Experimental API

Parameters

fLength[in] tube length - float

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetTubeRadius(self, radius)

Set the light's tube radius.

Experimental API

Parameters

radius[in] tube radius - float

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetTubeShape(self, bTube)

Set the light's shape to tube, sphere is also considered a tube with zero length.

Experimental API

Parameters

bTube[in] If light's shape is a tube - bool

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

RLPy.RIPointLight.SetTubeSoftRadius(self, softRadius)

Set the light's tube soft radius.

Experimental API

Parameters

softRadius[in] tube soft radius - float

Returns

RLPy.RStatus.Success - Succeed

RLPy.RStatus.Failure - Fail

1 # No example

Description

This class provides operations specific to Point Lights. Besides the inherited member functions from RILight, the point light's range value can also be adjusted.

Constructor & Destructor

__init__ (self, *args, **kwargs)

Initializes a new ri point light instance.

Parameters

• args
• kwargs

Member Functions

ClearRectTexture (self)

Clears rectangle texture of this light.

GetInverseSquare (self)

Gets if light's intensity follows <a href="https://en.wikipedia.org/wiki/Inverse-square_law">inverse-square law in physics.</a> Its intensity is inversely proportional to the square of the distance from the source.

GetRange (self)

Get the point light range. See Also: SetRange

GetRectWidthHeight (self)

Gets the light's rectangle's width & height.

GetTubeLength (self)

Gets the light's tube length.

GetTubeRadius (self)

Gets the light's tube Radius.

GetTubeSoftRadius (self)

Gets the light's tube SoftRadius.

IsCastShadow (self)

Gets the light if cast shadow enable.

IsRectangleShape (self)

Gets if light's shape is a rectangle.

IsTubeShape (self)

Gets if light's shape is a tube, sphere is also considered a tube with zero length.

LoadIes (self, strIesFilePath)

Loads an IES file for this light.

Parameters

• strIesFilePath

LoadRectTexture (self, strTexturePath)

Loads a rectangle texture for this light.

Parameters

• strTexturePath

SaveIes (self, strIesFilePath)

Saves the IES file of this light.

Parameters

• strIesFilePath

SaveRectTexture (self, strTexturePath)

Saves the rectangle texture of this light.

Parameters

• strTexturePath

SetCastShadow (self, bEnable)

Sets the light's cast shadow is enable.

Parameters

• bEnable

SetInverseSquare (self, b)

Sets light's intensity to follow <a href="https://en.wikipedia.org/wiki/Inverse-square_law">inverse-square law in physics.</a>.

Parameters

• b

SetRange (self, kTime, fRange)

Set the point light range. See Also: GetRange

Parameters

• kTime
• fRange

SetRectWidthHeight (self, vWidthHeight)

Sets the light's rectangle's width & height.

Parameters

• vWidthHeight

SetRectangleShape (self, bRectangle)

Sets the light's shape to rectangle.

Parameters

• bRectangle

SetTubeLength (self, fLength)

Sets the light's tube length.

Parameters

• fLength

SetTubeRadius (self, radius)

Sets the light's tube radius.

Parameters

• radius

SetTubeShape (self, bTube)

Sets the light's shape to tube, sphere is also considered a tube with zero length.

Parameters

• bTube

SetTubeSoftRadius (self, softRadius)

Sets the light's tube soft radius.

Parameters

• softRadius

Properties

thisown

Indicates whether this SWIG proxy owns the underlying C++ object.

{"minExpandLevel":2}

• Python API
• API_Modules
  • Mathematics
    • RMath
    • RVector2
    • RVector3
    • RVector4
    • RMatrix3
    • RQuaternion
    • RTransform
    • RRgb
    • RColor
  • System
    • RStatus
    • RTime
    • RVariant
    • RFileIO
    • RGlobal
    • RPyTimer
    • RApplication
  • Scene
    • RIBase
    • RIObject
    • RINode
    • RIMaterialComponent
    • RIProp
    • RIAvatar
    • RICamera
    • RIParticle
    • RILight
    • RISpotLight
    • RIPointLight
    • RIDirectionalLight
    • RScene
  • Animation
    • RDataBlock
    • RKey
    • RControl
    • RFloatkey
    • RFloatControl
    • RTransformkey
    • RTransformControl
    • RlClip
    • RISkeletonComponent
    • RVisemeSmoothOption
    • RIVisemeComponent
    • RIMorphComponent
    • RIHikEffectorComponent
    • RIFaceComponent
  • MotionCapture
    • RPositionSetting
    • RRotationSetting
    • RDeviceSetting
    • RIDeviceBase
    • RBodySetting
    • RIBodyDevice
    • RHandSetting
    • RIHandDevice
    • RFacialSetting
    • RIFacialDevice
    • RIMocapManager
  • Events
    • RCallback
    • RWinMessageCallback
    • RDialogCallback
    • REventCallback
    • REventHandler
    • RPyTimerCallback
    • RIEventListener
  • UI
    • RIDialog
    • RIDockWidget
    • RUi
  • Media
    • RIAudioObject
    • RAudioRecorder
    • RAudio
    • RAudioRecorderCallback
  • Networking
    • RTcpCallback
    • RTcpClient
    • RUdpCallback
    • RUdpClient