home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Utility Spectacular / Developer / Venus / Readme < prev    next >
Encoding:
Text File  |  1994-07-26  |  2.9 KB  |  59 lines  |  [TEXT/ttxt]
  1. What:    "virtual" flying through the clouds
  2. Hot points:
  3.     - simple virtual reality "thing"
  4.     - with the source
  5.     - very detailed explanation as to how to generate clouds and
  6.       render maps in 3D.
  7.     - includes the source for a small class library to handle color
  8.       Mac windows and draw images in off-screen GrafWorlds
  9. Contents:
  10.     Readme            - this file
  11.     Venus                - Application itself
  12.     Venus.pi      - project and resource files to build it
  13.     Venus.pi.rsrc        - 'clut' resource
  14.     FractalMap.cc    - generate a fractal map (clouds)
  15.     project_3D.cc    - display a 3D moving projection of the map of clouds
  16.     display.cc                - display an image in a Mac window
  17.     window.h                         \ my own private very simple MacApp: classlib for
  18.     SimpleWindow.cc / handling color Mac windows and offscreen GrafWorlds
  19.     The source code contains (too) many comments to show what
  20.     a particular piece of code does, as well as some tricks involved
  21. Language: Symantec C++ 7.0.3 (previous versions might work, too)
  22. System: System 7.x; tested on IIci, Quadras and Centres.
  23. Note: the source code uses a "standard" environment, see myenv-notify.cpt,
  24.       which can be found at various archive sites under the name
  25.       'myenv-notify'. The source also uses graylib class library to
  26.       handle images, recently posted on comp.source.misc. However,
  27.       the library is not *very* used;  one can easily get around without
  28.       it with only small modification of the code.
  29. Comments-to: oleg@ponder.csci.unt.edu, oleg@unt.edu
  30. Many-Thanks-To: Tim Clarke, tjc1005@hermes.cam.ac.uk (for inspiration)
  31.  
  32. Explanation:
  33.  
  34.     Just fire it up, sit back and enjoy. Hope you'll get some
  35. feeling that you're hovering over or flying through the clouds. If you
  36. quit the program and start it over again, you'll get different clouds
  37. (which might be much better and more interesting to fly around).
  38.  
  39.     If you want to take on a more active role, hold the mouse
  40. button down and move the mouse. Then your flight is in your own hand
  41. (which holds the mouse). You have to keep the mouse button down all
  42. the time you want to control the situation: when mouse button is up,
  43. the system flies by itself. You can also use the keyboard: arrows
  44. left/right/up/down move you around, PgUp/PgDn changes your altitude
  45. (or height of the horizon if pressed with "Option"); all other keys
  46. quietly kill the program (you can also quit by clicking the close box
  47. of the window).
  48.  
  49.     This program is inspired by MARS.EXE  and its description
  50. posted in rec.games.programmer. There, the author of Mars, Tim Clarke,
  51. explained its guts, though he didn't give detailed equations and there
  52. were a few typos in his post. Source file project_3D.cc  in the
  53. present submission contains the fullest description (I could come up
  54. with) of the 3D rendering technique: with background, equations,
  55. pseudocode and the actual code (and tricks with the fixed-point
  56. arithmetics: hey, no floating-point numbers are in here).
  57.  
  58.     If you need further information or details, mail me.
  59.