Lettify: Translation to Portuguese (Brazil)

2021-08-05T21:01:22Z

Translation to Portuguese (Brazil)

New page

{{Template:PT-BR/Função Útil}}
__NOTOC__
Esta função permite você usar o [[interpolateBetween]] sem um evento de renderização, facilitando assim o trabalho em seu resource.
==Sintaxe==
<syntaxhighlight lang="lua">int animate(int/float from, int/float to, string/int easing, int duration, function onChange [ , function onEnd ])</syntaxhighlight>

===Argumentos necessários===

* '''from''': o valor inicial.
* '''to''': o valor final.
* '''easing''': a [[PT-BR/Easing|função de atenuação]] para usar para a animação, também é possível usar os números para a atenuação, ex.: "Linear" = 1, "InQuad" = 2, "OutQuad" = 3, ...
* '''duration''': a duração da animação.
* '''onChange''': a função que é executada quando o valor da animação é alterado.

===Argumentos opcionais===
* '''onEnd''': a função que é executada quando a animação finaliza.

===Retorno===
Retorna um [[PT-BR/Int|int]] que é o ID da animação criada, ou '''false''' se argumentos inválidos foram especificados.

==Código-fonte==
<section name="Code" class="client" show="true">
<syntaxhighlight lang="lua">
local anims, builtins = {}, {"Linear", "InQuad", "OutQuad", "InOutQuad", "OutInQuad", "InElastic", "OutElastic", "InOutElastic", "OutInElastic", "InBack", "OutBack", "InOutBack", "OutInBack", "InBounce", "OutBounce", "InOutBounce", "OutInBounce", "SineCurve", "CosineCurve"}

function table.find(t, v)
for k, a in ipairs(t) do
if a == v then
return k
end
end
return false
end

function animate(f, t, easing, duration, onChange, onEnd)
assert(type(f) == "number", "Bad argument @ 'animate' [expected number at argument 1, got "..type(f).."]")
assert(type(t) == "number", "Bad argument @ 'animate' [expected number at argument 2, got "..type(t).."]")
assert(type(easing) == "string" or (type(easing) == "number" and (easing >= 1 or easing <= #builtins)), "Bad argument @ 'animate' [Invalid easing at argument 3]")
assert(type(duration) == "number", "Bad argument @ 'animate' [expected number at argument 4, got "..type(duration).."]")
assert(type(onChange) == "function", "Bad argument @ 'animate' [expected function at argument 5, got "..type(onChange).."]")
table.insert(anims, {from = f, to = t, easing = table.find(builtins, easing) and easing or builtins[easing], duration = duration, start = getTickCount( ), onChange = onChange, onEnd = onEnd})
return #anims
end

function destroyAnimation(a)
if anims[a] then
table.remove(anims, a)
end
end

addEventHandler("onClientRender", root, function( )
local now = getTickCount( )
for k,v in ipairs(anims) do
v.onChange(interpolateBetween(v.from, 0, 0, v.to, 0, 0, (now - v.start) / v.duration, v.easing))
if now >= v.start+v.duration then
if type(v.onEnd) == "function" then
v.onEnd( )
end
table.remove(anims, k)
end
end
end)
</syntaxhighlight>
</section>

==Exemplo==
<section name="Example" class="client" show="true">
This example open/close with slide up/down effect.
Este exemplo abre/fecha a janela GUI com um efeito de slide subindo/descendo.
<syntaxhighlight lang="lua">
--Animação de Slide
local sx, sy = guiGetScreenSize( )
local window = guiCreateWindow((sx-300)/2, (sy-400)/2, 300, 400, "Test", false)
guiSetVisible(window, false)
bindKey("f2", "down", function( )
if anim then return end
local v = guiGetVisible(window)
if not v then
guiSetVisible(window, true)
animate(0, 1, 1, 1000, function(alpha)
guiSetAlpha(window,alpha)
end)
end
anim = true
animate(v and 400 or 0, v and 0 or 400, 2, 1250, function(height)
if v and height == 0 then
guiSetVisible(window, false)
anim = false
elseif not v and height == 400 then
anim = false
end
local w, h = guiGetSize(window, false)
guiSetSize(window, w, height, false)
end)
end)
</syntaxhighlight>
</section>
Author : Mr.Tn6eL

==See Also==
{{Useful_Functions}}
[[Category:Useful Functions]]
[[pl:Animate]]

PT-BR/Animate - Revision history

Lettify: Translation to Portuguese (Brazil)