PT-BR/SetTimer - Revision history

LordHenry: LordHenry moved page SetTimer/PT-BR to PT-BR/SetTimer: Default from other languages

2020-08-06T20:29:24Z

LordHenry moved page SetTimer/PT-BR to PT-BR/SetTimer: Default from other languages

← Older revision

Revision as of 20:29, 6 August 2020

LordHenry at 20:27, 6 August 2020

2020-08-06T20:27:21Z

← Older revision		Revision as of 20:27, 6 August 2020
Line 11:		Line 11:
	==Sintaxe==		==Sintaxe==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	timer setTimer ( function ~~Funcao~~, int ~~intervaloDeTempo~~, int ~~vezesDeExecucao~~ [, var ~~Argumentos~~... ] )		timer setTimer ( function theFunction, int timeInterval, int timesToExecute [, var arguments... ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{BR/OOP\|\|[[Timer]]}}		{{BR/OOP\|\|[[Timer]]}}
	===Argumentos Necessários===		===Argumentos Necessários===
	*'''~~Funcao~~:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.		*'''theFunction:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.
	{{BR/Nota\|A variável global escondida ('''sourceTimer''') da função que foi executada pelo timer contém a atual userdata deste timer que está em execução.}}		{{BR/Nota\|A variável global escondida ('''sourceTimer''') da função que foi executada pelo timer contém a atual userdata deste timer que está em execução.}}
	*'''~~intervaloDeTempo~~:''' Número de milissegundos que deve decorrer antes da função especificada ser exeuctada. [o mínimo é 50 (0 a partir da versão 1.5.6 r16715); 1000 milissegundos = 1 segundo]		*'''timeInterval:''' Número de milissegundos que deve decorrer antes da função especificada ser exeuctada. [o mínimo é 50 (0 a partir da versão 1.5.6 r16715); 1000 milissegundos = 1 segundo]
	*'''~~vezesDeExecucao~~:''' O número de vezes que o timer deve executar. '''0''' significa que o timer vai ser repetido infinitas vezes.		*'''timerToExecute:''' O número de vezes que o timer deve executar. '''0''' significa que o timer vai ser repetido infinitas vezes.

	===Argumentos Opcionais===		===Argumentos Opcionais===
	{{BR/ArgOpcional}}		{{BR/ArgOpcional}}
	*'''~~Argumentos~~:''' Qualquer argumento que você deseja passar para a função podem ser ~~detectados~~ depois do argumento ''~~vezesDeExecucao~~''. Note que qualquer tabela que você deseja passar será clonada, enquanto que referências de metatabelas e funções passadas na tabela serão perdidas. As alterações feitas na tabela original antes que a função seja chamada não serão transferidas.		*'''arguments:''' Qualquer argumento que você deseja passar para a função podem ser listados depois do argumento ''timesToExecute''. Note que qualquer tabela que você deseja passar será clonada, enquanto que referências de metatabelas e funções passadas na tabela serão perdidas. As alterações feitas na tabela original antes que a função seja chamada não serão transferidas.

	===Retorna===		===Retorna===
	Retorna um [[timer]] se for criado com sucesso, ''false'' se os argumentos são inválidos ou o timer não pôde ser definido.		Retorna um [[timer]] se for criado com sucesso, ''false'' se os argumentos são inválidos ou se o timer não pôde ser definido.

	==Exemplos==		==Exemplos==
Line 86:		Line 86:
	==Veja também==		==Veja também==
	{{Utility functions}}		{{Utility functions}}
			[[en:setTimer]]

Lettify at 04:36, 26 June 2020

2020-06-26T04:36:45Z

← Older revision		Revision as of 04:36, 26 June 2020
Line 13:		Line 13:
	timer setTimer ( function Funcao, int intervaloDeTempo, int vezesDeExecucao [, var Argumentos... ] )		timer setTimer ( function Funcao, int intervaloDeTempo, int vezesDeExecucao [, var Argumentos... ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|[[Timer]]}}		{{BR/OOP\|\|[[Timer]]}}
	===Argumentos Necessários===		===Argumentos Necessários===
	*'''Funcao:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.		*'''Funcao:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.

Lettify: Atualização da original

2020-06-14T02:17:48Z

Atualização da original

← Older revision		Revision as of 02:17, 14 June 2020
Line 28:		Line 28:

	==Exemplos==		==Exemplos==
			<section name="Exemplo 1" class="both" show="true">
	Este exemplo vai exibir no chat algum texto depois de um pequeno delay.		Este exemplo vai exibir no chat algum texto depois de um pequeno delay.

Line 41:		Line 42:

	1 segundo depois que a linha acima for executada, o texto ''Texto atrasado: Olá Brasil!'' vai ser exibido no chat.		1 segundo depois que a linha acima for executada, o texto ''Texto atrasado: Olá Brasil!'' vai ser exibido no chat.
			</section>

			<section name="Exemplo 2" class="both" show="true">
	Este exemplo aninha uma função inteira dentro de um timer. Isso é bom para coisas como definir variáveis sem precisar chamar uma função fora do seu bloco de código.		Este exemplo aninha uma função inteira dentro de um timer. Isso é bom para coisas como definir variáveis sem precisar chamar uma função fora do seu bloco de código.

Line 54:		Line 57:
	funcaoPrincipal() -- execute a função		funcaoPrincipal() -- execute a função
	</syntaxhighlight>		</syntaxhighlight>
	<br>		</section>
	<section name="~~Yet another example~~" class="server" show="~~false~~">
			<section name="Exemplo 3" class="server" show="true">
	Este exemplo deve enviar no chat global algo sobre a morte de um jogador em um tempo aleatório. Eu usei [https://wiki.multitheftauto.com/wiki/Math.round math.round] neste exemplo para se tornar mais útil.		Este exemplo deve enviar no chat global algo sobre a morte de um jogador em um tempo aleatório. Eu usei [https://wiki.multitheftauto.com/wiki/Math.round math.round] neste exemplo para se tornar mais útil.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Lettify: Corrigido equívocos cometidos :D

2020-05-24T21:37:34Z

Corrigido equívocos cometidos :D

← Older revision		Revision as of 21:37, 24 May 2020
Line 8:		Line 8:
	O invervalo mínimo aceito é '''0ms'''.		O invervalo mínimo aceito é '''0ms'''.

	O MTA garante que o timer será acionado após pelo menos o intervalo especificado. O funcionamento do timer está vinculado à taxa de quadros (lado do servidor e lado do cliente). Todos os timers finalizados são acionados em um único ponto em cada quadro(frame). Isto significa que se, por exemplo, o jogador está rodando a 30 fps, então dois timers criados para acionar suas funções em 100ms e 110ms provavelmente ocorrerão durante o mesmo frame, pois a diferença de tempo entre os dois temporizadores (10 ms) é menor que a metade do comprimento do quadro (33 ms). Como na maioria dos timers fornecidos por ~~outros idiomas~~, você não deve confiar no disparo do cronômetro em um ponto exato no futuro.		O MTA garante que o timer será acionado após pelo menos o intervalo especificado. O funcionamento do timer está vinculado à taxa de quadros (lado do servidor e lado do cliente). Todos os timers finalizados são acionados em um único ponto em cada quadro(frame). Isto significa que se, por exemplo, o jogador está rodando a 30 fps, então dois timers criados para acionar suas funções em 100ms e 110ms provavelmente ocorrerão durante o mesmo frame, pois a diferença de tempo entre os dois temporizadores (10 ms) é menor que a metade do comprimento do quadro (33 ms). Como na maioria dos timers fornecidos por outras linguagens de programação, você não deve confiar no disparo do cronômetro em um ponto exato no futuro.
	==Sintaxe==		==Sintaxe==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Danilo: /* Argumentos Necessários */

2020-05-24T21:37:25Z

Argumentos Necessários

← Older revision		Revision as of 21:37, 24 May 2020
Line 17:		Line 17:
	*'''Funcao:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.		*'''Funcao:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.
	{{BR/Nota\|A variável global escondida ('''sourceTimer''') da função que foi executada pelo timer contém a atual userdata deste timer que está em execução.}}		{{BR/Nota\|A variável global escondida ('''sourceTimer''') da função que foi executada pelo timer contém a atual userdata deste timer que está em execução.}}
	*'''intervaloDeTempo:''' Número de milissegundos que deve decorrer antes da função especificada ser exeuctada. [o mínimo é 50 (0 on 1.5.6 r16715); 1000 milissegundos = 1 segundo]		*'''intervaloDeTempo:''' Número de milissegundos que deve decorrer antes da função especificada ser exeuctada. [o mínimo é 50 (0 a partir da versão 1.5.6 r16715); 1000 milissegundos = 1 segundo]
	*'''vezesDeExecucao:''' O número de vezes que o timer deve executar. '''0''' significa que o timer vai ser repetido infinitas vezes.		*'''vezesDeExecucao:''' O número de vezes que o timer deve executar. '''0''' significa que o timer vai ser repetido infinitas vezes.

Lettify at 21:34, 24 May 2020

2020-05-24T21:34:44Z

← Older revision		Revision as of 21:34, 24 May 2020
Line 2:		Line 2:
	{{BR/Funcao compartilhada}}{{BR/Nota Importante\|A velocidade na qual um timer em client-side é executado pode não ser totalmente confiável se este client estiver modificando maliciosamente a velocidade do sistema operacional, os timers poderão ser executados muito mais rápido ou mais devagar.}}		{{BR/Funcao compartilhada}}{{BR/Nota Importante\|A velocidade na qual um timer em client-side é executado pode não ser totalmente confiável se este client estiver modificando maliciosamente a velocidade do sistema operacional, os timers poderão ser executados muito mais rápido ou mais devagar.}}
	{{BR/Nota Importante\|Usando o código abaixo pode haver problemas na performance. Ao invés disso, use [[onClientPreRender]]. <syntaxhighlight lang="lua">setTimer(Funcao, 0, 0)</syntaxhighlight>}}		{{BR/Nota Importante\|Usando o código abaixo pode haver problemas na performance. Ao invés disso, use [[onClientPreRender]]. <syntaxhighlight lang="lua">setTimer(Funcao, 0, 0)</syntaxhighlight>}}
	Esta função permite você acionar uma função depois de um número de milissegundos estiver decorrido. Você pode executar funções que tenham um nome sendo uma variável ou uma função ~~interna~~ (~~como chamam: função anônima~~). Por exemplo, você pode definir um timer para ''spawnar'' um jogador depois de alguns segundos.		Esta função permite você acionar uma função depois de um número de milissegundos estiver decorrido. Você pode executar funções que tenham um nome sendo uma variável, uma função anônima, ou uma função do MTA (tipo [[setElementModel]]). Por exemplo, você pode definir um timer para ''spawnar'' um jogador depois de alguns segundos.

	A partir que o timer termina suas execuções, ele deixa de existir.		A partir que o timer termina suas execuções, ele deixa de existir.

Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}}{{BR/Nota Importante|A velocidade na qual um timer em client-side é executado pode não ser totalmente confiável se este client estiver..."

2020-05-24T21:23:05Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}}{{BR/Nota Importante|A velocidade na qual um timer em client-side é executado pode não ser totalmente confiável se este client estiver..."

New page

__NOTOC__
{{BR/Funcao compartilhada}}{{BR/Nota Importante|A velocidade na qual um timer em client-side é executado pode não ser totalmente confiável se este client estiver modificando maliciosamente a velocidade do sistema operacional, os timers poderão ser executados muito mais rápido ou mais devagar.}}
{{BR/Nota Importante|Usando o código abaixo pode haver problemas na performance. Ao invés disso, use [[onClientPreRender]]. <syntaxhighlight lang="lua">setTimer(Funcao, 0, 0)</syntaxhighlight>}}
Esta função permite você acionar uma função depois de um número de milissegundos estiver decorrido. Você pode executar funções que tenham um nome sendo uma variável ou uma função interna (como chamam: função anônima). Por exemplo, você pode definir um timer para ''spawnar'' um jogador depois de alguns segundos.

A partir que o timer termina suas execuções, ele deixa de existir.

O invervalo mínimo aceito é '''0ms'''.

O MTA garante que o timer será acionado após pelo menos o intervalo especificado. O funcionamento do timer está vinculado à taxa de quadros (lado do servidor e lado do cliente). Todos os timers finalizados são acionados em um único ponto em cada quadro(frame). Isto significa que se, por exemplo, o jogador está rodando a 30 fps, então dois timers criados para acionar suas funções em 100ms e 110ms provavelmente ocorrerão durante o mesmo frame, pois a diferença de tempo entre os dois temporizadores (10 ms) é menor que a metade do comprimento do quadro (33 ms). Como na maioria dos timers fornecidos por outros idiomas, você não deve confiar no disparo do cronômetro em um ponto exato no futuro.
==Sintaxe==
<syntaxhighlight lang="lua">
timer setTimer ( function Funcao, int intervaloDeTempo, int vezesDeExecucao [, var Argumentos... ] )
</syntaxhighlight>
{{OOP||[[Timer]]}}
===Argumentos Necessários===
*'''Funcao:''' A função que o timer vai executar quando estiver decorrido o invervalo definido.
{{BR/Nota|A variável global escondida ('''sourceTimer''') da função que foi executada pelo timer contém a atual userdata deste timer que está em execução.}}
*'''intervaloDeTempo:''' Número de milissegundos que deve decorrer antes da função especificada ser exeuctada. [o mínimo é 50 (0 on 1.5.6 r16715); 1000 milissegundos = 1 segundo]
*'''vezesDeExecucao:''' O número de vezes que o timer deve executar. '''0''' significa que o timer vai ser repetido infinitas vezes.

===Argumentos Opcionais===
{{BR/ArgOpcional}}
*'''Argumentos:''' Qualquer argumento que você deseja passar para a função podem ser detectados depois do argumento ''vezesDeExecucao''. Note que qualquer tabela que você deseja passar será clonada, enquanto que referências de metatabelas e funções passadas na tabela serão perdidas. As alterações feitas na tabela original antes que a função seja chamada não serão transferidas.

===Retorna===
Retorna um [[timer]] se for criado com sucesso, ''false'' se os argumentos são inválidos ou o timer não pôde ser definido.

==Exemplos==
Este exemplo vai exibir no chat algum texto depois de um pequeno delay.

<syntaxhighlight lang="lua">
-- defina a função que vai ser executada
function chatAtrasado ( text )
outputChatBox ( "Texto atrasado: " .. text )
end

-- Defina um timer e então a função será executada depois de 1 segundo
setTimer ( chatAtrasado, 1000, 1, "Olá Brasil!" )
</syntaxhighlight>

1 segundo depois que a linha acima for executada, o texto ''Texto atrasado: Olá Brasil!'' vai ser exibido no chat.

Este exemplo aninha uma função inteira dentro de um timer. Isso é bom para coisas como definir variáveis sem precisar chamar uma função fora do seu bloco de código.

<syntaxhighlight lang="lua">
function funcaoPrincipal()
outputChatBox ("Texto agora!")
setTimer ( function()
outputChatBox ( "Texto depois de 5 segundos depois do último!" )
end, 5000, 1 )
end

funcaoPrincipal() -- execute a função
</syntaxhighlight>
<br>
<section name="Yet another example" class="server" show="false">
Este exemplo deve enviar no chat global algo sobre a morte de um jogador em um tempo aleatório. Eu usei [https://wiki.multitheftauto.com/wiki/Math.round math.round] neste exemplo para se tornar mais útil.
<syntaxhighlight lang="lua">
function math.round(number, decimals, method) -- math.round, função útil obtida de wiki: https://wiki.multitheftauto.com/wiki/Math.round
decimals = decimals or 0
local factor = 10 ^ decimals
if (method == "ceil" or method == "floor") then return math[method](number * factor) / factor
else return tonumber(("%."..decimals.."f"):format(number)) end
end

function quandoMorto()
local delay = math.random(500, 5000) -- 0.5s até 5s de delay
setTimer(function(thePlayer) -- Inicia o timer
local whoDied = "Someone" -- Caso o nome não seja obtido, Someone será usado
if isElement(thePlayer) then -- Isto checa se o elemento thePlayer ainda existe (que significa que o thePlayer não desconectou ainda)
whoDied = getPlayerName(thePlayer) -- Aqui obtemos o nome do jogador
end
outputChatBox(whoDied.." #FF0000morreu #FFFFFF"..math.round(delay/1000, 1).." segundos atrás.", root, 255, 175, 0, true) -- Isto vai exibir para todos no servidor que aquele thePlayer (ou alguém) morreu X segundos atrás.
end
delay, 1, source) -- O source no final é um argumento para a função que fizemos antes, você não pode usar source diretamente pois ele não estaria definido mais
end
addEventHandler("onPlayerWasted", root, quandoMorto) -- Executado a cada vez que alguém morre
</syntaxhighlight>
</section>

==Veja também==
{{Utility functions}}