CreateCountTimer: Difference between revisions
From Onset Developer Wiki
Created page with "{{Info|Function|Server|1.0}} {{FuncDescription|__EDIT_ME__}} {{FuncSyntax|CreateCountTimer(LuaFunction, Interval, Count [, UserArgs])}} {{FuncParameters}} {{FuncParam|LuaFu..." |
No edit summary |
||
(4 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{Info|Function|Server|1.0}} | {{Info|Function|Server & Client|1.0}} | ||
{{FuncDescription| | {{FuncDescription|Creates a countdown timer.}} | ||
{{FuncSyntax|CreateCountTimer(LuaFunction, Interval, Count [, UserArgs])}} | {{FuncSyntax|CreateCountTimer(LuaFunction, Interval, Count [, UserArgs])}} | ||
{{FuncParameters}} | {{FuncParameters}} | ||
{{FuncParam|LuaFunction| | {{FuncParam|LuaFunction|The function to execute.}} | ||
{{FuncParam|Interval| | {{FuncParam|Interval|Interval to execute the function.}} | ||
{{FuncParam|Count | | {{FuncParam|Count|How often to execute this timer. Use [[CreateTimer]] for a non-stop version.}} | ||
{{FuncParamOptional|UserArgs| | {{FuncParamOptional|UserArgs|Arguments to pass to the function.}} | ||
{{FuncReturnValue| | {{FuncReturnValue|Returns the identifier to this timer. Use [[DestroyTimer]] to stop it.}} | ||
== Example == | == Example == | ||
<syntaxhighlight lang="Lua"> | |||
function cmd_vcolorfun(player) | |||
local vehicle = GetPlayerVehicle(player) | |||
if (vehicle == 0) then | |||
return AddPlayerChat(player, "You must be in a vehicle") | |||
end | |||
if (GetPlayerVehicleSeat(player) ~= 1) then | |||
return AddPlayerChat(player, "You must be the driver of the vehicle") | |||
end | |||
--Change color every 200ms of the players vehicle | |||
CreateCountTimer(function(vehicle) | |||
if not IsValidVehicle(vehicle) then | |||
return | |||
end | |||
local r = Random(100, 255) | |||
local g = Random(100, 255) | |||
local b = Random(100, 255) | |||
SetVehicleColor(vehicle, RGB(r, g, b)) | |||
end, 200, 16, vehicle) | |||
end | |||
AddCommand("vcolorfun", cmd_vcolorfun) | |||
</syntaxhighlight> | |||
{{RelatedFunctions}} | {{RelatedFunctions}} | ||
{{Template:TimerFunctions}} |
Latest revision as of 11:21, 1 September 2020
Description
Creates a countdown timer.
Syntax
CreateCountTimer(LuaFunction, Interval, Count [, UserArgs])
Parameters
- LuaFunction
The function to execute. - Interval
Interval to execute the function. - Count
How often to execute this timer. Use CreateTimer for a non-stop version. - UserArgs (optional)
Arguments to pass to the function.
Return Value
- Returns the identifier to this timer. Use DestroyTimer to stop it.
Example
function cmd_vcolorfun(player)
local vehicle = GetPlayerVehicle(player)
if (vehicle == 0) then
return AddPlayerChat(player, "You must be in a vehicle")
end
if (GetPlayerVehicleSeat(player) ~= 1) then
return AddPlayerChat(player, "You must be the driver of the vehicle")
end
--Change color every 200ms of the players vehicle
CreateCountTimer(function(vehicle)
if not IsValidVehicle(vehicle) then
return
end
local r = Random(100, 255)
local g = Random(100, 255)
local b = Random(100, 255)
SetVehicleColor(vehicle, RGB(r, g, b))
end, 200, 16, vehicle)
end
AddCommand("vcolorfun", cmd_vcolorfun)