BlockPyPrinter.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>JSDoc: Class: BlockPyPrinter</title>
  6. <script src="scripts/prettify/prettify.js"> </script>
  7. <script src="scripts/prettify/lang-css.js"> </script>
  8. <!--[if lt IE 9]>
  9. <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  10. <![endif]-->
  11. <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
  12. <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
  13. </head>
  14. <body>
  15. <div id="main">
  16. <h1 class="page-title">Class: BlockPyPrinter</h1>
  17. <section>
  18. <header>
  19. <h2>BlockPyPrinter</h2>
  20. </header>
  21. <article>
  22. <div class="container-overview">
  23. <h4 class="name" id="BlockPyPrinter"><span class="type-signature"></span>new BlockPyPrinter<span class="signature">(main, tag)</span><span class="type-signature"></span></h4>
  24. <div class="description">
  25. An object for managing the console where printing and plotting is outputed.
  26. </div>
  27. <h5>This:</h5>
  28. <ul><li>{<a href="BlockPyEditor.html">BlockPyEditor</a>}</li></ul>
  29. <h5>Parameters:</h5>
  30. <table class="params">
  31. <thead>
  32. <tr>
  33. <th>Name</th>
  34. <th>Type</th>
  35. <th class="last">Description</th>
  36. </tr>
  37. </thead>
  38. <tbody>
  39. <tr>
  40. <td class="name"><code>main</code></td>
  41. <td class="type">
  42. <span class="param-type">Object</span>
  43. </td>
  44. <td class="description last">The main BlockPy instance</td>
  45. </tr>
  46. <tr>
  47. <td class="name"><code>tag</code></td>
  48. <td class="type">
  49. <span class="param-type">HTMLElement</span>
  50. </td>
  51. <td class="description last">The HTML object this is attached to.</td>
  52. </tr>
  53. </tbody>
  54. </table>
  55. <dl class="details">
  56. <dt class="tag-source">Source:</dt>
  57. <dd class="tag-source"><ul class="dummy"><li>
  58. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line9">line 9</a>
  59. </li></ul></dd>
  60. </dl>
  61. </div>
  62. <h3 class="subsection-title">Methods</h3>
  63. <h4 class="name" id="getConfiguration"><span class="type-signature"></span>getConfiguration<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
  64. <div class="description">
  65. Update and return the current configuration of the printer. This
  66. involves calculating its size, among other operations.
  67. </div>
  68. <dl class="details">
  69. <dt class="tag-source">Source:</dt>
  70. <dd class="tag-source"><ul class="dummy"><li>
  71. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line39">line 39</a>
  72. </li></ul></dd>
  73. </dl>
  74. <h5>Returns:</h5>
  75. <div class="param-desc">
  76. Returns an object with information about the printer.
  77. </div>
  78. <dl>
  79. <dt>
  80. Type
  81. </dt>
  82. <dd>
  83. <span class="param-type">Object</span>
  84. </dd>
  85. </dl>
  86. <h4 class="name" id="print"><span class="type-signature"></span>print<span class="signature">(lineText)</span><span class="type-signature"></span></h4>
  87. <div class="description">
  88. Print a successful line to the on-screen printer.
  89. </div>
  90. <h5>Parameters:</h5>
  91. <table class="params">
  92. <thead>
  93. <tr>
  94. <th>Name</th>
  95. <th>Type</th>
  96. <th class="last">Description</th>
  97. </tr>
  98. </thead>
  99. <tbody>
  100. <tr>
  101. <td class="name"><code>lineText</code></td>
  102. <td class="type">
  103. <span class="param-type">String</span>
  104. </td>
  105. <td class="description last">A line of text to be printed out.</td>
  106. </tr>
  107. </tbody>
  108. </table>
  109. <dl class="details">
  110. <dt class="tag-source">Source:</dt>
  111. <dd class="tag-source"><ul class="dummy"><li>
  112. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line71">line 71</a>
  113. </li></ul></dd>
  114. </dl>
  115. <h4 class="name" id="printHtml"><span class="type-signature"></span>printHtml<span class="signature">(html, value)</span><span class="type-signature"></span></h4>
  116. <div class="description">
  117. Prints a successful HTML blob to the printer. This is typically charts,
  118. but it can actually be any kind of HTML. This will probably be useful for
  119. doing Turtle and Processing stuff down the road.
  120. </div>
  121. <h5>Parameters:</h5>
  122. <table class="params">
  123. <thead>
  124. <tr>
  125. <th>Name</th>
  126. <th>Type</th>
  127. <th class="last">Description</th>
  128. </tr>
  129. </thead>
  130. <tbody>
  131. <tr>
  132. <td class="name"><code>html</code></td>
  133. <td class="type">
  134. <span class="param-type">HTML</span>
  135. </td>
  136. <td class="description last">A blob of HTML to render in the tag</td>
  137. </tr>
  138. <tr>
  139. <td class="name"><code>value</code></td>
  140. <td class="type">
  141. <span class="param-type">Anything</span>
  142. </td>
  143. <td class="description last">a value to push on the outputList for comparison. For instance, on charts this is typically the data of the chart.</td>
  144. </tr>
  145. </tbody>
  146. </table>
  147. <dl class="details">
  148. <dt class="tag-source">Source:</dt>
  149. <dd class="tag-source"><ul class="dummy"><li>
  150. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line104">line 104</a>
  151. </li></ul></dd>
  152. </dl>
  153. <h4 class="name" id="resetPrinter"><span class="type-signature"></span>resetPrinter<span class="signature">()</span><span class="type-signature"></span></h4>
  154. <div class="description">
  155. Reset the status of the printer, including removing any text in it and
  156. fixing its size.
  157. </div>
  158. <dl class="details">
  159. <dt class="tag-source">Source:</dt>
  160. <dd class="tag-source"><ul class="dummy"><li>
  161. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line23">line 23</a>
  162. </li></ul></dd>
  163. </dl>
  164. <h4 class="name" id="stepPrinter"><span class="type-signature"></span>stepPrinter<span class="signature">(step, page)</span><span class="type-signature"></span></h4>
  165. <div class="description">
  166. Updates each printed element in the printer and makes it hidden
  167. or visible, depending on what step we're on.
  168. </div>
  169. <h5>Parameters:</h5>
  170. <table class="params">
  171. <thead>
  172. <tr>
  173. <th>Name</th>
  174. <th>Type</th>
  175. <th class="last">Description</th>
  176. </tr>
  177. </thead>
  178. <tbody>
  179. <tr>
  180. <td class="name"><code>step</code></td>
  181. <td class="type">
  182. <span class="param-type">Number</span>
  183. </td>
  184. <td class="description last">The current step of the executed program that we're on; each element in the printer must be marked with a "data-step" property to resolve this.</td>
  185. </tr>
  186. <tr>
  187. <td class="name"><code>page</code></td>
  188. <td class="type">
  189. <span class="param-type">Number</span>
  190. </td>
  191. <td class="description last">Deprecated, not sure what this even does.</td>
  192. </tr>
  193. </tbody>
  194. </table>
  195. <dl class="details">
  196. <dt class="tag-source">Source:</dt>
  197. <dd class="tag-source"><ul class="dummy"><li>
  198. <a href="printer.js.html">printer.js</a>, <a href="printer.js.html#line57">line 57</a>
  199. </li></ul></dd>
  200. </dl>
  201. </article>
  202. </section>
  203. </div>
  204. <nav>
  205. <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BlockPy.html">BlockPy</a></li><li><a href="BlockPyCorgis.html">BlockPyCorgis</a></li><li><a href="BlockPyDialog.html">BlockPyDialog</a></li><li><a href="BlockPyEditor.html">BlockPyEditor</a></li><li><a href="BlockPyEngine.html">BlockPyEngine</a></li><li><a href="BlockPyEnglish.html">BlockPyEnglish</a></li><li><a href="BlockPyFeedback.html">BlockPyFeedback</a></li><li><a href="BlockPyHistory.html">BlockPyHistory</a></li><li><a href="BlockPyPresentation.html">BlockPyPresentation</a></li><li><a href="BlockPyPrinter.html">BlockPyPrinter</a></li><li><a href="BlockPyServer.html">BlockPyServer</a></li><li><a href="BlockPyToolbar.html">BlockPyToolbar</a></li><li><a href="LocalStorageWrapper.html">LocalStorageWrapper</a></li><li><a href="PythonToBlocks.html">PythonToBlocks</a></li></ul><h3>Global</h3><ul><li><a href="global.html#BlockPyInterface">BlockPyInterface</a></li><li><a href="global.html#cloneNode">cloneNode</a></li><li><a href="global.html#encodeHTML">encodeHTML</a></li><li><a href="global.html#expandArray">expandArray</a></li><li><a href="global.html#EXTENDED_ERROR_EXPLANATION">EXTENDED_ERROR_EXPLANATION</a></li><li><a href="global.html#indent">indent</a></li><li><a href="global.html#instructor_module">instructor_module</a></li><li><a href="global.html#prettyPrintDateTime">prettyPrintDateTime</a></li><li><a href="global.html#randomInteger">randomInteger</a></li><li><a href="global.html#set_button_loaded">set_button_loaded</a></li><li><a href="global.html#timerGuard">timerGuard</a></li></ul>
  206. </nav>
  207. <br class="clear">
  208. <footer>
  209. Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Sun Mar 26 2017 09:45:04 GMT-0400 (Eastern Daylight Time)
  210. </footer>
  211. <script> prettyPrint(); </script>
  212. <script src="scripts/linenumber.js"> </script>
  213. </body>
  214. </html>