doc/virtual machine.html

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   5 <head>
   6 <!-- 2023-09-18 Mon 01:46 -->
   7 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
   8 <meta name="viewport" content="width=device-width, initial-scale=1" />
   9 <title>Fifth - virtual machine</title>
  10 <meta name="author" content="Svjatoslav Agejenko" />
  11 <meta name="generator" content="Org Mode" />
  12 <style>
  13   #content { max-width: 60em; margin: auto; }
  14   .title  { text-align: center;
  15              margin-bottom: .2em; }
  16   .subtitle { text-align: center;
  17               font-size: medium;
  18               font-weight: bold;
  19               margin-top:0; }
  20   .todo   { font-family: monospace; color: red; }
  21   .done   { font-family: monospace; color: green; }
  22   .priority { font-family: monospace; color: orange; }
  23   .tag    { background-color: #eee; font-family: monospace;
  24             padding: 2px; font-size: 80%; font-weight: normal; }
  25   .timestamp { color: #bebebe; }
  26   .timestamp-kwd { color: #5f9ea0; }
  27   .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
  28   .org-left   { margin-left: 0px;  margin-right: auto; text-align: left; }
  29   .org-center { margin-left: auto; margin-right: auto; text-align: center; }
  30   .underline { text-decoration: underline; }
  31   #postamble p, #preamble p { font-size: 90%; margin: .2em; }
  32   p.verse { margin-left: 3%; }
  33   pre {
  34     border: 1px solid #e6e6e6;
  35     border-radius: 3px;
  36     background-color: #f2f2f2;
  37     padding: 8pt;
  38     font-family: monospace;
  39     overflow: auto;
  40     margin: 1.2em;
  41   }
  42   pre.src {
  43     position: relative;
  44     overflow: auto;
  45   }
  46   pre.src:before {
  47     display: none;
  48     position: absolute;
  49     top: -8px;
  50     right: 12px;
  51     padding: 3px;
  52     color: #555;
  53     background-color: #f2f2f299;
  54   }
  55   pre.src:hover:before { display: inline; margin-top: 14px;}
  56   /* Languages per Org manual */
  57   pre.src-asymptote:before { content: 'Asymptote'; }
  58   pre.src-awk:before { content: 'Awk'; }
  59   pre.src-authinfo::before { content: 'Authinfo'; }
  60   pre.src-C:before { content: 'C'; }
  61   /* pre.src-C++ doesn't work in CSS */
  62   pre.src-clojure:before { content: 'Clojure'; }
  63   pre.src-css:before { content: 'CSS'; }
  64   pre.src-D:before { content: 'D'; }
  65   pre.src-ditaa:before { content: 'ditaa'; }
  66   pre.src-dot:before { content: 'Graphviz'; }
  67   pre.src-calc:before { content: 'Emacs Calc'; }
  68   pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
  69   pre.src-fortran:before { content: 'Fortran'; }
  70   pre.src-gnuplot:before { content: 'gnuplot'; }
  71   pre.src-haskell:before { content: 'Haskell'; }
  72   pre.src-hledger:before { content: 'hledger'; }
  73   pre.src-java:before { content: 'Java'; }
  74   pre.src-js:before { content: 'Javascript'; }
  75   pre.src-latex:before { content: 'LaTeX'; }
  76   pre.src-ledger:before { content: 'Ledger'; }
  77   pre.src-lisp:before { content: 'Lisp'; }
  78   pre.src-lilypond:before { content: 'Lilypond'; }
  79   pre.src-lua:before { content: 'Lua'; }
  80   pre.src-matlab:before { content: 'MATLAB'; }
  81   pre.src-mscgen:before { content: 'Mscgen'; }
  82   pre.src-ocaml:before { content: 'Objective Caml'; }
  83   pre.src-octave:before { content: 'Octave'; }
  84   pre.src-org:before { content: 'Org mode'; }
  85   pre.src-oz:before { content: 'OZ'; }
  86   pre.src-plantuml:before { content: 'Plantuml'; }
  87   pre.src-processing:before { content: 'Processing.js'; }
  88   pre.src-python:before { content: 'Python'; }
  89   pre.src-R:before { content: 'R'; }
  90   pre.src-ruby:before { content: 'Ruby'; }
  91   pre.src-sass:before { content: 'Sass'; }
  92   pre.src-scheme:before { content: 'Scheme'; }
  93   pre.src-screen:before { content: 'Gnu Screen'; }
  94   pre.src-sed:before { content: 'Sed'; }
  95   pre.src-sh:before { content: 'shell'; }
  96   pre.src-sql:before { content: 'SQL'; }
  97   pre.src-sqlite:before { content: 'SQLite'; }
  98   /* additional languages in org.el's org-babel-load-languages alist */
  99   pre.src-forth:before { content: 'Forth'; }
 100   pre.src-io:before { content: 'IO'; }
 101   pre.src-J:before { content: 'J'; }
 102   pre.src-makefile:before { content: 'Makefile'; }
 103   pre.src-maxima:before { content: 'Maxima'; }
 104   pre.src-perl:before { content: 'Perl'; }
 105   pre.src-picolisp:before { content: 'Pico Lisp'; }
 106   pre.src-scala:before { content: 'Scala'; }
 107   pre.src-shell:before { content: 'Shell Script'; }
 108   pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
 109   /* additional language identifiers per "defun org-babel-execute"
 110        in ob-*.el */
 111   pre.src-cpp:before  { content: 'C++'; }
 112   pre.src-abc:before  { content: 'ABC'; }
 113   pre.src-coq:before  { content: 'Coq'; }
 114   pre.src-groovy:before  { content: 'Groovy'; }
 115   /* additional language identifiers from org-babel-shell-names in
 116      ob-shell.el: ob-shell is the only babel language using a lambda to put
 117      the execution function name together. */
 118   pre.src-bash:before  { content: 'bash'; }
 119   pre.src-csh:before  { content: 'csh'; }
 120   pre.src-ash:before  { content: 'ash'; }
 121   pre.src-dash:before  { content: 'dash'; }
 122   pre.src-ksh:before  { content: 'ksh'; }
 123   pre.src-mksh:before  { content: 'mksh'; }
 124   pre.src-posh:before  { content: 'posh'; }
 125   /* Additional Emacs modes also supported by the LaTeX listings package */
 126   pre.src-ada:before { content: 'Ada'; }
 127   pre.src-asm:before { content: 'Assembler'; }
 128   pre.src-caml:before { content: 'Caml'; }
 129   pre.src-delphi:before { content: 'Delphi'; }
 130   pre.src-html:before { content: 'HTML'; }
 131   pre.src-idl:before { content: 'IDL'; }
 132   pre.src-mercury:before { content: 'Mercury'; }
 133   pre.src-metapost:before { content: 'MetaPost'; }
 134   pre.src-modula-2:before { content: 'Modula-2'; }
 135   pre.src-pascal:before { content: 'Pascal'; }
 136   pre.src-ps:before { content: 'PostScript'; }
 137   pre.src-prolog:before { content: 'Prolog'; }
 138   pre.src-simula:before { content: 'Simula'; }
 139   pre.src-tcl:before { content: 'tcl'; }
 140   pre.src-tex:before { content: 'TeX'; }
 141   pre.src-plain-tex:before { content: 'Plain TeX'; }
 142   pre.src-verilog:before { content: 'Verilog'; }
 143   pre.src-vhdl:before { content: 'VHDL'; }
 144   pre.src-xml:before { content: 'XML'; }
 145   pre.src-nxml:before { content: 'XML'; }
 146   /* add a generic configuration mode; LaTeX export needs an additional
 147      (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
 148   pre.src-conf:before { content: 'Configuration File'; }
 149
 150   table { border-collapse:collapse; }
 151   caption.t-above { caption-side: top; }
 152   caption.t-bottom { caption-side: bottom; }
 153   td, th { vertical-align:top;  }
 154   th.org-right  { text-align: center;  }
 155   th.org-left   { text-align: center;   }
 156   th.org-center { text-align: center; }
 157   td.org-right  { text-align: right;  }
 158   td.org-left   { text-align: left;   }
 159   td.org-center { text-align: center; }
 160   dt { font-weight: bold; }
 161   .footpara { display: inline; }
 162   .footdef  { margin-bottom: 1em; }
 163   .figure { padding: 1em; }
 164   .figure p { text-align: center; }
 165   .equation-container {
 166     display: table;
 167     text-align: center;
 168     width: 100%;
 169   }
 170   .equation {
 171     vertical-align: middle;
 172   }
 173   .equation-label {
 174     display: table-cell;
 175     text-align: right;
 176     vertical-align: middle;
 177   }
 178   .inlinetask {
 179     padding: 10px;
 180     border: 2px solid gray;
 181     margin: 10px;
 182     background: #ffffcc;
 183   }
 184   #org-div-home-and-up
 185    { text-align: right; font-size: 70%; white-space: nowrap; }
 186   textarea { overflow-x: auto; }
 187   .linenr { font-size: smaller }
 188   .code-highlighted { background-color: #ffff00; }
 189   .org-info-js_info-navigation { border-style: none; }
 190   #org-info-js_console-label
 191     { font-size: 10px; font-weight: bold; white-space: nowrap; }
 192   .org-info-js_search-highlight
 193     { background-color: #ffff00; color: #000000; font-weight: bold; }
 194   .org-svg { }
 195 </style>
 196 <link rel="stylesheet" type="text/css" href="https://thomasf.github.io/solarized-css/solarized-dark.min.css" />
 197 </head>
 198 <body>
 199 <div id="content" class="content">
 200 <h1 class="title">Fifth - virtual machine</h1>
 201 <div id="table-of-contents" role="doc-toc">
 202 <h2>Table of Contents</h2>
 203 <div id="text-table-of-contents" role="doc-toc">
 204 <ul>
 205 <li><a href="#org5215c98">1. Instructions overview</a>
 206 <ul>
 207 <li><a href="#orgad315b0">1.1. kbd@ - read scancode of pressed or released key</a></li>
 208 <li><a href="#org944323a">1.2. vidput - put image1 into image2, at location x, y</a></li>
 209 <li><a href="#org5b4d781">1.3. cmove - copy memory array</a></li>
 210 <li><a href="#orgb1e3963">1.4. tvidput - put image with transparency support</a></li>
 211 <li><a href="#orgac6e38a">1.5. charput - draw text character</a></li>
 212 </ul>
 213 </li>
 214 </ul>
 215 </div>
 216 </div>
 217 <p>
 218 Current emulator emulates:
 219 </p>
 220 <ul class="org-ul">
 221 <li>1 CPU.</li>
 222 <li>It has 2 stacks</li>
 223 <li>~50 instructions</li>
 224 <li>4GB flat address space (theoretically).</li>
 225 </ul>
 226
 227
 228 <p>
 229 While I tried to keep instruction set simple, I was forced to put in
 230 some complex instructions to make performance acceptable on
 231 emulator.
 232 </p>
 233
 234 <p>
 235 CPU has following registers:
 236 </p>
 237 <dl class="org-dl">
 238 <dt>IP</dt><dd>instruction pointer</dd>
 239 <dt>DSP</dt><dd>data stack pointer</dd>
 240 <dt>RSP</dt><dd>return stack pointer</dd>
 241 </dl>
 242
 243 <div id="outline-container-org5215c98" class="outline-2">
 244 <h2 id="org5215c98"><span class="section-number-2">1.</span> Instructions overview</h2>
 245 <div class="outline-text-2" id="text-1">
 246 <p>
 247 Virtual CPU, commands (most of them are avaiable as ordinary commands
 248 in programming language):
 249 </p>
 250
 251
 252 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 253
 254
 255 <colgroup>
 256 <col  class="org-right" />
 257
 258 <col  class="org-left" />
 259
 260 <col  class="org-left" />
 261
 262 <col  class="org-left" />
 263 </colgroup>
 264 <thead>
 265 <tr>
 266 <th scope="col" class="org-right">#</th>
 267 <th scope="col" class="org-left">name</th>
 268 <th scope="col" class="org-left">stack footprint</th>
 269 <th scope="col" class="org-left">description</th>
 270 </tr>
 271 </thead>
 272 <tbody>
 273 <tr>
 274 <td class="org-right">0</td>
 275 <td class="org-left">nop</td>
 276 <td class="org-left">--</td>
 277 <td class="org-left">does nothing</td>
 278 </tr>
 279
 280 <tr>
 281 <td class="org-right">1</td>
 282 <td class="org-left">halt</td>
 283 <td class="org-left">--</td>
 284 <td class="org-left">halt CPU ( return to DOS on emulator )</td>
 285 </tr>
 286
 287 <tr>
 288 <td class="org-right">2</td>
 289 <td class="org-left"><a href="#orgad315b0">kbd@</a></td>
 290 <td class="org-left">&#x2013; c</td>
 291 <td class="org-left">read scancode of pressed or released key</td>
 292 </tr>
 293
 294 <tr>
 295 <td class="org-right">3</td>
 296 <td class="org-left">num &lt;dword&gt;</td>
 297 <td class="org-left">&#x2013; n</td>
 298 <td class="org-left">put immidiate number into datastack</td>
 299 </tr>
 300
 301 <tr>
 302 <td class="org-right">4</td>
 303 <td class="org-left">jmp &lt;dword&gt;</td>
 304 <td class="org-left">--</td>
 305 <td class="org-left">jump to specified code</td>
 306 </tr>
 307
 308 <tr>
 309 <td class="org-right">5</td>
 310 <td class="org-left">call &lt;dword&gt;</td>
 311 <td class="org-left">&#xa0;</td>
 312 <td class="org-left">jump to specified code, save return address to return stack</td>
 313 </tr>
 314
 315 <tr>
 316 <td class="org-right">6</td>
 317 <td class="org-left">1+</td>
 318 <td class="org-left">n &#x2013; n+1</td>
 319 <td class="org-left">&#xa0;</td>
 320 </tr>
 321
 322 <tr>
 323 <td class="org-right">7</td>
 324 <td class="org-left">1-</td>
 325 <td class="org-left">n &#x2013; n-1</td>
 326 <td class="org-left">&#xa0;</td>
 327 </tr>
 328
 329 <tr>
 330 <td class="org-right">8</td>
 331 <td class="org-left">dup</td>
 332 <td class="org-left">n &#x2013; n n</td>
 333 <td class="org-left">duplicate top of data stack</td>
 334 </tr>
 335
 336 <tr>
 337 <td class="org-right">9</td>
 338 <td class="org-left">drop</td>
 339 <td class="org-left">n --</td>
 340 <td class="org-left">drop last element in data stack</td>
 341 </tr>
 342
 343 <tr>
 344 <td class="org-right">10</td>
 345 <td class="org-left">if &lt;dword&gt;</td>
 346 <td class="org-left">n --</td>
 347 <td class="org-left">jump to addr if top element was 0</td>
 348 </tr>
 349
 350 <tr>
 351 <td class="org-right">11</td>
 352 <td class="org-left">ret</td>
 353 <td class="org-left">&#xa0;</td>
 354 <td class="org-left">jump to code, specified in return stack.</td>
 355 </tr>
 356
 357 <tr>
 358 <td class="org-right">12</td>
 359 <td class="org-left">c@</td>
 360 <td class="org-left">addr &#x2013; n</td>
 361 <td class="org-left">read byte from memory at specified address</td>
 362 </tr>
 363
 364 <tr>
 365 <td class="org-right">13</td>
 366 <td class="org-left">c!</td>
 367 <td class="org-left">n addr --</td>
 368 <td class="org-left">store byte to specified memory</td>
 369 </tr>
 370
 371 <tr>
 372 <td class="org-right">14</td>
 373 <td class="org-left">push</td>
 374 <td class="org-left">DSTK -&gt; RSTK</td>
 375 <td class="org-left">move top of datastack to returnstack</td>
 376 </tr>
 377
 378 <tr>
 379 <td class="org-right">15</td>
 380 <td class="org-left">pop</td>
 381 <td class="org-left">RSTK -&gt; DSTK</td>
 382 <td class="org-left">move top of returnstack to datastack</td>
 383 </tr>
 384
 385 <tr>
 386 <td class="org-right">16</td>
 387 <td class="org-left">&lt;unused&gt;</td>
 388 <td class="org-left">&#xa0;</td>
 389 <td class="org-left">&#xa0;</td>
 390 </tr>
 391
 392 <tr>
 393 <td class="org-right">17</td>
 394 <td class="org-left">rot</td>
 395 <td class="org-left">n1 n2 n3 &#x2013; n2 n3 n1</td>
 396 <td class="org-left">rotate stack elements</td>
 397 </tr>
 398
 399 <tr>
 400 <td class="org-right">18</td>
 401 <td class="org-left">disk@</td>
 402 <td class="org-left">FromDiskSect ToMem --</td>
 403 <td class="org-left">read 1KB from disk into RAM</td>
 404 </tr>
 405
 406 <tr>
 407 <td class="org-right">19</td>
 408 <td class="org-left">disk!</td>
 409 <td class="org-left">FromMem ToDiskSect --</td>
 410 <td class="org-left">write 1KB to disk</td>
 411 </tr>
 412
 413 <tr>
 414 <td class="org-right">20</td>
 415 <td class="org-left">@</td>
 416 <td class="org-left">addr &#x2013; n</td>
 417 <td class="org-left">read 32 bit number from memory</td>
 418 </tr>
 419
 420 <tr>
 421 <td class="org-right">21</td>
 422 <td class="org-left">!</td>
 423 <td class="org-left">n addr --</td>
 424 <td class="org-left">store 32 bit number to memory</td>
 425 </tr>
 426
 427 <tr>
 428 <td class="org-right">22</td>
 429 <td class="org-left">over</td>
 430 <td class="org-left">n1 n2 &#x2013; n1 n2 n1</td>
 431 <td class="org-left">&#xa0;</td>
 432 </tr>
 433
 434 <tr>
 435 <td class="org-right">23</td>
 436 <td class="org-left">swap</td>
 437 <td class="org-left">n1 n2 &#x2013; n2 n1</td>
 438 <td class="org-left">&#xa0;</td>
 439 </tr>
 440
 441 <tr>
 442 <td class="org-right">24</td>
 443 <td class="org-left">+</td>
 444 <td class="org-left">n1 n2 &#x2013; n1+n2</td>
 445 <td class="org-left">&#xa0;</td>
 446 </tr>
 447
 448 <tr>
 449 <td class="org-right">25</td>
 450 <td class="org-left">-</td>
 451 <td class="org-left">n1 n2 &#x2013; n1-n2</td>
 452 <td class="org-left">&#xa0;</td>
 453 </tr>
 454
 455 <tr>
 456 <td class="org-right">26</td>
 457 <td class="org-left">*</td>
 458 <td class="org-left">n1 n2 &#x2013; n1*n2</td>
 459 <td class="org-left">&#xa0;</td>
 460 </tr>
 461
 462 <tr>
 463 <td class="org-right">27</td>
 464 <td class="org-left">/</td>
 465 <td class="org-left">n1 n2 &#x2013; n1/n2</td>
 466 <td class="org-left">&#xa0;</td>
 467 </tr>
 468
 469 <tr>
 470 <td class="org-right">28</td>
 471 <td class="org-left">&gt;</td>
 472 <td class="org-left">n1 n2 &#x2013; result</td>
 473 <td class="org-left">is true when n1 &gt; n2</td>
 474 </tr>
 475
 476 <tr>
 477 <td class="org-right">29</td>
 478 <td class="org-left">&lt;</td>
 479 <td class="org-left">n1 n2 &#x2013; result</td>
 480 <td class="org-left">is true when n1 &lt; n2</td>
 481 </tr>
 482
 483 <tr>
 484 <td class="org-right">30</td>
 485 <td class="org-left">not</td>
 486 <td class="org-left">n1 &#x2013; not_n1</td>
 487 <td class="org-left">logical not</td>
 488 </tr>
 489
 490 <tr>
 491 <td class="org-right">31</td>
 492 <td class="org-left">i</td>
 493 <td class="org-left">&#x2013; n</td>
 494 <td class="org-left">copies top of return stack into datastack</td>
 495 </tr>
 496
 497 <tr>
 498 <td class="org-right">32</td>
 499 <td class="org-left">cprt@</td>
 500 <td class="org-left">addr &#x2013; n</td>
 501 <td class="org-left">read one byte from hardware port</td>
 502 </tr>
 503
 504 <tr>
 505 <td class="org-right">33</td>
 506 <td class="org-left">cprt!</td>
 507 <td class="org-left">n addr --</td>
 508 <td class="org-left">store one byte to hardware port</td>
 509 </tr>
 510
 511 <tr>
 512 <td class="org-right">34</td>
 513 <td class="org-left">i2</td>
 514 <td class="org-left">&#x2013; n</td>
 515 <td class="org-left">like "i" but takes second top stack element</td>
 516 </tr>
 517
 518 <tr>
 519 <td class="org-right">35</td>
 520 <td class="org-left">i3</td>
 521 <td class="org-left">&#x2013; n</td>
 522 <td class="org-left">like "i" but takes third top stack element.</td>
 523 </tr>
 524
 525 <tr>
 526 <td class="org-right">36</td>
 527 <td class="org-left">shl</td>
 528 <td class="org-left">n amount &#x2013; n</td>
 529 <td class="org-left">left bit shift</td>
 530 </tr>
 531
 532 <tr>
 533 <td class="org-right">37</td>
 534 <td class="org-left">shr</td>
 535 <td class="org-left">n amount &#x2013; n</td>
 536 <td class="org-left">right bit shift</td>
 537 </tr>
 538
 539 <tr>
 540 <td class="org-right">38</td>
 541 <td class="org-left">or</td>
 542 <td class="org-left">n1 n2 &#x2013; n</td>
 543 <td class="org-left">logical or</td>
 544 </tr>
 545
 546 <tr>
 547 <td class="org-right">39</td>
 548 <td class="org-left">xor</td>
 549 <td class="org-left">n1 n2 &#x2013; n</td>
 550 <td class="org-left">exclusive logical or</td>
 551 </tr>
 552
 553 <tr>
 554 <td class="org-right">40</td>
 555 <td class="org-left">vidmap</td>
 556 <td class="org-left">addr --</td>
 557 <td class="org-left">copy memory from "addr" to video memory.</td>
 558 </tr>
 559
 560 <tr>
 561 <td class="org-right">41</td>
 562 <td class="org-left">mouse@</td>
 563 <td class="org-left">&#x2013; x y button</td>
 564 <td class="org-left">read mouse coordinates &amp; buttons</td>
 565 </tr>
 566
 567 <tr>
 568 <td class="org-right">42</td>
 569 <td class="org-left"><a href="#org944323a">vidput</a></td>
 570 <td class="org-left">addr1 addr2 x y --</td>
 571 <td class="org-left">put image1 into image2, at location x, y</td>
 572 </tr>
 573
 574 <tr>
 575 <td class="org-right">43</td>
 576 <td class="org-left"><a href="#org5b4d781">cmove</a></td>
 577 <td class="org-left">addr1 addr2 amount</td>
 578 <td class="org-left">move memory from addr1 to addr2</td>
 579 </tr>
 580
 581 <tr>
 582 <td class="org-right">44</td>
 583 <td class="org-left">cfill</td>
 584 <td class="org-left">c addr amount --</td>
 585 <td class="org-left">fill memory starting at "addr" with "c" bytes.</td>
 586 </tr>
 587
 588 <tr>
 589 <td class="org-right">45</td>
 590 <td class="org-left"><a href="#orgb1e3963">tvidput</a></td>
 591 <td class="org-left">addr1 addr2 x y --</td>
 592 <td class="org-left">put image with transparency support</td>
 593 </tr>
 594
 595 <tr>
 596 <td class="org-right">46</td>
 597 <td class="org-left">depth</td>
 598 <td class="org-left">&#x2013; depth</td>
 599 <td class="org-left">returns current depth of data stack.</td>
 600 </tr>
 601
 602 <tr>
 603 <td class="org-right">47</td>
 604 <td class="org-left"><a href="#orgac6e38a">charput</a></td>
 605 <td class="org-left">colorfg colorbg addrsrc addrdest x y</td>
 606 <td class="org-left">draw text character</td>
 607 </tr>
 608 </tbody>
 609 </table>
 610 </div>
 611
 612 <div id="outline-container-orgad315b0" class="outline-3">
 613 <h3 id="orgad315b0"><span class="section-number-3">1.1.</span> kbd@ - read scancode of pressed or released key</h3>
 614 <div class="outline-text-3" id="text-1-1">
 615 <p>
 616 Returns 0 if no data available.
 617 </p>
 618 </div>
 619 </div>
 620 <div id="outline-container-org944323a" class="outline-3">
 621 <h3 id="org944323a"><span class="section-number-3">1.2.</span> vidput - put image1 into image2, at location x, y</h3>
 622 <div class="outline-text-3" id="text-1-2">
 623 <p>
 624 Does clipping, so part of a big image can be mapped into smaller one.
 625 </p>
 626 </div>
 627 </div>
 628 <div id="outline-container-org5b4d781" class="outline-3">
 629 <h3 id="org5b4d781"><span class="section-number-3">1.3.</span> cmove - copy memory array</h3>
 630 <div class="outline-text-3" id="text-1-3">
 631 <p>
 632 Move memory from addr1 to addr2. If addr1 is greater than addr2 then
 633 count address foward while moving, elseway starts from end and counts
 634 backwards, so no data loss occurs when memory regions partially
 635 overlap.
 636 </p>
 637 </div>
 638 </div>
 639 <div id="outline-container-orgb1e3963" class="outline-3">
 640 <h3 id="orgb1e3963"><span class="section-number-3">1.4.</span> tvidput - put image with transparency support</h3>
 641 <div class="outline-text-3" id="text-1-4">
 642 <p>
 643 Stack footprint
 644 </p>
 645 <pre class="example">
 646 addr1 addr2 x y --
 647 </pre>
 648
 649
 650 <p>
 651 Put image1 into image2, at location x, y with transparency support
 652 </p>
 653
 654 <p>
 655 Color 255 in source image is treated as transparent.
 656 </p>
 657 </div>
 658 </div>
 659 <div id="outline-container-orgac6e38a" class="outline-3">
 660 <h3 id="orgac6e38a"><span class="section-number-3">1.5.</span> charput - draw text character</h3>
 661 <div class="outline-text-3" id="text-1-5">
 662 <p>
 663 Draw character to image buffer located at "addrdest" to specified x &amp;
 664 y location. Decodes 8 bytes from source to bits, used to draw
 665 character.
 666 </p>
 667 </div>
 668 </div>
 669 </div>
 670 </div>
 671 <div id="postamble" class="status">
 672 <p class="author">Author: Svjatoslav Agejenko</p>
 673 <p class="date">Created: 2023-09-18 Mon 01:46</p>
 674 <p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
 675 </div>
 676 </body>
 677 </html>