Skip to content

3D lighting

3D lighting methods allow you to create complex lighting scenes inside DirectGPU.

Method
addAmbientLight(displayId : DisplayID, r : number, g : number, b : number, intensity : number) : ()
addDirectionalLight(displayId : DisplayID, dirX : number, dirY : number, dirZ : number, r : number, g : number, b : number, intensity : number) : ()
clearLights(displayId : DisplayID) : ()
setBackfaceCulling(displayId : DisplayID, enabled : boolean) : ()
setPhongShading(displayId : DisplayID, enabled : boolean) : ()

Adds ambient light affecting the whole scene evenly.

Requires: DisplayID, r : number, g : number, b : number, intensity : number

gpu.addAmbientLight(displayId, 40, 40, 40, 0.3)

Adds a directional light shining in the given direction.

Requires: DisplayID, dirX : number, dirY : number, dirZ : number, r : number, g : number, b : number, intensity : number

gpu.addDirectionalLight(displayId, 0, -1, 0, 255, 255, 255, 0.8)

Removes all lights from the display’s 3D scene.

Requires: DisplayID

gpu.clearLights(displayId)

Turns backface culling on or off. Useful for performance and cleaner solid models.

Requires: DisplayID, enabled : boolean

gpu.setBackfaceCulling(displayId, true)

Turns phong shading on or off. Use it if you want smoother lighting on supported geometry.

Requires: DisplayID, enabled : boolean

gpu.setPhongShading(displayId, true)