group__console__callbacks.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=11"/>
  6. <meta name="generator" content="Doxygen 1.9.8"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>Torque2D Reference: Scripting Engine Callbacks</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="search/searchdata.js"></script>
  14. <script type="text/javascript" src="search/search.js"></script>
  15. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  16. <link href="t2d-stylesheet-extra.css" rel="stylesheet" type="text/css"/>
  17. </head>
  18. <body>
  19. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  20. <div id="titlearea">
  21. <table cellspacing="0" cellpadding="0">
  22. <tbody>
  23. <tr id="projectrow">
  24. <td id="projectalign">
  25. <div id="projectname">Torque2D Reference
  26. </div>
  27. </td>
  28. </tr>
  29. </tbody>
  30. </table>
  31. </div>
  32. <!-- end header part -->
  33. <!-- Generated by Doxygen 1.9.8 -->
  34. <script type="text/javascript">
  35. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  36. var searchBox = new SearchBox("searchBox", "search/",'.html');
  37. /* @license-end */
  38. </script>
  39. <script type="text/javascript" src="menudata.js"></script>
  40. <script type="text/javascript" src="menu.js"></script>
  41. <script type="text/javascript">
  42. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  43. $(function() {
  44. initMenu('',true,false,'search.php','Search');
  45. $(document).ready(function() { init_search(); });
  46. });
  47. /* @license-end */
  48. </script>
  49. <div id="main-nav"></div>
  50. </div><!-- top -->
  51. <!-- window showing the filter options -->
  52. <div id="MSearchSelectWindow"
  53. onmouseover="return searchBox.OnSearchSelectShow()"
  54. onmouseout="return searchBox.OnSearchSelectHide()"
  55. onkeydown="return searchBox.OnSearchSelectKey(event)">
  56. </div>
  57. <!-- iframe showing the search results (closed by default) -->
  58. <div id="MSearchResultsWindow">
  59. <div id="MSearchResults">
  60. <div class="SRPage">
  61. <div id="SRIndex">
  62. <div id="SRResults"></div>
  63. <div class="SRStatus" id="Loading">Loading...</div>
  64. <div class="SRStatus" id="Searching">Searching...</div>
  65. <div class="SRStatus" id="NoMatches">No Matches</div>
  66. </div>
  67. </div>
  68. </div>
  69. </div>
  70. <div class="header">
  71. <div class="summary">
  72. <a href="#typedef-members">Typedefs</a> </div>
  73. <div class="headertitle"><div class="title">Scripting Engine Callbacks<div class="ingroups"><a class="el" href="group__ts_scripting.html">TorqueScript Bindings</a></div></div></div>
  74. </div><!--header-->
  75. <div class="contents">
  76. <table class="memberdecls">
  77. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="typedef-members" name="typedef-members"></a>
  78. Typedefs</h2></td></tr>
  79. <tr class="memitem:ga3b1618755db8dcc0264d9adbd7944801" id="r_ga3b1618755db8dcc0264d9adbd7944801"><td class="memItemLeft" align="right" valign="top">typedef const char *(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#ga3b1618755db8dcc0264d9adbd7944801">StringCallback</a>) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td></tr>
  80. <tr class="separator:ga3b1618755db8dcc0264d9adbd7944801"><td class="memSeparator" colspan="2">&#160;</td></tr>
  81. <tr class="memitem:ga82b43b62df148a3ef01de7f8e8035d58" id="r_ga82b43b62df148a3ef01de7f8e8035d58"><td class="memItemLeft" align="right" valign="top">typedef S32(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#ga82b43b62df148a3ef01de7f8e8035d58">IntCallback</a>) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td></tr>
  82. <tr class="separator:ga82b43b62df148a3ef01de7f8e8035d58"><td class="memSeparator" colspan="2">&#160;</td></tr>
  83. <tr class="memitem:gacea87d3b8941b7ffcea991099d630d3a" id="r_gacea87d3b8941b7ffcea991099d630d3a"><td class="memItemLeft" align="right" valign="top">typedef F32(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#gacea87d3b8941b7ffcea991099d630d3a">FloatCallback</a>) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td></tr>
  84. <tr class="separator:gacea87d3b8941b7ffcea991099d630d3a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  85. <tr class="memitem:gae7bde538b4003b19dca7a9279b5f79b6" id="r_gae7bde538b4003b19dca7a9279b5f79b6"><td class="memItemLeft" align="right" valign="top">typedef void(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#gae7bde538b4003b19dca7a9279b5f79b6">VoidCallback</a>) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td></tr>
  86. <tr class="separator:gae7bde538b4003b19dca7a9279b5f79b6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  87. <tr class="memitem:ga3daa15ec563ddf01edfcf67f9515cf89" id="r_ga3daa15ec563ddf01edfcf67f9515cf89"><td class="memItemLeft" align="right" valign="top">typedef bool(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#ga3daa15ec563ddf01edfcf67f9515cf89">BoolCallback</a>) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td></tr>
  88. <tr class="separator:ga3daa15ec563ddf01edfcf67f9515cf89"><td class="memSeparator" colspan="2">&#160;</td></tr>
  89. <tr class="memitem:ga73457ddc96b5e0366926bfd1f6c762ce" id="r_ga73457ddc96b5e0366926bfd1f6c762ce"><td class="memItemLeft" align="right" valign="top">typedef void(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__console__callbacks.html#ga73457ddc96b5e0366926bfd1f6c762ce">ConsumerCallback</a>) (<a class="el" href="struct_console_log_entry.html#a221b779e6bb7b8d40677d7642bfefac5">ConsoleLogEntry::Level</a> level, const char *consoleLine)</td></tr>
  90. <tr class="separator:ga73457ddc96b5e0366926bfd1f6c762ce"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. </table>
  92. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  93. <p>The scripting engine makes heavy use of callbacks to represent function exposed to the scripting language. StringCallback, IntCallback, FloatCallback, VoidCallback, and BoolCallback all represent exposed script functions returning different types.</p>
  94. <p>ConsumerCallback is used with the function <a class="el" href="namespace_con.html#a648038e7c75ddf17ab4ca01ffa347d27">Con::addConsumer</a>; functions registered with <a class="el" href="namespace_con.html#a648038e7c75ddf17ab4ca01ffa347d27">Con::addConsumer</a> are called whenever something is outputted to the console. For instance, the <a class="el" href="class_telnet_console.html">TelnetConsole</a> registers itself with the console so it can echo the console over the network.</p>
  95. <dl class="section note"><dt>Note</dt><dd>Callbacks to the scripting language - for instance, onExit(), which is a script function called when the engine is shutting down - are handled using <a class="el" href="namespace_con.html#a443c03c63fe60016f5bbfb99e1ccbee5">Con::executef()</a> and kin. </dd></dl>
  96. <h2 class="groupheader">Typedef Documentation</h2>
  97. <a id="ga3daa15ec563ddf01edfcf67f9515cf89" name="ga3daa15ec563ddf01edfcf67f9515cf89"></a>
  98. <h2 class="memtitle"><span class="permalink"><a href="#ga3daa15ec563ddf01edfcf67f9515cf89">&#9670;&#160;</a></span>BoolCallback</h2>
  99. <div class="memitem">
  100. <div class="memproto">
  101. <table class="memname">
  102. <tr>
  103. <td class="memname">typedef bool(* BoolCallback) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td>
  104. </tr>
  105. </table>
  106. </div><div class="memdoc">
  107. </div>
  108. </div>
  109. <a id="ga73457ddc96b5e0366926bfd1f6c762ce" name="ga73457ddc96b5e0366926bfd1f6c762ce"></a>
  110. <h2 class="memtitle"><span class="permalink"><a href="#ga73457ddc96b5e0366926bfd1f6c762ce">&#9670;&#160;</a></span>ConsumerCallback</h2>
  111. <div class="memitem">
  112. <div class="memproto">
  113. <table class="memname">
  114. <tr>
  115. <td class="memname">typedef void(* ConsumerCallback) (<a class="el" href="struct_console_log_entry.html#a221b779e6bb7b8d40677d7642bfefac5">ConsoleLogEntry::Level</a> level, const char *consoleLine)</td>
  116. </tr>
  117. </table>
  118. </div><div class="memdoc">
  119. </div>
  120. </div>
  121. <a id="gacea87d3b8941b7ffcea991099d630d3a" name="gacea87d3b8941b7ffcea991099d630d3a"></a>
  122. <h2 class="memtitle"><span class="permalink"><a href="#gacea87d3b8941b7ffcea991099d630d3a">&#9670;&#160;</a></span>FloatCallback</h2>
  123. <div class="memitem">
  124. <div class="memproto">
  125. <table class="memname">
  126. <tr>
  127. <td class="memname">typedef F32(* FloatCallback) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td>
  128. </tr>
  129. </table>
  130. </div><div class="memdoc">
  131. </div>
  132. </div>
  133. <a id="ga82b43b62df148a3ef01de7f8e8035d58" name="ga82b43b62df148a3ef01de7f8e8035d58"></a>
  134. <h2 class="memtitle"><span class="permalink"><a href="#ga82b43b62df148a3ef01de7f8e8035d58">&#9670;&#160;</a></span>IntCallback</h2>
  135. <div class="memitem">
  136. <div class="memproto">
  137. <table class="memname">
  138. <tr>
  139. <td class="memname">typedef S32(* IntCallback) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td>
  140. </tr>
  141. </table>
  142. </div><div class="memdoc">
  143. </div>
  144. </div>
  145. <a id="ga3b1618755db8dcc0264d9adbd7944801" name="ga3b1618755db8dcc0264d9adbd7944801"></a>
  146. <h2 class="memtitle"><span class="permalink"><a href="#ga3b1618755db8dcc0264d9adbd7944801">&#9670;&#160;</a></span>StringCallback</h2>
  147. <div class="memitem">
  148. <div class="memproto">
  149. <table class="memname">
  150. <tr>
  151. <td class="memname">typedef const char *(* StringCallback) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td>
  152. </tr>
  153. </table>
  154. </div><div class="memdoc">
  155. </div>
  156. </div>
  157. <a id="gae7bde538b4003b19dca7a9279b5f79b6" name="gae7bde538b4003b19dca7a9279b5f79b6"></a>
  158. <h2 class="memtitle"><span class="permalink"><a href="#gae7bde538b4003b19dca7a9279b5f79b6">&#9670;&#160;</a></span>VoidCallback</h2>
  159. <div class="memitem">
  160. <div class="memproto">
  161. <table class="memname">
  162. <tr>
  163. <td class="memname">typedef void(* VoidCallback) (<a class="el" href="class_sim_object.html">SimObject</a> *obj, S32 argc, const char *argv[])</td>
  164. </tr>
  165. </table>
  166. </div><div class="memdoc">
  167. </div>
  168. </div>
  169. </div><!-- contents -->
  170. <!-- start footer part -->
  171. <hr class="footer"/><address class="footer"><small>
  172. Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
  173. </small></address>
  174. </body>
  175. </html>