group__Net.html 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <title>Net</title>
  6. <link href="torquedoc.css" rel="stylesheet" type="text/css"/>
  7. </head>
  8. <body>
  9. <table width="100%" class="header">
  10. <tr>
  11. </tr>
  12. <tr><td class="headermenu">
  13. <center>
  14. <a class="qindex" href="index.html">Main</a> &nbsp;
  15. <a class="qindex" target="_blank" href="https://github.com/GarageGames/Torque2D">GitHub</a>
  16. </center>
  17. </td></tr>
  18. </table>
  19. <br>
  20. <!-- END HEADER -->
  21. <!-- Generated by Doxygen 1.8.3.1 -->
  22. </div><!-- top -->
  23. <div class="header">
  24. <div class="summary">
  25. <a href="#func-members">Functions</a> </div>
  26. <div class="headertitle">
  27. <div class="title">Net</div> </div>
  28. </div><!--header-->
  29. <div class="contents">
  30. <table class="memberdecls">
  31. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
  32. Functions</h2></td></tr>
  33. <tr class="memitem:gaf86bcb9fecf125d584a3bac81a586d67"><td class="memItemLeft" align="right" valign="top">string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#gaf86bcb9fecf125d584a3bac81a586d67">addTaggedString</a> (string)</td></tr>
  34. <tr class="separator:gaf86bcb9fecf125d584a3bac81a586d67"><td class="memSeparator" colspan="2">&#160;</td></tr>
  35. <tr class="memitem:gadd78d2b3321e820ce50941a1e6de0171"><td class="memItemLeft" align="right" valign="top">string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#gadd78d2b3321e820ce50941a1e6de0171">buildTaggedString</a> (format,&lt; arg1,...arg9 &gt;)</td></tr>
  36. <tr class="separator:gadd78d2b3321e820ce50941a1e6de0171"><td class="memSeparator" colspan="2">&#160;</td></tr>
  37. <tr class="memitem:ga3dce1c07d9c2775aa41ada242d454168"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#ga3dce1c07d9c2775aa41ada242d454168">commandToClient</a> (client, func[, arg1,..., argn])</td></tr>
  38. <tr class="separator:ga3dce1c07d9c2775aa41ada242d454168"><td class="memSeparator" colspan="2">&#160;</td></tr>
  39. <tr class="memitem:gafdfcdc6d09826c905ee224b1106c3429"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#gafdfcdc6d09826c905ee224b1106c3429">commandToServer</a> (func[, arg1,..., argn])</td></tr>
  40. <tr class="separator:gafdfcdc6d09826c905ee224b1106c3429"><td class="memSeparator" colspan="2">&#160;</td></tr>
  41. <tr class="memitem:gab369c60e5ba2cb4c59418117f18d914a"><td class="memItemLeft" align="right" valign="top">string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#gab369c60e5ba2cb4c59418117f18d914a">getTaggedString</a> (tag)</td></tr>
  42. <tr class="separator:gab369c60e5ba2cb4c59418117f18d914a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  43. <tr class="memitem:gaed69d0661105dd6db03bff8b7e858f0c"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Net.html#gaed69d0661105dd6db03bff8b7e858f0c">removeTaggedString</a> (tag)</td></tr>
  44. <tr class="separator:gaed69d0661105dd6db03bff8b7e858f0c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  45. </table>
  46. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  47. <p>Functions for use with the network; tagged strings and remote commands. </p>
  48. <h2 class="groupheader">Function Documentation</h2>
  49. <a class="anchor" id="gaf86bcb9fecf125d584a3bac81a586d67"></a>
  50. <div class="memitem">
  51. <div class="memproto">
  52. <table class="memname">
  53. <tr>
  54. <td class="memname">string addTaggedString </td>
  55. <td>(</td>
  56. <td class="paramtype">string&#160;</td>
  57. <td class="paramname"></td><td>)</td>
  58. <td></td>
  59. </tr>
  60. </table>
  61. </div><div class="memdoc">
  62. <p>Use the addTaggedString function to tag a new string and add it to the NetStringTable. </p>
  63. <dl class="params"><dt>Parameters</dt><dd>
  64. <table class="params">
  65. <tr><td class="paramname">string</td><td>The string to tagged and placed in the NetStringTable. Tagging ignores case, so tagging the same string (excluding case differences) will be ignored as a duplicated tag. </td></tr>
  66. </table>
  67. </dd>
  68. </dl>
  69. <dl class="section return"><dt>Returns</dt><dd>Returns a string (containing a numeric value) equivalent to the string ID for the newly tagged string </dd></dl>
  70. </div>
  71. </div>
  72. <a class="anchor" id="gadd78d2b3321e820ce50941a1e6de0171"></a>
  73. <div class="memitem">
  74. <div class="memproto">
  75. <table class="memname">
  76. <tr>
  77. <td class="memname">string buildTaggedString </td>
  78. <td>(</td>
  79. <td class="paramtype">format&#160;</td>
  80. <td class="paramname">, </td>
  81. </tr>
  82. <tr>
  83. <td class="paramkey"></td>
  84. <td></td>
  85. <td class="paramtype">&lt; arg1,...arg9 &gt;&#160;</td>
  86. <td class="paramname">&#160;</td>
  87. </tr>
  88. <tr>
  89. <td></td>
  90. <td>)</td>
  91. <td></td><td></td>
  92. </tr>
  93. </table>
  94. </div><div class="memdoc">
  95. <p>Use the buildTaggedString function to build a tagged string using the specified format. </p>
  96. <dl class="params"><dt>Parameters</dt><dd>
  97. <table class="params">
  98. <tr><td class="paramname">enable</td><td>A boolean value. If set to true, network packet logging is enabled, otherwise it is disabled. </td></tr>
  99. </table>
  100. </dd>
  101. </dl>
  102. <dl class="section return"><dt>Returns</dt><dd>No return value </dd></dl>
  103. </div>
  104. </div>
  105. <a class="anchor" id="ga3dce1c07d9c2775aa41ada242d454168"></a>
  106. <div class="memitem">
  107. <div class="memproto">
  108. <table class="memname">
  109. <tr>
  110. <td class="memname">void commandToClient </td>
  111. <td>(</td>
  112. <td class="paramtype">client&#160;</td>
  113. <td class="paramname">, </td>
  114. </tr>
  115. <tr>
  116. <td class="paramkey"></td>
  117. <td></td>
  118. <td class="paramtype">func&#160;</td>
  119. <td class="paramname">[, arg1,..., argn]&#160;</td>
  120. </tr>
  121. <tr>
  122. <td></td>
  123. <td>)</td>
  124. <td></td><td></td>
  125. </tr>
  126. </table>
  127. </div><div class="memdoc">
  128. <p>Use the commandToClient function to issue a remote procedure call on a client. All arguments (excluding client) may be in tagged or non-tagged format. See 'Remote Procedure Call Samples' below </p>
  129. <dl class="params"><dt>Parameters</dt><dd>
  130. <table class="params">
  131. <tr><td class="paramname">client</td><td>The numeric ID of a client gameConnection. </td></tr>
  132. <tr><td class="paramname">func</td><td>The suffix of the remote procedure name to be executed on the client. </td></tr>
  133. <tr><td class="paramname">arg1</td><td>... argn - Optional arguments to be passed to the remote procedure. </td></tr>
  134. </table>
  135. </dd>
  136. </dl>
  137. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  138. </div>
  139. </div>
  140. <a class="anchor" id="gafdfcdc6d09826c905ee224b1106c3429"></a>
  141. <div class="memitem">
  142. <div class="memproto">
  143. <table class="memname">
  144. <tr>
  145. <td class="memname">void commandToServer </td>
  146. <td>(</td>
  147. <td class="paramtype">func&#160;</td>
  148. <td class="paramname">[, arg1,..., argn]</td><td>)</td>
  149. <td></td>
  150. </tr>
  151. </table>
  152. </div><div class="memdoc">
  153. <p>Use the commandToServer function to issue a remote procedure call the server. All arguments may be in tagged or non-tagged format. See 'Remote Procedure Call Samples' below </p>
  154. <dl class="params"><dt>Parameters</dt><dd>
  155. <table class="params">
  156. <tr><td class="paramname">func</td><td>The suffix of the remote procedure name to be executed on the client. </td></tr>
  157. <tr><td class="paramname">arg1</td><td>... argn - Optional arguments to be passed to the remote procedure. </td></tr>
  158. </table>
  159. </dd>
  160. </dl>
  161. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  162. </div>
  163. </div>
  164. <a class="anchor" id="gab369c60e5ba2cb4c59418117f18d914a"></a>
  165. <div class="memitem">
  166. <div class="memproto">
  167. <table class="memname">
  168. <tr>
  169. <td class="memname">string getTaggedString </td>
  170. <td>(</td>
  171. <td class="paramtype">tag&#160;</td>
  172. <td class="paramname"></td><td>)</td>
  173. <td></td>
  174. </tr>
  175. </table>
  176. </div><div class="memdoc">
  177. <p>Use the getTaggedString function to convert a tag to a string. This is not the same a <a class="el" href="group__TaggedStrings.html#gad9b362e737f1794ee4a727df51585117">detag()</a> which can only be used within the context of a function that receives a tag. This function can be used any time and anywhere to convert a tag to a string. </p>
  178. <dl class="params"><dt>Parameters</dt><dd>
  179. <table class="params">
  180. <tr><td class="paramname">tag</td><td>A numeric tag ID. </td></tr>
  181. </table>
  182. </dd>
  183. </dl>
  184. <dl class="section return"><dt>Returns</dt><dd>Returns the string corresponding to the tag ID </dd></dl>
  185. </div>
  186. </div>
  187. <a class="anchor" id="gaed69d0661105dd6db03bff8b7e858f0c"></a>
  188. <div class="memitem">
  189. <div class="memproto">
  190. <table class="memname">
  191. <tr>
  192. <td class="memname">void removeTaggedString </td>
  193. <td>(</td>
  194. <td class="paramtype">tag&#160;</td>
  195. <td class="paramname"></td><td>)</td>
  196. <td></td>
  197. </tr>
  198. </table>
  199. </div><div class="memdoc">
  200. <p>Use the removeTaggedSTring function to remove a previously tagged string from the NetStringTable. </p>
  201. <dl class="params"><dt>Parameters</dt><dd>
  202. <table class="params">
  203. <tr><td class="paramname">tag</td><td>A number tag ID. </td></tr>
  204. </table>
  205. </dd>
  206. </dl>
  207. <dl class="section return"><dt>Returns</dt><dd>No return value </dd></dl>
  208. </div>
  209. </div>
  210. </div><!-- contents -->
  211. <!-- START FOOTER -->
  212. <br>
  213. <br>
  214. <center>
  215. <div style="color: #777777;">
  216. Copyright &copy; 2013 <a style="color: #777777;" target="_blank" href="http://www.garagegames.com">GarageGames, LLC</a>. All Rights Reserved.
  217. </div>
  218. </center>
  219. </body>
  220. </html>