home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / maths / progs / 3dmatrix / !3DMatrix / !Help < prev    next >
Encoding:
Text File  |  1993-04-14  |  9.3 KB  |  269 lines
  1.  
  2.                Help file for 3DMatrix
  3.                         by
  4.                © Atle Mjelde Bårdholt
  5.                        v1.13
  6.  
  7.        *****  **  **    **     ******  ******
  8.        **     **  **   ** **   **  **  **
  9.        ****   ******  **   **  *****   ****    *****
  10.          **   **  **  *******  ** **   **
  11.       *****   **  **  **   **  **  **  ******
  12.       
  13.        **    **    **     ******  ******
  14.        **    **   ** **   **  **  **
  15.        **    **  **   **  *****   ****
  16.        ** ** **  *******  ** **   **
  17.         **  **   **   **  **  **  ******
  18.  
  19.                 For the RISC family
  20.                  Acorn Archimedes
  21.                      & Axxxx
  22.  
  23. ####################################################################
  24.  
  25. GENERAL USE INFORMATION :
  26. =========================
  27. ____________________________________________________________________
  28.  
  29. At the time of writing you have 19 data files to choose
  30. from. The "3D" file is automaticly loaded at startup.
  31. In addition I have added access to 16 `user` files.
  32.  
  33. A `user` file is a file made by the user.
  34. With the correct format as stated in the manual
  35. and with the specified filename.
  36.  
  37. Press <SPACE> at any time, and the respective number +
  38. <RETURN> to load one of the available data files.
  39. It might take some time for the program to respond to the
  40. press on <SPACE>.
  41.  
  42. If you have the old ARM2 in your machine, then I would
  43. advice you to NOT select the "colour" option.
  44. A GCOL command takes 0.70 millisec on an ARM2.
  45.  
  46. The full-screen option can be selected after you have
  47. selected your first file. Press <F1>.
  48. To go back to the menu-screen press <F2>.
  49. Note that all loading can only be done from the menu-screen.
  50.  
  51. <F5> Starts music, <F6> Stops music.
  52.  
  53. Read the manual supplied in the doc directory for
  54. further instructions.
  55. ____________________________________________________________________
  56.  
  57. This program is made on an A310, RISC OS 3.10, 2Mb, ARM3.
  58. It has also been tested on the following machines :
  59. - A310  RISC OS 2    1Mb
  60. - A3000 RISC OS 2
  61. - A3000 RISC OS 2    2Mb
  62. - A4000 RISC OS 3.10 4Mb
  63. - A5000 RISC OS 3.00 2Mb ARM3
  64. - A5000 RISC OS 3.10 4Mb
  65.  
  66. It should work fine on any Archimedes with 1Mb of RAM.
  67.  
  68. ####################################################################
  69.  
  70. VERSIONS :
  71. ==========
  72. ____________________________________________________________________
  73.  
  74. v1.00   < 9-Jan-1993>
  75.         First official SHAREWARE release.
  76.         None known errors.
  77. v1.01   <20-Feb-1993>
  78.         Removed small error with FILE35/36
  79.         Added use of 3 screen banks - speed gain
  80.         Removed change in colour - speed gain
  81.         Added 3 new objects, thanks to Michel Grimminck
  82. v1.02   <22-Feb-1993>
  83.         Serious speed modification
  84.         Altered the FileType from 3D Data to 3D_Data
  85.         (Most editors don`t like splitted names)
  86. v1.03   <25-Feb-1993>
  87.         Added back optional colour                 
  88.         Included SWI veneer swiv.h
  89.         Removed kernel.h
  90.         Solved graphic window problem
  91.         Removed bbc.h and saved 2K of code
  92. v1.04   <26-Feb-1993>
  93.         Modified the graphics
  94.         Included Cache on/off for ARM3 users <O> & <P>
  95. v1.05   <27-Feb-1993>
  96.         Added screensave of 10 images <S>
  97.         Added hourglass instructions
  98. v1.06/7 < 2-Mar-1993>
  99.         Minor Graphics change
  100.         Added CLib v3.75 for RISC OS 2 users
  101. v1.08   < 3-Mar-1993>
  102.         Colour on/off option <C> & <V>
  103. v1.09   < 5-Mar-1993>
  104.         Added !Sprites22,!Sprites23 and sm!sprites
  105. v1.10   < 9-Mar-1993>
  106.         Added routine for x saved images
  107. v1.11   <13-Mar-1993>
  108.         Added file-scan routine for source
  109.         /* for protection against 5 known viruses: */
  110.         /* Archie, BBCEconet, Breakfast, Link & T2 */
  111.         and removed small bug with hourglass
  112. v1.12   < 6-Apr-1993>
  113.         Immediately colour on/off update
  114.         Improved matrix routines
  115.         Added free_space check for ADFS:0 & RamFS
  116.         If file not found, it returns to new input
  117.         Added two LEDs on the hourglass when saving screen
  118.         Removed the arrow options ( No interest )
  119.         Added full screen option <F1>
  120.         Added STracker for background music
  121. v1.13   < 9-Apr-1993>
  122.         Checks both FreeSpace for 112k (menu) & 161k (full) -screens
  123.         Minor bug fix in input routine
  124.         
  125. ####################################################################
  126.  
  127. CREDITS GOES TO :
  128. =================
  129. ____________________________________________________________________
  130.  
  131. Original Idea by Oscar Garcia - 3DV for IBM PC compatibles.
  132.  
  133. SKULLS   by Dr.Foss Leach
  134.          National Museum of New Zealand
  135. 3D       by Knut M.Møen KIH - Norway.
  136. GLASS    by Gershon Elber in GNUPLOT
  137. TREE1    by Dr.Daivid Whitehead
  138.          Forest Research Institute
  139. GALAXY   by Mark Dahmke
  140. CUBE(S)  by the Author
  141. ARC      by the Author
  142. TORNAD   by Michel Grimminck
  143. WGLASS   by Michel Grimminck
  144. PLANE    unknown author
  145.  
  146. Thanks to Edward Nevill and Jonathan Roach for the SWI veneer.
  147. Thanks to Trygve Røste for the systemf() function = (save x images).
  148. Thanks to F.Mercier,H.Fiennes & M.Farrow for the Tracker Player
  149. A special thanks goes to Michel Grimminck and Jason Williams for
  150. their search for bugs and useful help.
  151.  
  152. ####################################################################
  153.  
  154. TO DO :
  155. =======
  156. ____________________________________________________________________
  157.  
  158. - Make faster matrix manipulating functions.
  159. - Include some MORE assembler routines in the C source code.
  160. - Make a Wimp version.
  161. - Include mouse control.
  162. - Add perspective.
  163. - Make an object editor.
  164. - Include OS_SpriteOp 60 update in the menu-screen.
  165. - Add percentage to the hourglass when saving image.
  166. - Make a better check routine before saving an image.
  167.  
  168. ####################################################################
  169.  
  170. HOW TO REGISTER FOR UPGRADES :
  171. ==============================
  172. ____________________________________________________________________
  173.  
  174. If you find this program interesting and would like to
  175. receive the newest version available and any new data files,
  176. as they appear in the future. 
  177. Then send me £5 in cash (no cheques please!) to the
  178. address below.
  179.  
  180. /*-------------------------------------*/
  181.    Norwegians only :
  182.    Registrer deg ved å sette 50 N.kr
  183.    inn på postgirokonto : 0824 0112400
  184. /*-------------------------------------*/
  185.  
  186. The £5 pounds goes to : disc(s), postage(s), envelope(s) and
  187. developing the project further for You!. If I receive no money,
  188. I just can`t afford to use my programming time on it,
  189. sinze I am currently studying computer engineering. = (poor).
  190.  
  191. As an alternative upgrade, send me 5 + 1 disc`s for just the
  192. latest version. Or 10 disc`s for a full registration.
  193.  
  194. ####################################################################
  195.  
  196. PD & SHAREWARE LIBRARIES :
  197. ==========================
  198. ____________________________________________________________________
  199.  
  200. Any PD/SHAREWARE libraries that would like to distribute this
  201. program should contact me for discussing terms.
  202. --------------------------------------------------------------
  203. These libraries are allowed to distribute my program (Mar.93):
  204. --------------------------------------------------------------
  205.  * ARCHIVE Shareware Disc by Norwich Computer Services
  206.  * THE DATAFILE Public Domain & Shareware Library
  207.  * SYRACUSE Disc Magazine
  208.  * The ARM Club PD/Shareware library
  209.  
  210. ####################################################################
  211.  
  212. MY ADDRESS :
  213. ============
  214. ____________________________________________________________________
  215.  
  216.    Ref: Matrix                     ( å = ALT 229 or use aa )
  217.  
  218. Atle Mjelde Bårdholt
  219. Schlanbuschvei 8
  220. N-3600 Kongsberg
  221. Norway
  222.  
  223. e-mail :   atle.baardholt@kih.no
  224.  
  225. Please report any found bugs.
  226.  
  227. ####################################################################
  228.  
  229. ########
  230. # NOTE #
  231. ########
  232. ____________________________________________________________________
  233.  
  234. You may NOT change this *application* or use ANY part
  235. of it in other products without my approval.
  236. You may spread it freely (with *ALL* files included),
  237. but not for any profit. This software is provided 'as is'.
  238. Using it is entirely at your own risk.
  239. ____________________________________________________________________
  240.  
  241. Files under this *application* :
  242.  
  243.                  !Boot          <- This file can be renamed to Boot
  244.                                    if not wanted.
  245.                  !Run
  246.                  !Sprites
  247.                  !Sprites22
  248.                  !Sprites23
  249.                  !RunImage      <- The file-scan routine
  250.                  Source         <- The main program
  251.                  !Help          <- This file
  252.                  Data.          <- 19 Data files
  253.                  Doc.Fig_1      <- Draw file
  254.                  Doc.Fig_2      <- Draw file
  255.                  Doc.Keys       <- Draw file
  256.                  Doc.Errors     <- Text file with known errors
  257.                  Doc.Manual     <- Text Manual
  258.                  Doc.!Manual    <- Impression document
  259.                  Resources      <- CLib & FPEmulator for RO2 users
  260.                                    MemAlloc for bankswitching
  261.                                    STracker & STModule
  262.                                    ModKill - ||Extra Basic file||
  263.                  Images.        <- Directory for saved screens
  264. ____________________________________________________________________
  265.  
  266. ACORN, ARCHIMEDES are trademarks of Acorn Computers Ltd.
  267. IMPRESSION is trademark of Computer Concepts Ltd.
  268. ModKill is supplied as FREEWARE © Steven Kramer kramer@phys.uva.nl
  269. -It scans your system & kills the `module` virus-