home *** CD-ROM | disk | FTP | other *** search
/ The Net: Ultimate Internet Guide / WWLCD1.ISO / pc / java / enzykbad / docsrc / programming.htxr < prev   
Encoding:
Text File  |  1996-08-14  |  3.7 KB  |  93 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>
  4. Programming
  5. </TITLE>
  6. <xinclude file="head.xrh">
  7. </HEAD>
  8.  
  9. <xinclude file=body.xrh>
  10. <xtop>
  11. <h1>
  12. <xnode name="program" sub="drawboard">
  13. Programming
  14. </xnode>
  15. </h1>
  16. The program CopyCat is relatively small -- under 2000 lines of code; the class 
  17. files are under 40K.  This makes it an attractive program for the net.  
  18. Its small size is due to the concise language of mathematics.
  19. Another reason is that java is also a very concise language.
  20. <hr>
  21. <h2>The program</h2>
  22. (For the following to make sense, it is important to be familiar with 
  23. <em>CopyCat</em>)
  24.  
  25. <p><em>CopyCat</em> is made up of many components: PlayArea, BoardBox, 
  26. Rotator, and Title.  
  27. PlayArea (<a href="java/PlayArea.java">PlayArea.java</a>)
  28. is the component where all the action 
  29. occurs.  It has a complex interface to handle all the players' manipulations
  30. of the solid object.  PlayArea reports back to CopyCat 
  31. (<a href="java/CopyCat.java">CopyCat.java</a>) whenever the player does
  32. something significant.
  33.  
  34. <p>BoardBox (<a href="java/BoardBox.java">BoardBox.java</a>)
  35. is the part that shows the static original picture that the player must
  36. copy (I call it a board)--not much to it.
  37.  
  38. <p>Rotator (<a href="java/Rotator.java">Rotator.java</a>)
  39. has the solid object rotating and bouncing in a non-repeating way.  There
  40. is also a user interface where the player can grab the object and rotate
  41. it manually, but as soon as the player lets go, it returns to tumbling.
  42.  
  43. <p>Title (<a href="java/Title.java">Title.java</a>)
  44. is a trival component that simply puts centred text in a box.  It is used
  45. for the title and the score. 
  46.  
  47. <p>PlayArea and BoardBox rely on the object Board
  48. (<a href="java/Board.java">Board.java</a>).
  49. Board holds all the information of the board and has a few methods that 
  50. relate to the board -- drawing the board, clearing the board, and counting
  51. the correct matches on the board.
  52.  
  53. <p>PlayArea,Rotator and Board rely on the object Solid
  54. (<a href="java/Solid.java">Solid.java</a>).
  55. Solid holds all the 3D information relating to the solid object and has
  56. a few methods as well.
  57.  
  58. <p>PlayArea and Board rely on the object GroupGraph
  59. (<a href="java/GroupGraph.java">GroupGraph.java</a>).
  60. GroupGraph holds all the preferred orientation of the solid, how to get from
  61. one oriention to another, and the symmetries of the faces the of solid.
  62.  
  63. <p>PlayArea, Rotator and Solid use the object Omatrix
  64. (<a href="java/Omatrix.java">Omatrix.java</a>), the orthogonal/orientation
  65. matrices.
  66. Omatrix holds a matrix and has many matrix methods.
  67.  
  68. <hr>
  69. <h2>The config files</h2>
  70. <p>One of the most flexible parts to CopyCat is that it has very little
  71. hardwiring; all of the changeable information is read in with files:
  72. which object that is used, which group graph that is used, the screen
  73. setup, and the board.  This saves oodles of time compiling, and will eventually
  74. lead to user interface where the user will run some application that 
  75. produces these config files.  A half measure that is implemented right now
  76. is that the board status can be retrieved from the System.out--this is a hidden
  77. feature so that non-techies won't get too excited.
  78.  
  79. <h3>the files</h3>
  80. <ul><li>the solid files
  81.     <ul><li><a href="java/cube.dat">cube.dat</a> describes the cube
  82.         <li><a href="java/octa.dat">octa.dat</a> describes the octahedron</ul>
  83.     <ul><li><a href="java/cubeG.dat">cubeG.dat</a> describes the cube preferred orientations
  84.         <li><a href="java/octaG.dat">octaG.dat</a> describes the octahedron 
  85. preferred orientations</ul>
  86.     <ul><li><a href="java/cube1.config">cube1.config</a> describes a board that uses the cube as its object
  87.         <li><a href="java/octa1.config">octa1.config</a> describes a board that uses the octahedon as its object
  88.         <li>this list is long...</ul>
  89. </ul>
  90. <xbot>
  91. </BODY>
  92. </HTML>
  93.