ObjectType:script

From Lavish Software Wiki
Jump to navigation Jump to search

Overview

Object Type Vitals
script
Defined By LavishScript
Inherits none
Reduces To TRUE
Variable Object Type none
Uses Sub-Types no
C/C++ Type void *

A script object provides access to a running LavishScript script.

Members

  • string Filename: Filename of this script
  • variable Variable[name]: A given script-scope variable
  • int RunningTime: Number of milliseconds since this script began
  • filepath CurrentDirectory: Current working directory for this script
  • bool Paused: Scripts current paused state
  • bool Profiling: Profiling status true/false. Debugging must be allowed for profiling to be on.
  • bool AllowDebug: If debugging is allowed
  • string ExecuteAtom[name,...]: Executes an atom in script-scope with the given name. Any extra parameters are passed as parameters to the atom. If the atom returns a value, the value is given.
  • variablescope VariableScope: The script's variable scope

Methods

  • End: Ends execution of this script
  • QueueCommand[command]: Inserts a command in the script's command queue
  • Squelch: Squelches most output from this script (excluding most errors and generally excluding Echo)
  • Unsquelch: Unsquelches
  • Pause: Pauses this script
  • Resume: Resumes this script
  • ExecuteAtom[name,...]: Executes an atom in script-scope with the given name. Any extra parameters are passed as parameters to the atom.
  • EnableProfiling: Enables script profiling. Debugging must be turned on to enable.
  • DisableProfiling: Disables script profiling.
  • DisableDebugging: Disables debugging.
  • DumpStack: Dumps the current stack into the console.
  • DumpProfiling: Dumps the entire script into the console.
  • EnableDebugLogging[filename]: Enables full debug logging to file.
Note: Do not use this with DumpProfiling, as the output will be mostly 0s.
  • DisableDebugLogging: Disables full debug logging

Examples

Display if a script is running

  • echo ${Script[VentriloHUD](exists)}
Output
TRUE

End a script

  • Script[VentriloHUD]:End
  • Script:End
Note: When used as a command within a script will end the script

Set a variable inside a currently running script

  • Script[KillCount].VariableScope.TotalKills:Set[0] - Will set the variable called TotalKills in the currently running script called KillCount to zero.

See Also

LavishScript Object Types

Retrieved from "https://www.lavishsoft.com/wiki/index.php?title=ObjectType:script&oldid=8492"