src/scripting/functions.hpp

   1 //  $Id$
   2 //
   3 //  SuperTux
   4 //  Copyright (C) 2006 Matthias Braun <matze@braunis.de>
   5 //
   6 //  This program is free software; you can redistribute it and/or
   7 //  modify it under the terms of the GNU General Public License
   8 //  as published by the Free Software Foundation; either version 2
   9 //  of the License, or (at your option) any later version.
  10 //
  11 //  This program is distributed in the hope that it will be useful,
  12 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 //  GNU General Public License for more details.
  15 //
  16 //  You should have received a copy of the GNU General Public License
  17 //  along with this program; if not, write to the Free Software
  18 //  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  19
  20 #ifndef __FUNCTIONS_H__
  21 #define __FUNCTIONS_H__
  22
  23 #ifndef SCRIPTING_API
  24 #define __suspend
  25 #define __custom
  26 #include <string>
  27 #include "player_status.hpp"
  28 #endif
  29
  30 namespace Scripting
  31 {
  32
  33 /**
  34  * Display the value of the argument. This is usefull for inspecting tables.
  35  */
  36 SQInteger display(HSQUIRRELVM vm) __custom;
  37
  38 /**
  39  * Displays contents of the current stack
  40  */
  41 void print_stacktrace(HSQUIRRELVM vm);
  42
  43 /**
  44  * returns the currently running thread
  45  */
  46 SQInteger get_current_thread(HSQUIRRELVM vm) __custom;
  47
  48 /**
  49  * Display a text file and scrolls it over the screen (on next screenswitch)
  50  */
  51 void display_text_file(const std::string& filename);
  52
  53 /**
  54  * Load and display a worldmap (on next screenswitch)
  55  */
  56 void load_worldmap(const std::string& filename);
  57
  58 /**
  59  * Load and display a level (on next screenswitch)
  60  */
  61 void load_level(const std::string& filename);
  62
  63 /**
  64  * Suspend the script execution for the specified number of seconds
  65  */
  66 void wait(HSQUIRRELVM vm, float seconds) __suspend;
  67
  68 /**
  69  * Suspend the script execution until the current screen has been changed
  70  */
  71 void wait_for_screenswitch(HSQUIRRELVM vm) __suspend;
  72
  73 /**
  74  * Exits the currently running screen (force exit from worldmap or scrolling
  75  * text for example)
  76  */
  77 void exit_screen();
  78
  79 /**
  80  * Does a fadeout for the specified number of seconds before next screenchange
  81  */
  82 void fadeout_screen(float seconds);
  83
  84 /**
  85  * Does a shrinking fade towards the destposition for the specified number of
  86  * seconds before next screenchange
  87  */
  88 void shrink_screen(float dest_x, float dest_y, float seconds);
  89
  90 /**
  91  * Translate a text into the users language (by looking it up in the .po
  92  * files)
  93  */
  94 std::string translate(const std::string& text);
  95
  96 /**
  97  * Load a script file and executes it. This is typically used to import
  98  * functions from external files.
  99  */
 100 void import(HSQUIRRELVM v, const std::string& filename);
 101
 102 /**
 103  * Save world state to savegame
 104  */
 105 void save_state();
 106
 107 /**
 108  * enable/disable drawing of collision rectangles
 109  */
 110 void debug_collrects(bool enable);
 111
 112 /**
 113  * enable/disable drawing of fps
 114  */
 115 void debug_show_fps(bool enable);
 116
 117 /**
 118  * enable/disable drawing of non-solid layers
 119  */
 120 void debug_draw_solids_only(bool enable);
 121
 122 /**
 123  * Changes music to musicfile
 124  */
 125 void play_music(const std::string& musicfile);
 126
 127 /**
 128  * Plays a soundfile
 129  */
 130 void play_sound(const std::string& soundfile);
 131
 132 /**
 133  * speeds Tux up
 134  */
 135 void grease();
 136
 137 /**
 138  * makes Tux invincible for 10000 units of time
 139  */
 140 void invincible();
 141
 142 /**
 143  * makes Tux a ghost, i.e. lets him float around and through solid objects
 144  */
 145 void ghost();
 146
 147 /**
 148  * recall Tux's invincibility and ghost status
 149  */
 150 void mortal();
 151
 152 /**
 153  * reinitialise and respawn Tux at the beginning of the current level
 154  */
 155 void restart();
 156
 157 /**
 158  * print Tux's current coordinates in a level
 159  */
 160 void whereami();
 161
 162 /**
 163  * move Tux near the end of the level
 164  */
 165 void gotoend();
 166
 167 /**
 168  * show the camera's coordinates
 169  */
 170 void camera();
 171
 172 /**
 173  * exit the game
 174  */
 175 void quit();
 176
 177 /**
 178  * Returns a random integer
 179  */
 180 int rand();
 181
 182 }
 183
 184 #endif