Widget API: Model:SetLight

Revision as of 08:05, 12 October 2017 by 2600:8800:2e84:8800:281f:44b2:d754:b5ff (talk) (Changed 'enabled' and 'omni' arguments to reflect their change to boolean instead of 1 or 0, and added slight description for what omni is for.)

Widget API ← Model < SetLight


Example
myModel:SetLight(true, false, 0, -0.707, -0.707, 0.7, 1.0, 1.0, 1.0, 0.8, 1.0, 1.0, 0.8);

Model:SetLight(enabled[,omni,dirX,dirY,dirZ,ambIntensity[,ambR,ambG,ambB[,dirIntensity[,dirR,dirG,dirB]]]])]]



Arguments
  • enabled: boolean - appears to be true for lit and false for unlit
  • omni: boolean - if the light is omnidirectional [lighting in all directions] (default of 0)
  • dirX, dirY, dirZ: numbers - vector from the origin to where the light source should face
  • ambIntensity: number - intensity of the ambient component of the light source
  • ambR, ambG, ambB: numbers - color of the ambient component of the light source
  • dirIntensity: number - intensity of the direct component of the light source
  • dirR, dirG, dirB: numbers - color of the direct component of the light source

Details
It seems that the direct component only influences the specularity.
The dir-vector is only used to determine the direction that the light source faces; its distance from the mesh does not affect the light level.