home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 500-599 / ff590.lza / Crystals / Crystals.doc < prev    next >
Text File  |  1992-01-05  |  14KB  |  268 lines
  1.  
  2.                          Crystal_Lattices
  3.                            Version 2.15
  4.  
  5.                     Stereoscopic Educational Software
  6.                            for the Amiga
  7.  
  8.                         Software and Manual
  9.                        by David M. McKinstry
  10.                         Copyright 1987-1991
  11.  
  12.  
  13.                  User Instructions for Crystal_Lattices
  14.  
  15.      Crystal_Lattices is a computer simulation of three-dimensional
  16. crystal lattices written for the Amiga.  The simulations permit you to
  17. observe stereoscopic views of any of the fourteen Bravais lattices with
  18. a variety of orientaions.  You will be able to accomplish changes in
  19. orientation with either a joystick in the second mouse port, or by using
  20. the cursor keys to emulate a joystick.  Furthermore, you will be able to
  21. move the image away from you (further behind the screen) and toward you
  22. (so that if comes on your side of the screen).  It is hoped that this
  23. flexibility will enable you to find a comfortable viewing position for
  24. any lattice you are studying.  Also, once the program is executing you
  25. may wish to adjust the intensity and contrast of your monitor to give
  26. you the most comfortable viewing for the images produced.
  27.  
  28.      Since the simulations are done using two-color stereoscopic
  29. techniques, the 3-D glasses are relatively inexpensive.  The glasses
  30. simply consist of a red filter for your left eye and a green (or blue)
  31. filter for your right eye.  Both have been used successfully.  Although
  32. the colors used were chosen for a green filter on the right eye, a light
  33. blue or blue-green filter works just as well.  Even if you are missing
  34. one eye, or for some other reason do not have binocular vision, you can
  35. still use these simulations.  Simply place either color filter (the one
  36. with which you can see best), over your good eye, and block off vision
  37. to your weaker eye.  The ability to rotate and move the images will
  38. still give a good illusion of depth.  In general, it is recommended
  39. that you keep the images in motion prevent confusion that might result
  40. if the images are stationary.
  41.  
  42.      As already mentioned, a joystick is a desirable (but non-essential)
  43. option.  If you have a joystick, please plug it into your second mouse
  44. port before turning on your Amiga.  A very desirable option is sound,
  45. since there is a fair amount of narration that is provided.  Although
  46. duplication of much of the narration will be printed on the screen as
  47. it proceeds, it is easier to listen while watching other things (mouse
  48. movement, menus, graphics, etc.) than to be reading and miss something.
  49. If you don't have your speaker hooked up, please do so before turning
  50. on your computer.  If you don't have a speaker, you will probably have
  51. to go through the tutorial on the use of the Amiga with this program
  52. several times.  It is assumed that you already know enough about the
  53. Amiga to have it properly turned on and set up for your particular use.
  54. However, further special considerations and assumptions follow:
  55.  
  56.      It is assumed that your Amiga has at least 1 Meg of RAM.  It may
  57. be possible to run this software with only 512 K of RAM, if nothing
  58. else is running, and you have not added buffers for your floppy drives.
  59. However, that is probably pushing it too much.  It is also assumed that
  60. you have all the libraries, devices, and fonts associated with version
  61. 1.3 or 2.0 of the Amiga operating system (i.e. AmigaDOS and related
  62. workbench with KickStart or ROM Kernel 1.2 or later).  Crystal_Lattices
  63. will operate as intended with KickStart 1.2 or later and Workbench 1.3
  64. or later.  Crystal_Lattices will also determine whether your Amiga is
  65. running with NTSC or PAL and act accordingly.  That is, different
  66. aspect ratios are provided for the graphics when you have booted with
  67. PAL mode than with NTSC mode.  Specifically needed in your operating
  68. system are the following items that come on the release workbench disk
  69. for 1.3 or 2.0.
  70.  
  71.      In the fonts director of your system disk you should have:
  72.  
  73.        diamond.font and within the subdirectory diamond, 12 and 20.
  74.        ruby.font and within the subdirectory ruby, 15.
  75.  
  76.      All of these fonts are present with the standard release workbench.
  77. However, note that the fonts drawer on your workbench boot disk for 2.0
  78. is empty as it comes, and will have to have the above fonts copied to
  79. it if you are booting from a floppy drive.  In your libs directory, you
  80. must have the translator library and the diskfont library.  These are
  81. needed for the narration and fonts.  In your devs: directory you need
  82. the narrator.device.  As already stated, all these exist on the standard
  83. release system disks.
  84.  
  85.      If you have two floppy drives just place the Crystal_Lattices disk
  86. in your second floppy drive, and boot with your standard workbench disk.
  87. The executable file is in the root directory of the Crystal_Lattices disk
  88. and may be accessed from CLI, or the workbench.   If you prefer to type
  89. in commands just type in and enter the following:
  90.  
  91.                            df1:Crystal_Lattices
  92.  
  93.      If you wish to place this program somewhere other than in df1: you
  94. will have to include the appropriate path.  Hard disk users may wish to
  95. copy it and its icon to their hard disk.  It's easiest to do this  by
  96. dragging the icon from the floppy disk to the drawer into which you wish
  97. to place it on the hard disk.    Many people prefer to use the workbench.
  98. If you do, just double click on the disk icon to open its window, and
  99. double click on the pair of 3-D glasses to start the program.  The program
  100. will start in the usual manner, display a title page and request you to
  101. press S or C to set or clear the Sound Option.  Do so to continue into the
  102. program.  A page telling what menu options are available will then be
  103. displayed.   It is strongly suggested that you follow through the tutorial
  104. on the use of the the Amiga mouse and keyboard as it relates to this
  105. program.  Just use right Amiga - G to start this tutorial.  Once the
  106. tutorial has started, do not touch the keyboard or mouse, until it's
  107. done.  The same applies to the other tutorials under the Information menu.
  108. These tutorials will tell also tell you how to turn off the Sound option.
  109. Note that General takes about 6.5 minutes to complete, Options takes about
  110. three minutes, and Animations takes about 5 minutes.  Don't attempt to
  111. run other user-involved programs at the same time, or you may conflict
  112. with the tutorials.  By that, I mean that you could run a print job or
  113. compile as a background task, the tutorials are running, but don't do
  114. anything that requires use of the keyboard or mouse.  Doing so could lock
  115. up the mouse, and require a reboot.
  116.  
  117.                            Single Drive Users
  118.  
  119.      If you happen to have only a single floppy drive and no hard disk
  120. (perish the thought), you have several options.  Just two of them are:
  121.  
  122.           1.  Copy the program Crystal_Lattices and its icon to a
  123.           working bootable Workbench disk, or
  124.           2.  Boot with your normal 1.3 or 2.0 Workbench disk,
  125.           and once complete, remove the workbench disk to insert the
  126.           Crystal_Lattices disk to execute Crystal_Lattices.
  127.  
  128.      Start up the program by double clicking on its icon, and pay
  129. attention to the requestors.   After loading the program, the workbench
  130. disk will have to be placed back in the drive so its devices and libraries
  131. can be accessed.
  132.                            Cautionary Notes
  133.  
  134.      The tutorials take over control of the mouse.  Don't attempt to use
  135. the mouse while a tutorial is running, or the program may 'lock up' with
  136. the result that you will have to reboot your system.  If you get into a
  137. tutorial accidentally, or for some other reason wish to abort that tutorial,
  138. just press the  'Esc' key.  This will break you out of a tutorial or out
  139. of any animation sequence to take you back to the Menu Options page.  Note
  140. that all selections must be made from the Menu Options page, with the
  141. exeception of the Sound option which can be toggled on or off when a
  142. tutorial is being provided.
  143.  
  144.                            Everyone
  145.  
  146.      Be certain to pay careful attention to the tutorials provided within
  147. the program.  This is especially true if you are new to the Amiga.  However,
  148. even if you are an expert, you will need to study the 'Options' and
  149. 'Animations' items in the 'Information' Menu.
  150.  
  151.                            Command Key Summary
  152.  
  153.      Note that the following summary can be obtained by using the Help key
  154. from the Menu Options page.
  155.  
  156.                Key(s)        Function
  157.  
  158.                Help          Command Key Summary
  159.                Esc           Back to Menu Options Page
  160.                Cursor Keys   Simulate Direction of Joystick
  161.                A             Moves Lattice Away from You
  162.                R             Returns Lattice toward You
  163.  
  164.  
  165.      If you don't like to use the mouse, or are having difficulty with your
  166. mouse, you may use 'hot key' combinations of keys to make your menu choices.
  167.  
  168. These are accomplished by pressing down the Right Amiga key (i.e. the key
  169. just below the lower-left of the right shift key), and then simultaneously
  170. pressing the key listed after it.  The commands used in this program are
  171. as follows:
  172.  
  173.  
  174.  
  175.           The following are under the Options Menu:
  176.  
  177.                Right-Amiga-S           Sound
  178.                Right-Amiga-N           Non-Primitive Cell
  179.                Right-Amiga-P           Primitive Cell
  180.                Right-Amiga-V           Translation Vectors
  181.  
  182. The above four choices toggle the corresponding option to its opposite
  183. state.  For example, if the sound option is on it will be turned off at
  184. the completion of any current narration.  The sound option can be toggled
  185. from within a tutorial, so that you can speed up the reading of
  186. instructions.  Any of the above four options should be chosen before
  187. beginning an animation, since they will determine the nature of the
  188. images produced, or whether a narrative will be provided in the case of
  189. the sound option.
  190.  
  191.                Right-Amiga-Q           Quit the program
  192.  
  193. Of course, the meaning of this is obvious.  It is also possible to
  194. terminate the program by clicking the left-mouse button on the
  195. 'Close-Window gadget' at the upper-left corner of the Menu Options page,
  196. as well as by using the pull-down menu for Quit.  When an option is active,
  197. a check mark will appear beside it in the menu.
  198.  
  199.           The following are under the Information Menu:
  200.  
  201.                Right-Amiga-G           Begin the General Tutorial
  202.                Right-Amiga-O           Begin the Options Tutorial
  203.                Right-Amiga-A           Begin the Animation Tutorial
  204.                Right-Amiga-C           Display Chip and System Information
  205.  
  206.           The following are under the Animation Menu:
  207.  
  208.                Right-Amiga-T           Triclinic Lattice
  209.                Right-Amiga-1           Monoclinic Primitive Lattice
  210.                Right-Amiga-2           Monoclinic Body-Centered Lattice
  211.                Right-Amiga-3           Orthorhombic Primitive Lattice
  212.                Right-Amiga-4           Orthorhombic C-Centered Lattice
  213.                Right-Amiga-5           Orthorhombic Face-Centered Lattice
  214.                Right-Amiga-6           Orthorhombic Body-Centered Lattice
  215.                Right-Amiga-7           Tetragonal Primitve Lattice
  216.                Right-Amiga-8           Tetragonal Body-Centered Lattice
  217.                Right-Amiga-E           Simple Cubic Lattice
  218.                Right-Amiga-B           Body-Centered Cubic Lattice
  219.                Right-Amiga-F           Face-Centered Cubic Lattice
  220.                Right-Amiga-R           Rhombohedral Lattice
  221.                Right-Amiga-H           Hexagonal Close-Packed Lattice
  222.  
  223.  
  224.      This software should work in any multi-tasking situation, with the
  225. exceptions already mentioned..  However, if you are running any other
  226. software that uses the joystick, note that this program reads the hardware
  227. registers for the joystick and keyboard directly when within an animation
  228. sequence.  This is done to be certain that the Esc key is aways recognized,
  229. and provides faster response when reading the cursor keys to simulate the
  230. joystick.  Thus, if an animation is running in this program while another
  231. program uses the joystick, it is assumed that the lattices are to be
  232. rotated.  Likewise, if you were to press the escape key on another window
  233. or screen, it would be recognized and take you back to the Menu Options
  234. page.  Obviously, running other tasks in the background will slow down
  235. the animations.
  236.  
  237.      Note that the two custom screens used for the animations are linked
  238. together so it is possible to drag them up and down (and if operating
  239. under AmigaDOS 2.0 with horizontal overscan, horizontally as well).  This
  240. would make it possible to look at a rotating lattice, while observing
  241. the Workbench Screen in the background.
  242.  
  243.        Bugs.  None known.  (They're all features.)  However, note the
  244.        cautions already listed.  Also note that under the Chip and
  245.        System Information Menu, the screen will flash when CPU speed is
  246.        being determined.  This is because all DMA is turned off during
  247.        the short test sequence(less than 0.1 seconds).  Also note that,
  248.        if you're fortunate enough to have a 68040 in your Amiga, the
  249.        timing will not be true but will instead give you the clock rate
  250.        at which a 68020 or 68030 would have to be running, to complete
  251.        the test loop.
  252.  
  253.       I hope that you will all enjoy and learn from this program.  Please
  254. send any comments, bug reports  and constructive criticisms to me at the
  255. following address.
  256.  
  257.                              David M. McKinstry
  258.                              Physics Department
  259.                              MS #68
  260.                              Eastern Washington University
  261.                              Cheney, Washington  99004
  262.                              Phone (509) 359-6958
  263.                        or    DIMMCK on Bix,
  264.                        or    DMCKINSTRY@EWUVMS on BitNet.
  265.  
  266.  
  267.       Note that I do not log onto BitNet nearly as often as I log onto Bix.
  268.