group__WindowsPlatform.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327
  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>TorqueScript Reference: Windows Platform</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="doxygen.css" rel="stylesheet" type="text/css" />
  13. <link href="t2d-stylesheet-extra.css" rel="stylesheet" type="text/css"/>
  14. </head>
  15. <body>
  16. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  17. <div id="titlearea">
  18. <table cellspacing="0" cellpadding="0">
  19. <tbody>
  20. <tr id="projectrow">
  21. <td id="projectalign">
  22. <div id="projectname">TorqueScript Reference
  23. </div>
  24. </td>
  25. </tr>
  26. </tbody>
  27. </table>
  28. </div>
  29. <!-- end header part -->
  30. <!-- Generated by Doxygen 1.9.8 -->
  31. <script type="text/javascript" src="menudata.js"></script>
  32. <script type="text/javascript" src="menu.js"></script>
  33. <script type="text/javascript">
  34. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  35. $(function() {
  36. initMenu('',false,false,'search.php','Search');
  37. });
  38. /* @license-end */
  39. </script>
  40. <div id="main-nav"></div>
  41. </div><!-- top -->
  42. <div class="header">
  43. <div class="summary">
  44. <a href="#func-members">Functions</a> </div>
  45. <div class="headertitle"><div class="title">Windows Platform<div class="ingroups"><a class="el" href="group__TorqueScriptFunctions.html">Function Categories</a></div></div></div>
  46. </div><!--header-->
  47. <div class="contents">
  48. <table class="memberdecls">
  49. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
  50. Functions</h2></td></tr>
  51. <tr class="memitem:gad08310184aadd784eca477fa3cf7bae4" id="r_gad08310184aadd784eca477fa3cf7bae4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#gad08310184aadd784eca477fa3cf7bae4">enableWinConsole</a> (enable)</td></tr>
  52. <tr class="separator:gad08310184aadd784eca477fa3cf7bae4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  53. <tr class="memitem:gad8a11f7b98fc8c731237ca27276d2696" id="r_gad8a11f7b98fc8c731237ca27276d2696"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#gad8a11f7b98fc8c731237ca27276d2696">getWinNTVersion</a> ()</td></tr>
  54. <tr class="separator:gad8a11f7b98fc8c731237ca27276d2696"><td class="memSeparator" colspan="2">&#160;</td></tr>
  55. <tr class="memitem:gac64021511f8b9485b4f0a1538100ba08" id="r_gac64021511f8b9485b4f0a1538100ba08"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#gac64021511f8b9485b4f0a1538100ba08">GLEnableLogging</a> (enable)</td></tr>
  56. <tr class="separator:gac64021511f8b9485b4f0a1538100ba08"><td class="memSeparator" colspan="2">&#160;</td></tr>
  57. <tr class="memitem:ga21ea2cea896b6be781a1e0883647d346" id="r_ga21ea2cea896b6be781a1e0883647d346"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#ga21ea2cea896b6be781a1e0883647d346">GLEnableMetrics</a> (enable)</td></tr>
  58. <tr class="separator:ga21ea2cea896b6be781a1e0883647d346"><td class="memSeparator" colspan="2">&#160;</td></tr>
  59. <tr class="memitem:ga30e35b88579647e6a225baad8b0453a1" id="r_ga30e35b88579647e6a225baad8b0453a1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#ga30e35b88579647e6a225baad8b0453a1">GLEnableOutline</a> (bool)</td></tr>
  60. <tr class="separator:ga30e35b88579647e6a225baad8b0453a1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  61. <tr class="memitem:ga9291558a3a28c778072fb08746a14fc6" id="r_ga9291558a3a28c778072fb08746a14fc6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#ga9291558a3a28c778072fb08746a14fc6">mathInit</a> (extension)</td></tr>
  62. <tr class="separator:ga9291558a3a28c778072fb08746a14fc6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  63. <tr class="memitem:ga4d76de6f2f895f160850ee57f551fd65" id="r_ga4d76de6f2f895f160850ee57f551fd65"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#ga4d76de6f2f895f160850ee57f551fd65">openFolder</a> (folder)</td></tr>
  64. <tr class="separator:ga4d76de6f2f895f160850ee57f551fd65"><td class="memSeparator" colspan="2">&#160;</td></tr>
  65. <tr class="memitem:gae9fdb47094498699bfc774a4359ddfc0" id="r_gae9fdb47094498699bfc774a4359ddfc0"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__TorqueScriptTypes.html#ga2b43030c97cd77d3fe3fc96fd39aa246">Boolean</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#gae9fdb47094498699bfc774a4359ddfc0">shellExecute</a> (executable, [args]?, [directory]?)</td></tr>
  66. <tr class="separator:gae9fdb47094498699bfc774a4359ddfc0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  67. <tr class="memitem:gaf1c6aefb8e094edb8b516b3522ca9486" id="r_gaf1c6aefb8e094edb8b516b3522ca9486"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__WindowsPlatform.html#gaf1c6aefb8e094edb8b516b3522ca9486">shellExecuteBlocking</a> (executable, [args]?, [directory]?)</td></tr>
  68. <tr class="separator:gaf1c6aefb8e094edb8b516b3522ca9486"><td class="memSeparator" colspan="2">&#160;</td></tr>
  69. </table>
  70. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  71. <h2 class="groupheader">Function Documentation</h2>
  72. <a id="gad08310184aadd784eca477fa3cf7bae4" name="gad08310184aadd784eca477fa3cf7bae4"></a>
  73. <h2 class="memtitle"><span class="permalink"><a href="#gad08310184aadd784eca477fa3cf7bae4">&#9670;&#160;</a></span>enableWinConsole()</h2>
  74. <div class="memitem">
  75. <div class="memproto">
  76. <table class="memname">
  77. <tr>
  78. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> enableWinConsole </td>
  79. <td>(</td>
  80. <td class="paramtype">enable&#160;</td>
  81. <td class="paramname"></td><td>)</td>
  82. <td></td>
  83. </tr>
  84. </table>
  85. </div><div class="memdoc">
  86. <p>Use the enableWinConsole function to tell TGB to create an external console window, either as a separate DOS window or as a new window under OSX/Linux/*NIX. Subsequent calls to this function do nothing. Only one external console is allowed </p><dl class="params"><dt>Parameters</dt><dd>
  87. <table class="params">
  88. <tr><td class="paramname">enable</td><td>A boolean. If this value is set to true, a new console window will be created. </td></tr>
  89. </table>
  90. </dd>
  91. </dl>
  92. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  93. </div>
  94. </div>
  95. <a id="gad8a11f7b98fc8c731237ca27276d2696" name="gad8a11f7b98fc8c731237ca27276d2696"></a>
  96. <h2 class="memtitle"><span class="permalink"><a href="#gad8a11f7b98fc8c731237ca27276d2696">&#9670;&#160;</a></span>getWinNTVersion()</h2>
  97. <div class="memitem">
  98. <div class="memproto">
  99. <table class="memname">
  100. <tr>
  101. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> getWinNTVersion </td>
  102. <td>(</td>
  103. <td class="paramname"></td><td>)</td>
  104. <td></td>
  105. </tr>
  106. </table>
  107. </div><div class="memdoc">
  108. </div>
  109. </div>
  110. <a id="gac64021511f8b9485b4f0a1538100ba08" name="gac64021511f8b9485b4f0a1538100ba08"></a>
  111. <h2 class="memtitle"><span class="permalink"><a href="#gac64021511f8b9485b4f0a1538100ba08">&#9670;&#160;</a></span>GLEnableLogging()</h2>
  112. <div class="memitem">
  113. <div class="memproto">
  114. <table class="memname">
  115. <tr>
  116. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> GLEnableLogging </td>
  117. <td>(</td>
  118. <td class="paramtype">enable&#160;</td>
  119. <td class="paramname"></td><td>)</td>
  120. <td></td>
  121. </tr>
  122. </table>
  123. </div><div class="memdoc">
  124. <p>Use the GLEnableLogging function to enable/disable the gathering of OpenGL metrics. For this to work, the engine must have been compiled with either TORQUE_DEBUG or INTERNAL_RELEASE defined. Always be sure to do a disable after an enable to flush the last log data to the log file. </p><dl class="params"><dt>Parameters</dt><dd>
  125. <table class="params">
  126. <tr><td class="paramname">enable</td><td>A boolean value. If set to true, the engine will gather various OpenGL metrics and dump them to a file named gl_log.txt. If set to false, logging is stopped, the last writes to the log are flushed, and the file is closed. </td></tr>
  127. </table>
  128. </dd>
  129. </dl>
  130. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  131. <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__WindowsPlatform.html#ga21ea2cea896b6be781a1e0883647d346">GLEnableMetrics</a>, metrics </dd></dl>
  132. </div>
  133. </div>
  134. <a id="ga21ea2cea896b6be781a1e0883647d346" name="ga21ea2cea896b6be781a1e0883647d346"></a>
  135. <h2 class="memtitle"><span class="permalink"><a href="#ga21ea2cea896b6be781a1e0883647d346">&#9670;&#160;</a></span>GLEnableMetrics()</h2>
  136. <div class="memitem">
  137. <div class="memproto">
  138. <table class="memname">
  139. <tr>
  140. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> GLEnableMetrics </td>
  141. <td>(</td>
  142. <td class="paramtype">enable&#160;</td>
  143. <td class="paramname"></td><td>)</td>
  144. <td></td>
  145. </tr>
  146. </table>
  147. </div><div class="memdoc">
  148. <p>Use the GLEnableMetrics function to enable or disable logging of OpenGL texture and video metrics. For this to work, the engine must have been compiled with either TORQUE_DEBUG or INTERNAL_RELEASE defined. Use the metrics function to get at this information. Also, once this feature is enabled, the following globals will be available for inspection/examination: &lt;OpenGL::triCount0 ? Terrain triangles, OpenGL::triCount1? DIF triangles, OpenGL::triCount2 ? DTS triangles, OpenGL::triCount3 ? Uncategorized triangles, OpenGL::primCount0 - Terrain primitives, OpenGL::primCount1 ? DIF primitives, OpenGL::primCount2 ? DTS primitives, OpenGL::primCount3 ? Uncategorized primitives&gt; </p><dl class="params"><dt>Parameters</dt><dd>
  149. <table class="params">
  150. <tr><td class="paramname">enable</td><td>A boolean value. When this is set to true, texture and video (triangles and primitives) logging is enabled and dumped as part of calls to certain metrics. </td></tr>
  151. </table>
  152. </dd>
  153. </dl>
  154. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  155. <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__WindowsPlatform.html#gac64021511f8b9485b4f0a1538100ba08">GLEnableLogging</a>, metrics </dd></dl>
  156. </div>
  157. </div>
  158. <a id="ga30e35b88579647e6a225baad8b0453a1" name="ga30e35b88579647e6a225baad8b0453a1"></a>
  159. <h2 class="memtitle"><span class="permalink"><a href="#ga30e35b88579647e6a225baad8b0453a1">&#9670;&#160;</a></span>GLEnableOutline()</h2>
  160. <div class="memitem">
  161. <div class="memproto">
  162. <table class="memname">
  163. <tr>
  164. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> GLEnableOutline </td>
  165. <td>(</td>
  166. <td class="paramtype">bool&#160;</td>
  167. <td class="paramname"></td><td>)</td>
  168. <td></td>
  169. </tr>
  170. </table>
  171. </div><div class="memdoc">
  172. <p>Enables outlines with OpenGL </p><dl class="params"><dt>Parameters</dt><dd>
  173. <table class="params">
  174. <tr><td class="paramname">enable</td><td>Boolean value representing whether or not outlines should be enabled. </td></tr>
  175. </table>
  176. </dd>
  177. </dl>
  178. <dl class="section return"><dt>Returns</dt><dd>No Return Value. </dd></dl>
  179. </div>
  180. </div>
  181. <a id="ga9291558a3a28c778072fb08746a14fc6" name="ga9291558a3a28c778072fb08746a14fc6"></a>
  182. <h2 class="memtitle"><span class="permalink"><a href="#ga9291558a3a28c778072fb08746a14fc6">&#9670;&#160;</a></span>mathInit()</h2>
  183. <div class="memitem">
  184. <div class="memproto">
  185. <table class="memname">
  186. <tr>
  187. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> mathInit </td>
  188. <td>(</td>
  189. <td class="paramtype">extension&#160;</td>
  190. <td class="paramname"></td><td>)</td>
  191. <td></td>
  192. </tr>
  193. </table>
  194. </div><div class="memdoc">
  195. <p>Use the MathInit function to install a specified math extensions, or to detect and enable all extensions. Generally speaking, the best extension choice is to used detect. This will automatically detected and enable all extensions supported by the current processor. It will also print out a list of the extension that were enabled to the console </p><dl class="params"><dt>Parameters</dt><dd>
  196. <table class="params">
  197. <tr><td class="paramname">extension</td><td>Can be any of these:detect ? Detect all supported extensions and enable.C - Enable standard C extensions.FPU - Enable floating-point-unit extensions.MMX - Enable Intel MMX extensions.3DNOW - Enable AMD 3DNOW extensions.SSE - Enable Intel SSE extensions. </td></tr>
  198. </table>
  199. </dd>
  200. </dl>
  201. <dl class="section return"><dt>Returns</dt><dd>No return value. </dd></dl>
  202. </div>
  203. </div>
  204. <a id="ga4d76de6f2f895f160850ee57f551fd65" name="ga4d76de6f2f895f160850ee57f551fd65"></a>
  205. <h2 class="memtitle"><span class="permalink"><a href="#ga4d76de6f2f895f160850ee57f551fd65">&#9670;&#160;</a></span>openFolder()</h2>
  206. <div class="memitem">
  207. <div class="memproto">
  208. <table class="memname">
  209. <tr>
  210. <td class="memname"><a class="el" href="group__MetaScriptingFunctions.html#ga3428b441d74b14a5aed2f08490b4b9f3">void</a> openFolder </td>
  211. <td>(</td>
  212. <td class="paramtype">folder&#160;</td>
  213. <td class="paramname"></td><td>)</td>
  214. <td></td>
  215. </tr>
  216. </table>
  217. </div><div class="memdoc">
  218. <p>Opens a folder of the platform </p>
  219. </div>
  220. </div>
  221. <a id="gae9fdb47094498699bfc774a4359ddfc0" name="gae9fdb47094498699bfc774a4359ddfc0"></a>
  222. <h2 class="memtitle"><span class="permalink"><a href="#gae9fdb47094498699bfc774a4359ddfc0">&#9670;&#160;</a></span>shellExecute()</h2>
  223. <div class="memitem">
  224. <div class="memproto">
  225. <table class="memname">
  226. <tr>
  227. <td class="memname"><a class="el" href="group__TorqueScriptTypes.html#ga2b43030c97cd77d3fe3fc96fd39aa246">Boolean</a> shellExecute </td>
  228. <td>(</td>
  229. <td class="paramtype">executable&#160;</td>
  230. <td class="paramname">, </td>
  231. </tr>
  232. <tr>
  233. <td class="paramkey"></td>
  234. <td></td>
  235. <td class="paramtype">[args] ?&#160;</td>
  236. <td class="paramname">, </td>
  237. </tr>
  238. <tr>
  239. <td class="paramkey"></td>
  240. <td></td>
  241. <td class="paramtype">[directory] ?&#160;</td>
  242. <td class="paramname">&#160;</td>
  243. </tr>
  244. <tr>
  245. <td></td>
  246. <td>)</td>
  247. <td></td><td></td>
  248. </tr>
  249. </table>
  250. </div><div class="memdoc">
  251. <p>Executes a process </p><dl class="params"><dt>Parameters</dt><dd>
  252. <table class="params">
  253. <tr><td class="paramname">executable</td><td>The program to execute </td></tr>
  254. <tr><td class="paramname">args</td><td>Arguments to pass to the executable </td></tr>
  255. <tr><td class="paramname">directory</td><td>The directory in which the program is located </td></tr>
  256. </table>
  257. </dd>
  258. </dl>
  259. <dl class="section return"><dt>Returns</dt><dd>Returns true on success, false otherwise </dd></dl>
  260. </div>
  261. </div>
  262. <a id="gaf1c6aefb8e094edb8b516b3522ca9486" name="gaf1c6aefb8e094edb8b516b3522ca9486"></a>
  263. <h2 class="memtitle"><span class="permalink"><a href="#gaf1c6aefb8e094edb8b516b3522ca9486">&#9670;&#160;</a></span>shellExecuteBlocking()</h2>
  264. <div class="memitem">
  265. <div class="memproto">
  266. <table class="memname">
  267. <tr>
  268. <td class="memname">int shellExecuteBlocking </td>
  269. <td>(</td>
  270. <td class="paramtype">executable&#160;</td>
  271. <td class="paramname">, </td>
  272. </tr>
  273. <tr>
  274. <td class="paramkey"></td>
  275. <td></td>
  276. <td class="paramtype">[args] ?&#160;</td>
  277. <td class="paramname">, </td>
  278. </tr>
  279. <tr>
  280. <td class="paramkey"></td>
  281. <td></td>
  282. <td class="paramtype">[directory] ?&#160;</td>
  283. <td class="paramname">&#160;</td>
  284. </tr>
  285. <tr>
  286. <td></td>
  287. <td>)</td>
  288. <td></td><td></td>
  289. </tr>
  290. </table>
  291. </div><div class="memdoc">
  292. <dl class="params"><dt>Parameters</dt><dd>
  293. <table class="params">
  294. <tr><td class="paramname">executable</td><td>The program to execute </td></tr>
  295. <tr><td class="paramname">args</td><td>Arguments to pass to the executable </td></tr>
  296. <tr><td class="paramname">directory</td><td>The directory in which the program is located </td></tr>
  297. </table>
  298. </dd>
  299. </dl>
  300. <dl class="section return"><dt>Returns</dt><dd>Returns true on success, false otherwise </dd></dl>
  301. </div>
  302. </div>
  303. </div><!-- contents -->
  304. <!-- start footer part -->
  305. <hr class="footer"/><address class="footer"><small>
  306. 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
  307. </small></address>
  308. </body>
  309. </html>