VoidExpanse/scope-script: Difference between revisions

From AtomicTorchWiki
No edit summary
Line 1: Line 1:
<noinclude>
[[Category:VoidExpanse/api_scopes]]
</noinclude>
= Config script =
= Config script =
Used to get access to a specific script-related functions.
Used to get access to a specific script-related functions.
Line 10: Line 14:
* float: seconds|
* float: seconds|
void |
void |
<nowiki>script.RestrictFunctionByTime("some_function", 10);</nowiki> |
<pre style="margin:0px;">script.RestrictFunctionByTime("some_function", 10);</pre> |
It can be useful, when you want to subscribe to every-frame event, like OnEnterFrame,
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
but you don't want your function to be called every frame. In this case one of possible
Line 22: Line 26:
* int: fps|
* int: fps|
void |
void |
<nowiki>script.RestrictFunctionFPS("some_function", 10);</nowiki> |
<pre style="margin:0px;">script.RestrictFunctionFPS("some_function", 10);</pre> |
It can be useful, when you want to subscribe to every-frame event, like OnEnterFrame,
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
but you don't want your function to be called every frame. In this case one of possible
Line 33: Line 37:
|
|
void |
void |
<nowiki>var time = script.GetSecondsMultiplier();</nowiki> |
<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
}}
}}

Revision as of 03:47, 13 February 2014


Config 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

var time = script.GetSecondsMultiplier();
Description

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