Resource:Dynamic lighting

From Multi Theft Auto: Wiki
Revision as of 10:58, 27 September 2014 by Renard712 (talk | contribs)
Jump to navigation Jump to search

This resource lets You create dynamic lights in MTA. It gives you a list of exported functions that You can use to create per pixel pointlights and spotlights. It should be considered a preview of what MTA:Eir will offer. The future solution should be more FPS friendly. Yet i see that resource as an example of what the future holds.

Overview

It is easy to use, gives a few options to create per pixel lights in gtasa.

The resource itself adds exported clientside functions:

Exported functions

createPointLight

Click to collapse [-]
Client

This function creates a pixel shader pointlight.

bool exports.dynamic_lighting:createPointLight(float posX,posY,posZ,colorR,colorG,colorB,colorA,attenuation,[bool normalShadow = true])

Required Arguments

  • float posX, posY, posZ: Light position in world.
  • float colorR,colorG,colorB,colorA: RGBA color emitted by the light (0 - 1 instead of 0-255).
  • float attenuation: Value specifying how the light intensity changes over distance.

Optional Arguments

  • bool normalShadow: Determine if the light source should be obscured when lighting a surface on opposite angles.

Returns

The function returns true if set successfully, false otherwise.

createSpotLight

Click to collapse [-]
Client

This function creates a pixel shader spotlight.

bool exports.dynamic_lighting:createSpottLight(float posX,posY,posZ,colorR,colorG,colorB,colorA,dirX,dirY,dirZ, bool isEuler,float falloff,theta,phi,attenuation,[bool normalShadowing = true])

Required Arguments

  • float posX, posY, posZ: Light position in world space.
  • float colorR,colorG,colorB,colorA: RGBA color emitted by the light (0 - 1 instead of 0-255).
  • float dirX,dirY,dirZ: Direction that the light is pointing in world space. It's a vector as default.
  • bool isEuler: Is the angle set as an "ZXY" euler andgle or a vector.
  • float dirX,dirY,dirZ: Direction that the light is pointing in world space. It's a vector as default.
  • float falloff: Decrease in illumination between a spotlight's inner cone (the angle specified by Theta) and the outer edge of the outer cone (the angle specified by Phi).
  • float theta: (radians) Angle, in radians, of a spotlight's inner cone - that is, the fully illuminated spotlight cone. This value must be in the range from 0 through the value specified by Phi.
  • float phi: (radians) Angle, in radians, defining the outer edge of the spotlight's outer cone. Points outside this cone are not lit by the spotlight. This value must be between 0 and pi.
  • float attenuation: Value specifying how the light intensity changes over distance.

Optional Arguments

  • bool normalShadow: Determine if the light source should be obscured when lighting a surface on opposite angles.

Returns

The function returns true if set successfully, false otherwise.

destroyLight

Click to collapse [-]
Client

This function destroys a light element.

bool exports.dynamic_lighting:destroyLight(element lightElement)

Required Arguments

  • element lightElement: A previously declared light element.

Returns

The function returns true if set successfully, false otherwise.

setLightDirection

Click to collapse [-]
Client

This function setd light direction values for both a pointlight and a spotlight.

bool exports.dynamic_lighting:setLightDirection(element lightElement,float dirX,dirY,dirZ,[bool isEuler = false])

Required Arguments

  • element lightElement: A previously declared light element.
  • float dirX,dirY,dirZ: Direction that the light is pointing in world space. It's a vector as default.

Optional Arguments

  • bool isEuler:Is the angle set as an "ZXY" euler andgle or a vector.

Returns

The function returns true if set successfully, false otherwise.

setLightPosition

Click to collapse [-]
Client

This function sets light position values for both a pointlight and a spotlight.

bool exports.dynamic_lighting:setLightPosition(element lightElement,float posX,posY,posZ)

Required Arguments

  • element lightElement: A previously declared light element.
  • float posX, posY, posZ: Light position in world space.

Returns

The function returns true if set successfully, false otherwise.

