tunnel.html 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384
  1. <html>
  2. <head>
  3. <title>Tunnel</title>
  4. </head>
  5. <body bgcolor="FFFFFF">
  6. <h1><img align="center" src="../../../../en/icons/tunnel.gif" width="32" height="32">
  7. <em>Tunnel</em></h1>
  8. <p><table>
  9. <tr><td><strong>Library:</strong></td>
  10. <td><a href="index.html">Wiring</a></td></tr>
  11. <tr><td><strong>Introduced:</strong></td>
  12. <td>2.5.0 (in Base library, moved to Wiring in 2.7.0)</td></tr>
  13. <tr><td valign="top"><strong>Appearance:</strong></td>
  14. <td valign="top"><img src="../../../../en/img-libs/tunnel.png" width="220" height="90"></td></tr>
  15. </table></p>
  16. <h2>Behavior</h2>
  17. <p>A <q>tunnel</q> acts like a wire in that it binds points together,
  18. but unlike a wire the connection is not explicitly drawn.
  19. This is helpful when you need to connect points far apart in the circuit
  20. and a network of wires would make the circuit much more ugly.
  21. The below illustration illustrates how this works.</p>
  22. <blockquote><img src="../../../../en/img-libs/tunnel-demo.png" width="204" height="86"></blockquote>
  23. <p>Here, all three tunnels have the same label, <em>a</em>, and so
  24. the three points to which the tunnels point are connected.
  25. (If one of the tunnels were labeled something else, like <em>b</em>,
  26. then it would be part of a different set of tunnels.)
  27. The controlled buffer at top emits a floating output
  28. since its lower input is 0.
  29. This normally leads the wire coming from the controlled buffer to be blue;
  30. but here it is dark green because the floating output combines
  31. through the tunnel with the 0 from the pin at bottom.
  32. If the control input into the buffer changes to 1,
  33. then the controlled buffer would feed 1 into the tunnel,
  34. which would combine with 0 from the pin at bottom to result in an error value; thus, we would then see red wires feeding through all three tunnels.</p>
  35. <h2>Pins</h2>
  36. <p>A tunnel has only one pin, whose bit width matches the tunnel's
  37. Data Bits attribute. This pin is neither an input nor an output &mdash;
  38. the matching tunnels are simply connected transparently.</p>
  39. <h2>Attributes</h2>
  40. <p>When the component is selected or being added,
  41. Alt-0 through Alt-9 alter its <q>Data Bits</q> attribute
  42. and the arrow keys alter its <q>Facing</q> attribute.</p>
  43. <dl>
  44. <dt>Facing</dt>
  45. <dd>The direction toward which the tunnel points.</dd>
  46. <dt>Data Bits</dt>
  47. <dd>The number of bits for the tunnel.</dd>
  48. <dt>Label</dt>
  49. <dd>The text within the label associated with the tunnel.
  50. This tunnel is connected to all other tunnels with exactly the same label.</dd>
  51. <dt>Label Font</dt>
  52. <dd>The font with which to render the label.</dd>
  53. </dl>
  54. <h2>Poke Tool Behavior</h2>
  55. <p>None.</p>
  56. <h2>Text Tool Behavior</h2>
  57. <p>Allows the label associated with the tunnel to be edited.</p>
  58. <p><a href="../index.html">Back to <em>Library Reference</em></a></p>
  59. </body>
  60. </html>