getEasingValue | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

getEasingValue

Client-side
Server-side
Shared

This page is incomplete! Help wanted!

Please finish this page using the corresponding Old Wiki article.
Go to Contribution guidelines for more information.

Used for custom Lua based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and an easing function. In most cases, either moveObject or interpolateBetween can do the job. getEasingValue is only provided in case you want to do your own custom interpolation based on easing.

Syntax

 getEasingValue ( )

Code Examples

server

This clientside example uses getEasingValue to make a custom camera fade. The command to test it is "/fade". The fading out is done with "InQuad" to have a slow fading which then accelerates and "OutQuad" is used for fading in to have a smooth end of the fading. In this exampleinterpolateBetweencould have been used directly to interpolate the alpha between 0 and 255 and then 255 and 0 but is example is just to illustrate the use of getEasingValue by itself.

local g_Fade = nil
addCommandHandler("fade",
function ()
  if g_Fade then return end
  g_Fade = {}
  g_Fade.startTime = getTickCount()
  g_Fade.endTime = g_Fade.startTime + 2000
  g_Fade.easingFunction = "InQuad" --Slow at first and accelerating
  addEventHandler("onClientRender", getRootElement(), fadeCameraOut)
end)


function fadeCameraOut()
  local now = getTickCount()
  local elapsedTime = now - g_Fade.startTime
  local duration = g_Fade.endTime - g_Fade.startTime
  local progress = elapsedTime / duration


  local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)


  local alpha = fAnimationTime*255
  local width, height = guiGetScreenSize()
  dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)


  if now > g_Fade.endTime then
    removeEventHandler("onClientRender", getRootElement(), fadeCameraOut)
    g_Fade.startTime = getTickCount()
    g_Fade.endTime = g_Fade.startTime + 2000
    g_Fade.easingFunction = "OutQuad" --Fast at first then decelerating
    addEventHandler("onClientRender", getRootElement(), fadeCameraIn)
  end
end


function fadeCameraIn()
  local now = getTickCount()
  local elapsedTime = now - g_Fade.startTime
  local duration = g_Fade.endTime - g_Fade.startTime
  local progress = elapsedTime / duration


  local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)


  local alpha = (1-fAnimationTime)*255
  local width, height = guiGetScreenSize()
  dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)


  if now > g_Fade.endTime then
    removeEventHandler("onClientRender", getRootElement(), fadeCameraIn)
    g_Fade = nil
  end
end

See Also

Utility Functions
Reference