setLightColor

Click to collapse [-]
Client

This function sets light color values for both a pointlight and a spotlight.

bool exports.dynamic_lighting:setLightColor(element lightElement,float colorR,colorG,colorB,colorA)

Required Arguments

  • element lightElement: A previously declared light element.
  • float colorR,colorG,colorB,colorA: RGBA color emitted by the light (0 - 1 instead of 0-255).

Returns

The function returns true if set successfully, false otherwise.

setLightAttenuation

Click to collapse [-]
Client

This function sets setLightAttenuation value for both a pointlight and a spotlight.

bool exports.dynamic_lighting:setLightAttenuation(element lightElement,float attenuation)

Required Arguments

  • element lightElement: A previously declared light element.
  • float attenuation: Value specifying how the light intensity changes over distance.

Returns

The function returns true if set successfully, false otherwise.

setLightFalloff

Click to collapse [-]
Client

This function sets falloff value for a spotlight.

bool exports.dynamic_lighting:setLightFalloff(element lightElement,float falloff)

Required Arguments

  • element lightElement: A previously declared light element.
  • float falloff (radians): Decrease in illumination between a spotlight's inner cone (the angle specified by Theta) and the outer edge of the outer cone (the angle specified by Phi).

Returns

The function returns true if set successfully, false otherwise.

setLightTheta

Click to collapse [-]
Client

This function sets theta value for a spotlight.

bool exports.dynamic_lighting:setLightTheta(element lightElement,float theta)

Required Arguments

  • element lightElement: A previously declared light element.
  • float theta (radians): Angle, in radians, of a spotlight's inner cone - that is, the fully illuminated spotlight cone. This value must be in the range from 0 through the value specified by Phi.

Returns

The function returns true if set successfully, false otherwise.

setLightPhi

Click to collapse [-]
Client

This function sets phi value for a spotlight.

bool exports.dynamic_lighting:setLightPhi(element lightElement,float phi)

Required Arguments

  • element lightElement: A previously declared light element.
  • float phi (radians): Angle, in radians, defining the outer edge of the spotlight's outer cone. Points outside this cone are not lit by the spotlight. This value must be between 0 and pi.

Returns

The function returns true if set successfully, false otherwise.

setLightNormalShadowing

Click to collapse [-]
Client

Determine if the light source should be obscured when lighting a surface on opposite angles.

bool exports.dynamic_lighting:setLightNormalShadowing(element lightElement,bool normalShadow)

Required Arguments

  • element lightElement: A previously declared light element.
  • bool normalShadow: Determine if the light source should be obscured when lighting a surface on opposite angles.

Returns

The function returns true if set successfully, false otherwise.

setNormalShadowingAmount

Click to collapse [-]
Client

Determine global shadowing value ( for all lights).

bool exports.dynamic_lighting:setNormalShadowingAmount(element lightElement,float normalShadowAmmount)

Required Arguments

  • element lightElement: A previously declared light element.
  • float normalShadowAmmount: Determine global shadowing value (1-full 0-nil).

Returns

The function returns true if set successfully, false otherwise.

setGenerateBumpNormals

Click to collapse [-]
Client

Should the shader effect generate bump normals from texture0. Doesn't work when normal shadowing is set to false.

bool exports.dynamic_lighting:setGenerateBumpNormals(bool isTrue,[int textureSize = 512, float normalStrength.x = 1, float normalStrength.y = 1])

Required Arguments

  • bool isTrue: Turn on or off bump mapping.

Optional Arguments

  • int textureSize: The size of the input texture.
  • float normalStrength.xy: How bumpy should the surface be ?

Returns

The function returns true if set successfully, false otherwise.

setLightsDistFade

Click to collapse [-]
Client

Set the Max distance of the light to sync and the distance on which the light starts to fade out.

bool exports.dynamic_lighting:setLightsDistFade(int MaxEffectFade,int MinEffectFade)

