GetElementLighting

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This function returns the lighting value for the specified element. This can be a player, ped, vehicle, object.

Syntax

float getElementLighting ( element theElement )

OOP Syntax Help! I don't understand this!

Method: element:getLighting(...)
Variable: .lighting


Required Arguments

  • theElement: The element whose lighting you want to retrieve.

Returns

Returns a float (0.0-0.5; 0 = dark; 0.5 = light) indicating the element's lighting, or false if invalid arguments were passed. This function will fail if called right after element creation.

Example

Click to collapse [-]
Clientside example

This example displays lighting values of streamed in players.

addEventHandler("onClientRender", root, function()
	for _, pl in ipairs(getElementsByType("player", root, true)) do
		local sX, sY = getScreenFromWorldPosition(getElementPosition(pl))
		if sX then
			dxDrawText("Lighting: "..tostring(getElementLighting(pl)), sX, sY)
		end
	end
end)

Requirements

Minimum server version n/a
Minimum client version 1.5.9-9.21367

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.5.9-9.21367" />

See Also