VoidExpanse/scope-script: Difference between revisions

From AtomicTorchWiki
No edit summary
No edit summary
 
Line 36: Line 36:
{{Scripting_api|GetSecondsMultiplier|
{{Scripting_api|GetSecondsMultiplier|
void|
void|
void |
Double|
<pre style="margin:0px;">var time = script.GetSecondsMultiplier();</pre> |
<pre style="margin:0px;">var time = script.GetSecondsMultiplier();</pre> |
Returns time since this function was called last time. Works properly only if function
Returns time since this function was called last time. Works properly only if function
was restricted with RestrictFunctionByTime/RestrictFunctionFPS
was restricted with RestrictFunctionByTime/RestrictFunctionFPS
}}
}}

Latest revision as of 04:05, 13 February 2014


Scope script

Used to get access to a specific script-related functions.

Visibility: Global.

List of functions

RestrictFunctionByTime
Arguments Returns Example
  • string: name
  • float: seconds

void

script.RestrictFunctionByTime("some_function", 10);
Description

It can be useful, when you want to subscribe to every-frame event, like OnEnterFrame, but you don't want your function to be called every frame. In this case one of possible solutions would be to use function pair : RestrictFunctionByTime/RestrictFunctionFPS. In such functions, in case you need an interval since it was last called, you'd call script.GetSecondsMultiplier instead of standard game.GetSecondsMultipler.


RestrictFunctionFPS
Arguments Returns Example
  • string: name
  • int: fps

void

script.RestrictFunctionFPS("some_function", 10);
Description

It can be useful, when you want to subscribe to every-frame event, like OnEnterFrame, but you don't want your function to be called every frame. In this case one of possible solutions would be to use function pair : RestrictFunctionByTime/RestrictFunctionFPS. In such functions, in case you need an interval since it was last called, you'd call script.GetSecondsMultiplier instead of standard game.GetSecondsMultipler.


GetSecondsMultiplier
Arguments Returns Example

void

Double

var time = script.GetSecondsMultiplier();
Description

Returns time since this function was called last time. Works properly only if function was restricted with RestrictFunctionByTime/RestrictFunctionFPS