https://wiki.multitheftauto.com/api.php?action=feedcontributions&feedformat=atom&user=Kayl+712
Multi Theft Auto: Wiki - User contributions [en]
2026-04-24T02:14:01Z
User contributions
MediaWiki 1.39.3
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24780
Easing
2010-12-18T21:57:45Z
<p>Kayl 712: </p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration, or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.0<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th align="center">Easing function</th><br />
<th align="center">Function profile</th><br />
<th align="center">Uses fEasingPeriod</th><br />
<th align="center">Uses fEasingAmplitude</th><br />
<th align="center">Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td align="center">Linear</td><br />
<td align="center">[[File:Qeasingcurve-linear.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InQuad</td><br />
<td align="center">[[File:Qeasingcurve-inquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutQuad</td><br />
<td align="center">[[File:Qeasingcurve-outquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InOutQuad</td><br />
<td align="center">[[File:Qeasingcurve-inoutquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutInQuad</td><br />
<td align="center">[[File:Qeasingcurve-outinquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InElastic</td><br />
<td align="center">[[File:Qeasingcurve-inelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td align="center">OutElastic</td><br />
<td align="center">[[File:Qeasingcurve-outelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InOutElastic</td><br />
<td align="center">[[File:Qeasingcurve-inoutelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">OutInElastic</td><br />
<td align="center">[[File:Qeasingcurve-outinelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InBack</td><br />
<td align="center">[[File:Qeasingcurve-inback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td align="center">OutBack</td><br />
<td align="center">[[File:Qeasingcurve-outback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InOutBack</td><br />
<td align="center">[[File:Qeasingcurve-inoutback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">OutInBack</td><br />
<td align="center">[[File:Qeasingcurve-outinback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InBounce</td><br />
<td align="center">[[File:Qeasingcurve-inbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutBounce</td><br />
<td align="center">[[File:Qeasingcurve-outbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InOutBounce</td><br />
<td align="center">[[File:Qeasingcurve-inoutbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutInBounce</td><br />
<td align="center">[[File:Qeasingcurve-outinbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">SineCurve</td><br />
<td align="center">[[File:Qeasingcurve-sincurve.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td align="center">CosineCurve</td><br />
<td align="center">[[File:Qeasingcurve-coscurve.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] have been extracted from [http://doc.qt.nokia.com/latest/qeasingcurve.html Qt documentation]. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile of the acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24779
Easing
2010-12-18T21:46:29Z
<p>Kayl 712: /* Easing functions */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.0<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th align="center">Easing function</th><br />
<th align="center">Function profile</th><br />
<th align="center">Uses fEasingPeriod</th><br />
<th align="center">Uses fEasingAmplitude</th><br />
<th align="center">Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td align="center">Linear</td><br />
<td align="center">[[File:Qeasingcurve-linear.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InQuad</td><br />
<td align="center">[[File:Qeasingcurve-inquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutQuad</td><br />
<td align="center">[[File:Qeasingcurve-outquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InOutQuad</td><br />
<td align="center">[[File:Qeasingcurve-inoutquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutInQuad</td><br />
<td align="center">[[File:Qeasingcurve-outinquad.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InElastic</td><br />
<td align="center">[[File:Qeasingcurve-inelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td align="center">OutElastic</td><br />
<td align="center">[[File:Qeasingcurve-outelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InOutElastic</td><br />
<td align="center">[[File:Qeasingcurve-inoutelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">OutInElastic</td><br />
<td align="center">[[File:Qeasingcurve-outinelastic.png]]</td><br />
<td align="center">yes</td><td align="center">yes</td><td align="center"></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InBack</td><br />
<td align="center">[[File:Qeasingcurve-inback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td align="center">OutBack</td><br />
<td align="center">[[File:Qeasingcurve-outback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td align="center">InOutBack</td><br />
<td align="center">[[File:Qeasingcurve-inoutback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td align="center">OutInBack</td><br />
<td align="center">[[File:Qeasingcurve-outinback.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center">yes</td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InBounce</td><br />
<td align="center">[[File:Qeasingcurve-inbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutBounce</td><br />
<td align="center">[[File:Qeasingcurve-outbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">InOutBounce</td><br />
<td align="center">[[File:Qeasingcurve-inoutbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">OutInBounce</td><br />
<td align="center">[[File:Qeasingcurve-outinbounce.png]]</td><br />
<td align="center"></td><td align="center">yes</td><td align="center"></td><td></td><br />
</tr><br />
<tr><br />
<td align="center">SineCurve</td><br />
<td align="center">[[File:Qeasingcurve-sincurve.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td align="center">CosineCurve</td><br />
<td align="center">[[File:Qeasingcurve-coscurve.png]]</td><br />
<td align="center"></td><td align="center"></td><td align="center"></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] have been extracted from [http://doc.qt.nokia.com/latest/qeasingcurve.html Qt documentation]. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-coscurve.png&diff=24778
File:Qeasingcurve-coscurve.png
2010-12-18T21:40:20Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-sincurve.png&diff=24777
File:Qeasingcurve-sincurve.png
2010-12-18T21:40:04Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outinbounce.png&diff=24776
File:Qeasingcurve-outinbounce.png
2010-12-18T21:39:41Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inoutbounce.png&diff=24775
File:Qeasingcurve-inoutbounce.png
2010-12-18T21:39:22Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outbounce.png&diff=24774
File:Qeasingcurve-outbounce.png
2010-12-18T21:39:04Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inbounce.png&diff=24773
File:Qeasingcurve-inbounce.png
2010-12-18T21:38:46Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outinback.png&diff=24772
File:Qeasingcurve-outinback.png
2010-12-18T21:38:07Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inoutback.png&diff=24771
File:Qeasingcurve-inoutback.png
2010-12-18T21:37:49Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outback.png&diff=24770
File:Qeasingcurve-outback.png
2010-12-18T21:37:24Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inback.png&diff=24769
File:Qeasingcurve-inback.png
2010-12-18T21:37:04Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outinelastic.png&diff=24768
File:Qeasingcurve-outinelastic.png
2010-12-18T21:36:43Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inoutelastic.png&diff=24767
File:Qeasingcurve-inoutelastic.png
2010-12-18T21:36:19Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outelastic.png&diff=24766
File:Qeasingcurve-outelastic.png
2010-12-18T21:35:43Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inelastic.png&diff=24765
File:Qeasingcurve-inelastic.png
2010-12-18T21:35:12Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outinquad.png&diff=24764
File:Qeasingcurve-outinquad.png
2010-12-18T21:34:37Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inoutquad.png&diff=24763
File:Qeasingcurve-inoutquad.png
2010-12-18T21:34:13Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-outquad.png&diff=24762
File:Qeasingcurve-outquad.png
2010-12-18T21:32:49Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-inquad.png&diff=24761
File:Qeasingcurve-inquad.png
2010-12-18T21:32:07Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=File:Qeasingcurve-linear.png&diff=24760
File:Qeasingcurve-linear.png
2010-12-18T21:30:44Z
<p>Kayl 712: </p>
<hr />
<div></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=MoveObject&diff=24757
MoveObject
2010-12-17T12:34:19Z
<p>Kayl 712: </p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function will smoothly move an object from its current position to a specified rotation and position.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool moveObject ( object theObject, int time, float targetx, float targety, float targetz, [ float moverx, float movery, float moverz, string strEasingType, float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''theObject:''' The object that will be moved.<br />
* '''time:''' The time in milliseconds the object will arrive at the destination.<br />
* '''targetx:''' The X value of the target position<br />
* '''targety:''' The Y value of the target position<br />
* '''targetz:''' The Z value of the target position<br />
<br />
===Optional Arguments===<br />
* '''moverx:''' The rotation along the X axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''movery:''' The rotation along the Y axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''moverz:''' The rotation along the Z axis '''relative''' to its current rotation, which is its starting angle.<br />
{{New feature|33.0110|1.1|<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation (default is "Linear")<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
}}<br />
<br />
===Returns===<br />
Returns ''true'' if the function moved the object succesfully, and returns ''false'' otherwise.<br />
<br />
==Examples ==<br />
<section name="Server" class="server" show="true"><br />
'''Example 1:''' This example moves every object in the game up 100 units in ten seconds.<br />
<syntaxhighlight lang="lua"><br />
allObjects = getElementsByType ( "object" )<br />
for key, theObject in ipairs ( allObjects ) do<br />
local origX, origY, origZ = getElementPosition ( theObject ) --get the origanal position<br />
local newZ = origZ + 100 -- make a new z position<br />
moveObject ( theObject, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds.<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
'''Example 2:''' This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds.<br />
<syntaxhighlight lang="lua"><br />
-- Find a player called 'someguy'<br />
someGuy = getPlayerFromNick ( "someguy" )<br />
-- If a player called someguy was found then<br />
if ( someGuy ) then<br />
-- Get the player's position<br />
x, y, z = getElementPosition ( someGuy )<br />
-- Create a bed (1700) object near to the player<br />
bed = createObject ( 1700, x + 5, y, z )<br />
-- Move the bed towards the player over 3 seconds (3000 milliseconds)<br />
moveObject ( bed, 3000, x, y, z )<br />
-- Tell the player in the chat box<br />
outputChatBox ( "Moving a bed towards you!", someGuy )<br />
else<br />
-- Tell everyone that a player called 'someguy' could not be found<br />
outputChatBox ( "Player someguy doesn't exist" )<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
'''Example 3:''' This example creates a ball moving (in front of CJ's house in Grove Street) using easing functions. Test command is "/smove" for instance "/smove OutBounce". This example is a serverside code but the same could be done clientside (adapting the command handler)<br />
<syntaxhighlight lang="lua"><br />
local START_POS = {2497.203125, -1672.4864501953, 12.640947341919}<br />
local STOP_POS = {2480.2595214844, -1666.521484375, 12.640114784241}<br />
local MOTION_DURATION = 5000<br />
local WAIT_DURATION = 1000<br />
<br />
addCommandHandler("smove",<br />
function (player, cmd, strEasingType, period, amplitude, overshoot)<br />
local x, y, z = unpack(START_POS)<br />
local object = createObject(1598, x, y, z)<br />
x, y, z = unpack(STOP_POS)<br />
<br />
period = period or 0.3<br />
amplitude = amplitude or 1.0<br />
overshoot = overshoot or 1.70158<br />
<br />
outputChatBox(string.format("Server Easing %s %s %s %s", strEasingType, tostring(period), tostring(amplitude), tostring(overshoot)))<br />
moveObject(object, MOTION_DURATION, x, y, z, 0, 0, 360, strEasingType, period, amplitude, overshoot)<br />
setTimer(destroyElement, MOTION_DURATION+WAIT_DURATION, 1, object)<br />
end)<br />
</section><br />
<br />
==See Also==<br />
{{Object functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24756
Easing
2010-12-17T12:28:23Z
<p>Kayl 712: /* Easing functions */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.0<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] have been extracted from [http://doc.qt.nokia.com/latest/qeasingcurve.html Qt documentation]. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24752
Easing
2010-12-17T11:42:27Z
<p>Kayl 712: /* Source */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] have been extracted from [http://doc.qt.nokia.com/latest/qeasingcurve.html Qt documentation]. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24751
Easing
2010-12-17T11:41:49Z
<p>Kayl 712: /* Source */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] have been extracted from [http://doc.qt.nokia.com/latest/qeasingcurve.html|Qt documentation]. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24750
Easing
2010-12-17T11:40:25Z
<p>Kayl 712: </p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* ''"Linear"'' can be used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* ''"OutElastic"'' can define ''fEasingPeriod'' and ''fEasingAmplitude'' so it can be used with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* ''"InBack"'' can define ''fEasingOvershoot'', but since it comes after ''fEasingPeriod'' and ''fEasingAmplitude'' in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values are (when a function can use a parameter but it's not defined by the user):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24749
Easing
2010-12-17T11:31:31Z
<p>Kayl 712: /* Easing functions */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values (when a function can use a parameter but it's not defined are):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td>yes</td><td>yes</td><td></td><td>Due to elastic effect, this easing function produces some values < 0 and > 1</td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values < 0</td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values > 1</td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td>Due to overshoot, this easing function produces some values <0 and > 1</td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td>yes</td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td>yes</td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function doesn't end at 1 but goes back to 0. In this case, for interpolation, the target value is just an edge but doesn't represent the stop value.</td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td>This easing function both starts and stops at 0.5, going first to 1 then 0. In this case, for interpolation, the source and target values are just the edges but don't represent the start/stop values.</td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24748
Easing
2010-12-17T11:14:37Z
<p>Kayl 712: /* Easing functions */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values (when a function can use a parameter but it's not defined are):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<br />
</table><br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24747
Easing
2010-12-17T11:14:15Z
<p>Kayl 712: </p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
= Preliminary note =<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
= Easing functions =<br />
<br />
Default values (when a function can use a parameter but it's not defined are):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function (strEasingType)</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInElastic</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBack</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InOutBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>OutInBounce</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>SineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>CosineCurve</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<br />
</table><br />
<br />
<br />
= Source =<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
The pictures of the easing functions are directly extracted from Qt documentation, © 2008-2010 Nokia Corporation and/or its subsidiaries.</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24746
Easing
2010-12-17T10:56:15Z
<p>Kayl 712: /* Easing functions */</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
<br />
== Preliminary note ==<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
== Easing functions ==<br />
<br />
Default values (when a function can use a parameter but it's not defined are):<br />
* ''fEasingPeriod:'' 0.3<br />
* ''fEasingAmplitude :'' 1.<br />
* ''fEasingOvershoot:'' 1.701<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function (strEasingType)</th><br />
<th>Function profile</th><br />
<th>Uses fEasingPeriod</th><br />
<th>Uses fEasingAmplitude</th><br />
<th>Uses fEasingOvershoot</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
</table></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24745
Easing
2010-12-17T10:54:58Z
<p>Kayl 712: </p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
<br />
== Preliminary note ==<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
== Easing functions ==<br />
<br />
<table border="1" class="unnamed1"><br />
<tr><br />
<th>Easing function (strEasingType)</th><br />
<th>Function profile</th><br />
<th>Can use fEasingPeriod (default 0.3)</th><br />
<th>Can use fEasingAmplitude (default 1.0)</th><br />
<th>Can use fEasingOvershoot(default 1.7015)</th><br />
<th>Comments</th><br />
</tr><br />
<br />
<tr><br />
<td>Linear</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
<tr><br />
<td>InQuad</td><br />
<td></td><br />
<td></td><td></td><td></td><td></td><br />
</tr><br />
</table></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=Easing&diff=24744
Easing
2010-12-17T10:48:57Z
<p>Kayl 712: Created page with "Easing functions describe functions that control the way an interpolation between 0 and 1 is done. The most basic one, linear, is just a linear interpolation at constant speed. ..."</p>
<hr />
<div>Easing functions describe functions that control the way an interpolation between 0 and 1 is done.<br />
<br />
The most basic one, linear, is just a linear interpolation at constant speed. Other more advanced easing functions can have acceleration at the beginning, the end or both, or deceleration , or even bouncing or elastic effects.<br />
<br />
The naming conventions of the functions below, available in [[moveObject]], [[interpolateBetween]], or [[getEasingValue]] as been extracted from http://doc.qt.nokia.com/latest/qeasingcurve.html. Only a subset of those functions is available in MTA since some of them are a bit redundant (only the profile or acceleration/deceleration changes).<br />
<br />
In the functions using easing, there are usually 3 optional parameters. Most functions don't need them at all, the ones needing one or more parameters are listed in the table below. When providing optional parameters, all the parameters before a given parameter must be filled, even if the easing function you intend to use doesn't require such a parameter. In this case, simply use 0 for the parameters you don't need.<br />
Examples:<br />
* "Linear" can used simply with ''getEasingValue( fProgress, "Linear" )''<br />
* "OutElastic" can define fEasingPeriod and fEasingAmplitude with ''getEasingValue( fProgress, "OutElastic", 0.3, 1.0 )''<br />
* "InBack" can define fEasingOvershoot, but since it comes after fEasingPeriod and fEasingAmplitude in the order of parameters, 0 must be used for the others with ''getEasingValue( fProgress, "InBack", 0, 0, 1.7015 )''<br />
<br />
== Easing functions ==<br />
<br />
(table to come)</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=MoveObject&diff=24743
MoveObject
2010-12-17T10:22:05Z
<p>Kayl 712: /* Optional Arguments */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function will smoothly move an object from its current position to a specified rotation and position.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool moveObject ( object theObject, int time, float targetx, float targety, float targetz, [ float moverx, float movery, float moverz, string strEasingType, float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''theObject:''' The object that will be moved.<br />
* '''time:''' The time in milliseconds the object will arrive at the destination.<br />
* '''targetx:''' The X value of the target position<br />
* '''targety:''' The Y value of the target position<br />
* '''targetz:''' The Z value of the target position<br />
<br />
===Optional Arguments===<br />
* '''moverx:''' The rotation along the X axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''movery:''' The rotation along the Y axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''moverz:''' The rotation along the Z axis '''relative''' to its current rotation, which is its starting angle.<br />
{{New feature|33.0110|1.1|<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation (default is "Linear")<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
}}<br />
<br />
===Returns===<br />
Returns ''true'' if the function moved the object succesfully, and returns ''false'' otherwise.<br />
<br />
==Example==<br />
<section name="Server" class="server" show="true"><br />
'''Example 1:''' This example moves every object in the game up 100 units in ten seconds.<br />
<syntaxhighlight lang="lua"><br />
allObjects = getElementsByType ( "object" )<br />
for key, theObject in ipairs ( allObjects ) do<br />
local origX, origY, origZ = getElementPosition ( theObject ) --get the origanal position<br />
local newZ = origZ + 100 -- make a new z position<br />
moveObject ( theObject, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds.<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
'''Example 2:''' This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds.<br />
<syntaxhighlight lang="lua"><br />
-- Find a player called 'someguy'<br />
someGuy = getPlayerFromNick ( "someguy" )<br />
-- If a player called someguy was found then<br />
if ( someGuy ) then<br />
-- Get the player's position<br />
x, y, z = getElementPosition ( someGuy )<br />
-- Create a bed (1700) object near to the player<br />
bed = createObject ( 1700, x + 5, y, z )<br />
-- Move the bed towards the player over 3 seconds (3000 milliseconds)<br />
moveObject ( bed, 3000, x, y, z )<br />
-- Tell the player in the chat box<br />
outputChatBox ( "Moving a bed towards you!", someGuy )<br />
else<br />
-- Tell everyone that a player called 'someguy' could not be found<br />
outputChatBox ( "Player someguy doesn't exist" )<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Object functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=MoveObject&diff=24742
MoveObject
2010-12-17T10:21:41Z
<p>Kayl 712: /* Syntax */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function will smoothly move an object from its current position to a specified rotation and position.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool moveObject ( object theObject, int time, float targetx, float targety, float targetz, [ float moverx, float movery, float moverz, string strEasingType, float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''theObject:''' The object that will be moved.<br />
* '''time:''' The time in milliseconds the object will arrive at the destination.<br />
* '''targetx:''' The X value of the target position<br />
* '''targety:''' The Y value of the target position<br />
* '''targetz:''' The Z value of the target position<br />
<br />
===Optional Arguments===<br />
* '''moverx:''' The rotation along the X axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''movery:''' The rotation along the Y axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''moverz:''' The rotation along the Z axis '''relative''' to its current rotation, which is its starting angle.<br />
{{New feature|33.0110|1.1|<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
}}<br />
<br />
===Returns===<br />
Returns ''true'' if the function moved the object succesfully, and returns ''false'' otherwise.<br />
<br />
==Example==<br />
<section name="Server" class="server" show="true"><br />
'''Example 1:''' This example moves every object in the game up 100 units in ten seconds.<br />
<syntaxhighlight lang="lua"><br />
allObjects = getElementsByType ( "object" )<br />
for key, theObject in ipairs ( allObjects ) do<br />
local origX, origY, origZ = getElementPosition ( theObject ) --get the origanal position<br />
local newZ = origZ + 100 -- make a new z position<br />
moveObject ( theObject, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds.<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
'''Example 2:''' This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds.<br />
<syntaxhighlight lang="lua"><br />
-- Find a player called 'someguy'<br />
someGuy = getPlayerFromNick ( "someguy" )<br />
-- If a player called someguy was found then<br />
if ( someGuy ) then<br />
-- Get the player's position<br />
x, y, z = getElementPosition ( someGuy )<br />
-- Create a bed (1700) object near to the player<br />
bed = createObject ( 1700, x + 5, y, z )<br />
-- Move the bed towards the player over 3 seconds (3000 milliseconds)<br />
moveObject ( bed, 3000, x, y, z )<br />
-- Tell the player in the chat box<br />
outputChatBox ( "Moving a bed towards you!", someGuy )<br />
else<br />
-- Tell everyone that a player called 'someguy' could not be found<br />
outputChatBox ( "Player someguy doesn't exist" )<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Object functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=MoveObject&diff=24741
MoveObject
2010-12-17T10:21:17Z
<p>Kayl 712: </p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function will smoothly move an object from its current position to a specified rotation and position.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool moveObject ( object theObject, int time, float targetx, float targety, float targetz, [ float moverx, float movery, float moverz, string strEasingType, float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''theObject:''' The object that will be moved.<br />
* '''time:''' The time in milliseconds the object will arrive at the destination.<br />
* '''targetx:''' The X value of the target position<br />
* '''targety:''' The Y value of the target position<br />
* '''targetz:''' The Z value of the target position<br />
<br />
===Optional Arguments===<br />
* '''moverx:''' The rotation along the X axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''movery:''' The rotation along the Y axis '''relative''' to its current rotation, which is its starting angle.<br />
* '''moverz:''' The rotation along the Z axis '''relative''' to its current rotation, which is its starting angle.<br />
{{New feature|33.0110|1.1|<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
}}<br />
<br />
===Returns===<br />
Returns ''true'' if the function moved the object succesfully, and returns ''false'' otherwise.<br />
<br />
==Example==<br />
<section name="Server" class="server" show="true"><br />
'''Example 1:''' This example moves every object in the game up 100 units in ten seconds.<br />
<syntaxhighlight lang="lua"><br />
allObjects = getElementsByType ( "object" )<br />
for key, theObject in ipairs ( allObjects ) do<br />
local origX, origY, origZ = getElementPosition ( theObject ) --get the origanal position<br />
local newZ = origZ + 100 -- make a new z position<br />
moveObject ( theObject, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds.<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
'''Example 2:''' This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds.<br />
<syntaxhighlight lang="lua"><br />
-- Find a player called 'someguy'<br />
someGuy = getPlayerFromNick ( "someguy" )<br />
-- If a player called someguy was found then<br />
if ( someGuy ) then<br />
-- Get the player's position<br />
x, y, z = getElementPosition ( someGuy )<br />
-- Create a bed (1700) object near to the player<br />
bed = createObject ( 1700, x + 5, y, z )<br />
-- Move the bed towards the player over 3 seconds (3000 milliseconds)<br />
moveObject ( bed, 3000, x, y, z )<br />
-- Tell the player in the chat box<br />
outputChatBox ( "Moving a bed towards you!", someGuy )<br />
else<br />
-- Tell everyone that a player called 'someguy' could not be found<br />
outputChatBox ( "Player someguy doesn't exist" )<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Object functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=GetEasingValue&diff=24740
GetEasingValue
2010-12-17T10:18:38Z
<p>Kayl 712: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Used for custom LUA based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and an [[Easing|easing function]].<br />
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.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">fAnimationTime = getEasingValue( fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''fAnimationTime '' the animation time given by the easing function (can be < 0 or > 1 since some [[Easing|easing functions]] have overshoot or bounce/spring effects, ''false'' otherwise (error in parameters).<br />
<br />
== Example ==<br />
The example below is only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clientside example uses getEasingValue to make a custom camera fade.<br />
The command to test it is "/fade".<br />
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.<br />
In this example [[interpolateBetween]] could 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.<br />
<syntaxhighlight lang="lua"><br />
local g_Fade = nil<br />
addCommandHandler("fade", <br />
function ()<br />
if g_Fade then return end<br />
g_Fade = {}<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "InQuad" --Slow at first and accelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
end)<br />
<br />
function fadeCameraOut()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = fAnimationTime*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "OutQuad" --Fast at first then decelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
end<br />
end<br />
<br />
function fadeCameraIn()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = (1-fAnimationTime)*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
g_Fade = nil<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24739
InterpolateBetween
2010-12-17T10:17:17Z
<p>Kayl 712: /* Examples */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
The examples below are only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clientside example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clientside example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=GetEasingValue&diff=24738
GetEasingValue
2010-12-17T10:17:04Z
<p>Kayl 712: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Used for custom LUA based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and an [[Easing|easing function]].<br />
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.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">fAnimationTime = getEasingValue( fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''fAnimationTime '' the animation time given by the easing function (can be < 0 or > 1 since some [[Easing|easing functions]] have overshoot or bounce/spring effects, ''false'' otherwise (error in parameters).<br />
<br />
== Example ==<br />
The example below is only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clientside example uses getEasingValue to make a custom camera fade.<br />
The command to test it is "/fade".<br />
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.<br />
In this example [[interpolateBetween]] could have been used directly to interpolate the alpha between 0 and 255 and then 255 and 0 but is example is just to illustrate of the use of getEasingValue by itself.<br />
<syntaxhighlight lang="lua"><br />
local g_Fade = nil<br />
addCommandHandler("fade", <br />
function ()<br />
if g_Fade then return end<br />
g_Fade = {}<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "InQuad" --Slow at first and accelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
end)<br />
<br />
function fadeCameraOut()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = fAnimationTime*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "OutQuad" --Fast at first then decelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
end<br />
end<br />
<br />
function fadeCameraIn()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = (1-fAnimationTime)*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
g_Fade = nil<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=GetEasingValue&diff=24737
GetEasingValue
2010-12-17T10:15:13Z
<p>Kayl 712: Created page with "__NOTOC__ {{Server client function}} Used for custom LUA based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and ..."</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Used for custom LUA based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and an [[Easing|easing function]].<br />
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.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">fAnimationTime = getEasingValue( fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''fAnimationTime '' the animation time given by the easing function (can be < 0 or > 1 since some [[Easing|easing functions]] have overshoot or bounce/spring effects, ''false'' otherwise (error in parameters).<br />
<br />
== Example ==<br />
The example below isonly clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses getEasingValue to make a custom camera fade.<br />
The command to test it is "/fade".<br />
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.<br />
In this example [[interpolateBetween]] could have been used directly to interpolate the alpha between 0 and 255 and then 255 and 0 but is example is just to illustrate of the use of getEasingValue by itself.<br />
<syntaxhighlight lang="lua"><br />
local g_Fade = nil<br />
addCommandHandler("fade", <br />
function ()<br />
if g_Fade then return end<br />
g_Fade = {}<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "InQuad" --Slow at first and accelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
end)<br />
<br />
function fadeCameraOut()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = fAnimationTime*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraOut)<br />
g_Fade.startTime = getTickCount()<br />
g_Fade.endTime = g_Fade.startTime + 2000<br />
g_Fade.easingFunction = "OutQuad" --Fast at first then decelerating<br />
addEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
end<br />
end<br />
<br />
function fadeCameraIn()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Fade.startTime<br />
local duration = g_Fade.endTime - g_Fade.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)<br />
<br />
local alpha = (1-fAnimationTime)*255<br />
local width, height = guiGetScreenSize()<br />
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)<br />
<br />
if now > g_Fade.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), fadeCameraIn)<br />
g_Fade = nil<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24736
InterpolateBetween
2010-12-17T09:59:36Z
<p>Kayl 712: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
The examples below are only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24735
InterpolateBetween
2010-12-17T09:52:26Z
<p>Kayl 712: /* Examples */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
The examples below are only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}<br />
[[Category:Incomplete]]</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24734
InterpolateBetween
2010-12-17T09:52:14Z
<p>Kayl 712: /* Examples */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
The examples above are only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}<br />
[[Category:Incomplete]]</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24733
InterpolateBetween
2010-12-17T09:50:48Z
<p>Kayl 712: /* Returns */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}<br />
[[Category:Incomplete]]</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24732
InterpolateBetween
2010-12-17T09:50:35Z
<p>Kayl 712: /* Required Arguments */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector/value<br />
*'''x2, y2, z2:''' 3D coordinates of target vector/value<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}<br />
[[Category:Incomplete]]</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24731
InterpolateBetween
2010-12-17T09:50:13Z
<p>Kayl 712: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].<br />
It can also be used to interpolate 2D vectors or scalars my only setting some of the x, y, z values and putting 0 to the others.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''x1, y1, z1:''' 3D coordinates of source vector<br />
*'''x2, y2, z2:''' 3D coordinates of target vector<br />
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).<br />
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation<br />
<br />
===Optional Arguments===<br />
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)<br />
<br />
===Returns===<br />
Returns ''x, y, z'' the interpolated 3D vector if successful, ''false'' otherwise (error in parameters).<br />
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).<br />
<br />
== Examples ==<br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}<br />
[[Category:Incomplete]]</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24727
InterpolateBetween
2010-12-16T13:31:01Z
<p>Kayl 712: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
== Examples ==<br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create position and color interpolation(with effect) on a marker.<br />
The command to test it is "/marker".<br />
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.<br />
<syntaxhighlight lang="lua"><br />
local g_Marker = nil<br />
addCommandHandler("marker",<br />
function ()<br />
if g_Marker then return end<br />
<br />
local x, y, z = getElementPosition(getLocalPlayer())<br />
z = z - 1<br />
<br />
g_Marker = {}<br />
g_Marker.startPos = {x, y, z + 5}<br />
g_Marker.startTime = getTickCount()<br />
g_Marker.startColor = {255, 0, 0, 0}<br />
g_Marker.endPos = {x, y, z}<br />
g_Marker.endTime = g_Marker.startTime + 2000<br />
g_Marker.endColor = {0, 0, 255, 255} <br />
<br />
local x, y, z = unpack(g_Marker.startPos)<br />
local r, g, b, a = unpack(g_Marker.startColor)<br />
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)<br />
<br />
addEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
end)<br />
<br />
function popMarkerUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Marker.startTime<br />
local duration = g_Marker.endTime - g_Marker.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local x1, y1, z1 = unpack(g_Marker.startPos)<br />
local x2, y2, z2 = unpack(g_Marker.endPos)<br />
local x, y, z = interpolateBetween ( <br />
x1, y1, z1,<br />
x2, y2, z2, <br />
progress, "OutBounce")<br />
<br />
setElementPosition(g_Marker.marker, x, y, z)<br />
<br />
local r1, g1, b1, a1 = unpack(g_Marker.startColor)<br />
local r2, g2, b2, a2 = unpack(g_Marker.endColor)<br />
local r, g, b = interpolateBetween ( <br />
r1, g1, b1,<br />
r2, g2, b2, <br />
progress, "Linear")<br />
local a = interpolateBetween ( <br />
a1, 0, 0,<br />
a2, 0, 0,<br />
progress, "Linear")<br />
<br />
setMarkerColor(g_Marker.marker , r, g, b, a)<br />
<br />
if now >= g_Marker.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)<br />
setTimer(<br />
function ()<br />
destroyElement(g_Marker.marker)<br />
g_Marker = nil<br />
end, 3000, 1)<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24726
InterpolateBetween
2010-12-16T13:27:10Z
<p>Kayl 712: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
== Example on a GUI Window ==<br />
<br />
<section name="Client" class="client" show="true"><br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Utility functions}}</div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24725
InterpolateBetween
2010-12-16T13:25:26Z
<p>Kayl 712: /* Example on a GUI Window */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
== Example on a GUI Window ==<br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
The command to test it is "/window".<br />
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24724
InterpolateBetween
2010-12-16T13:24:33Z
<p>Kayl 712: /* Syntax */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween ( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
== Example on a GUI Window ==<br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
Command to test it is "/window"<br />
When window pops up it uses "OutElastic" as the strEasingType to create the bouncing effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight></div>
Kayl 712
https://wiki.multitheftauto.com/index.php?title=InterpolateBetween&diff=24723
InterpolateBetween
2010-12-16T13:23:09Z
<p>Kayl 712: /* Syntax */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">x, y, z = interpolateBetween( x1, y1, z1, x2, y2, z2, fProgress, strEasingType [, fEasingPeriod, fEasingAmplitude, fEasingOvershoot] )</syntaxhighlight><br />
<br />
== Example on a GUI Window ==<br />
This clienstide example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.<br />
Command to test it is "/window"<br />
When window pops up it uses "OutElastic" as the strEasingType to create the bouncing effect.<br />
When it fades away, it uses "InQuad" to have an accelerating fading.<br />
<syntaxhighlight lang="lua"><br />
local g_Window = nil<br />
addCommandHandler("window",<br />
function ()<br />
if g_Window then return end<br />
<br />
g_Window = {}<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
g_Window.windowWidth, g_Window.windowHeight = 400, 315<br />
local left = screenWidth/2 - g_Window.windowWidth/2<br />
local top = screenHeight/2 - g_Window.windowHeight/2<br />
<br />
g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)<br />
<br />
g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)<br />
<br />
guiWindowSetSizable(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiSetVisible(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {0, 0}<br />
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
addEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
end)<br />
<br />
function on_closeBtn_clicked(button, state, absoluteX, absoluteY)<br />
if (button ~= "left") or (state ~= "up") then<br />
return<br />
end<br />
<br />
if not g_Window then return end<br />
<br />
showCursor(false)<br />
guiSetEnabled(g_Window.window, false)<br />
guiWindowSetMovable(g_Window.window, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
local posX, posY = guiGetPosition(g_Window.window, false)<br />
<br />
g_Window.startTime = getTickCount()<br />
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}<br />
g_Window.startCenter = <br />
{<br />
posX + g_Window.windowWidth/2,<br />
posY + g_Window.windowHeight/2,<br />
}<br />
<br />
g_Window.endSize = {0, 0}<br />
g_Window.endTime = g_Window.startTime + 1000<br />
g_Window.endCenter = <br />
{<br />
screenWidth, <br />
screenHeight<br />
}<br />
<br />
addEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
end<br />
<br />
function popWindowUp()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "OutElastic")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local screenWidth, screenHeight = guiGetScreenSize()<br />
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)<br />
<br />
if not guiGetVisible(g_Window.window) then<br />
guiSetVisible(g_Window.window, true)<br />
guiBringToFront(g_Window.window)<br />
end<br />
<br />
if now >= g_Window.endTime then<br />
guiSetEnabled(g_Window.window, true)<br />
<br />
guiBringToFront(g_Window.window)<br />
removeEventHandler("onClientRender", getRootElement(), popWindowUp)<br />
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)<br />
showCursor(true)<br />
guiWindowSetMovable(g_Window.window, true)<br />
end<br />
end<br />
<br />
function popWindowDown()<br />
local now = getTickCount()<br />
local elapsedTime = now - g_Window.startTime<br />
local duration = g_Window.endTime - g_Window.startTime<br />
local progress = elapsedTime / duration<br />
<br />
local width, height, _ = interpolateBetween ( <br />
g_Window.startSize[1], g_Window.startSize[2], 0, <br />
g_Window.endSize[1], g_Window.endSize[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetSize(g_Window.window, width, height, false)<br />
<br />
local centerX, centerY, _ = interpolateBetween ( <br />
g_Window.startCenter[1], g_Window.startCenter[2], 0, <br />
g_Window.endCenter[1], g_Window.endCenter[2], 0, <br />
progress, "InQuad")<br />
<br />
guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)<br />
<br />
if now >= g_Window.endTime then<br />
removeEventHandler("onClientRender", getRootElement(), popWindowDown)<br />
destroyElement(g_Window.window)<br />
g_Window = nil<br />
end<br />
end<br />
<br />
</syntaxhighlight></div>
Kayl 712