Required Arguments

  • int MaxEffectFade: Set the Max distance of the light to sync.(Must be greater than MinEffectFade and lower than maxEffectRange).
  • int MinEffectFade: Set the distance on which the light starts to fade out.

Returns

The function returns true if set successfully, false otherwise.

setLightsEffectRange

Click to collapse [-]
Client

Set the Max distance from the camera the shader effects are applied to.

bool exports.dynamic_lighting:setLightsEffectRange(int maxEffectRange)

Required Arguments

  • int maxEffectRange: If non-zero, the shaders will be applied to textures nearer than maxDistance only.

Returns

The function returns true if set successfully, false otherwise.

setShaderForcedOn

Click to collapse [-]
Client

Should the shader effect turn off when no lightsources.

bool exports.dynamic_lighting:setShaderForcedOn(bool isShaderForcedOn)

Required Arguments

  • bool isShaderForcedOn: Should the shader effect turn off when no lightsources.

Returns

The function returns true if set successfully, false otherwise.

setShaderTimeOut

Click to collapse [-]
Client

Should the shader effect turn off after number of seconds (when no lightsources)

bool exports.dynamic_lighting:setShaderTimeOut(int timeOut)

Required Arguments

  • int timeOut: Should the shader effect turn off after number of seconds (when no lightsources)

Returns

The function returns true if set successfully, false otherwise.

setShaderNightMod

Click to collapse [-]
Client

Enable nightMod effect - requires proper manipulation of setTextureBrightness and SetShaderDayTime, also some additional shaders.

bool exports.dynamic_lighting:setShaderNightMod(bool enable)

Required Arguments

  • bool enable: Enable or disable nightMod effect

Returns

The function returns true if set successfully, false otherwise.

setShaderDayTime

Click to collapse [-]
Client

Another additional variable to control texture colors - requires setShaderNightMod(true)

bool exports.dynamic_lighting:setShaderDayTime(float dayTime)

Required Arguments

  • float dayTime: Another additional variable to control texture colors - requires setShaderNightMod(true) set 1 as default

Returns

The function returns true if set successfully, false otherwise.

setShaderPedDiffuse

Click to collapse [-]
Client

Enable or disable gta directional lights for ped.

bool exports.dynamic_lighting:setShaderPedDiffuse(bool enable)

Required Arguments

  • bool enable: Enable or disable gta directional lights for ped (enabled as default)

Returns

The function returns true if set successfully, false otherwise.

setDirLightEnable

Click to collapse [-]
Client

This function creates a vertex shader directional light. NOTE: Forcing the effects on or using any other lights is required for directional light to work.

bool exports.dynamic_lighting:setDirLightEnable(bool enable = false)

Required Arguments

  • bool enable: Enable or disable the directional light.

Returns

The function returns true if set successfully, false otherwise.

setDirLightDirection

Click to collapse [-]
Client

This function sets the directional light direction.

bool exports.dynamic_lighting:setDirLightDirection(float dirX,dirY,dirZ,[bool isEuler = false])

Required Arguments

  • float dirX,dirY,dirZ: Direction that the light is pointing in world space. It's a vector as default.

Optional Arguments

  • bool isEuler:Is the angle set as an "ZXY" euler andgle or a vector.

Returns

The function returns true if set successfully, false otherwise.

setDirLightColor

Click to collapse [-]
Client

This function sets the directional light color value.

bool exports.dynamic_lighting:setDirLightColor(float colorR,colorG,colorB,colorA)

Required Arguments

  • float colorR,colorG,colorB,colorA: RGBA color emitted by the light (0 - 1 instead of 0-255).

Returns

The function returns true if set successfully, false otherwise.

Examples

exports.dynamic_lighting:createPointLight(0,0,5,1,0,0,1,15)

This creates a red pointlight in world position (0,0,5)

Of course when you want to use these functions in your resources you have to include the dynamic_lighting resource in meta.

See Also

Dynamic Lighting resource on MTA Community

Light Types (Direct3D 9)

Vehicle lights video