home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / gfx / 3d / earth / readme < prev    next >
Encoding:
Text File  |  1994-05-30  |  4.7 KB  |  134 lines

  1. *****************************************************************************
  2. *                                                                           *
  3. *                    PUBLIC DOMAIN SOFTWARE LICENSE                         *
  4. *                                                                           *
  5. * The following program(s) and/or data file(s) are declared Public Domain.  *
  6. *                                                                           *
  7. * Provided the end user sticks to the following author's wishes, he or she  *
  8. * is authorized to use, copy, analyze and improve the items.                *
  9. *                                                                           *
  10. * Conditions of use:                                                        *
  11. * ------------------                                                        *
  12. *                                                                           *
  13. * 1) No part of this distribution will be omitted (incl. this README file)  *
  14. * 2) None of the Copyright texts will be modified.                          *
  15. * 3) None of the files should be stored and/or converted onto environment-  *
  16. *    ally damaging media. (paper listings, faxes, etc...)                   *
  17. *                                                                           *
  18. *                                                                           *
  19. * The Author,                                                               *
  20. *                                                                           *
  21. * Laurence Vanhelsuwé                                                       *
  22. *                                                                           *
  23. * Auroville 27/MAY/94                                                       *
  24. *                                                                           *
  25. *                                                                           *
  26. *****************************************************************************
  27.  
  28. Program Title(s): Earth, Globe.C                       (C) L. Vanhelsuwé 1994
  29.  
  30. Author:           Laurence Vanhelsuwé
  31.  
  32.  
  33. 0. Short description:
  34.    ------------------
  35.  
  36.    Earth    :  This program shows a real-time rotating Earth.
  37.                You can rotate and zoom in or out with at least one joystick
  38.                plugged in (2 are needed for full control).
  39.  
  40.                The small executable gets its data from the file "3D.Globe"
  41.  
  42.    Globe.C:    This is the C source to the program which converted a 2-D image
  43.                of the world into a 3-D image-wrapped-on-a-sphere.
  44.  
  45.    EarthMap.IFF: Source picture to create the 3-D data using GLOBE.
  46.  
  47.  
  48. 1. Requirements/Installation:
  49.    --------------------------
  50.  
  51.    To see the animation you need the data file '3D.Globe' in the current
  52.    directory when Earth is run.
  53.  
  54.    Globe.c and EarthMap.IFF are not needed.
  55.  
  56.  
  57. 2. How to use it:
  58.    --------------
  59.  
  60.    Simply install the program as outlined above.
  61.  
  62.    Joystick #1 controls Y-rotation and ZOOM.
  63.    Joystick #2 controls X- and Z-rotation.
  64.  
  65.    Press FIRE BUTTON #1 to quit !!
  66.  
  67.    (Note that if, as usual, a mouse is plugged into port #1, then the program
  68.    will interpret mouse moves as joystick changes...).
  69.  
  70.  
  71. 3. Internals:
  72.    ----------
  73.  
  74.    Although the filename of the datafile is hard-coded to be '3D.Globe', the
  75.    contents of that file could easily be replaced by another 3-D model.
  76.  
  77.    The format of the data file is ultra simple:
  78.  
  79.    WORD 0    :  number of (x,y,z) triplets in this model.
  80.  
  81.    WORD 1    :  X coordinate of point 0
  82.    WORD 2    :  Y coordinate of point 0
  83.    WORD 3    :  Z coordinate of point 0
  84.  
  85.    WORD 4    :  X coordinate of point 1
  86.    WORD 5    :  Y coordinate of point 1
  87.    WORD 6    :  Z coordinate of point 1
  88.  
  89.      :
  90.      :
  91.  
  92.    WORD 3*n  :  X coordinate of point n
  93.    WORD 3*n+1:  Y coordinate of point n
  94.    WORD 3*n+2:  Z coordinate of point n
  95.  
  96.    That's right: the model is just a collection of unrelated points in space.
  97.    A cloud of points !
  98.  
  99.    Since this kind of representation is much faster to render than polygon-
  100.    (triangles in reality !)- based models, one can get quite stunning animations
  101.    out of this renderer.
  102.  
  103.  
  104. 4. Limitations/Warnings:
  105.    ---------------------
  106.  
  107.    No user-interface.
  108.    No command line options.
  109.  
  110. **!! CRASH !!**
  111.  
  112.    Don't ZOOM the model in such that any model edges go off-screen... the pixel
  113.    plotter doesn't clip and will scribble all over memory !!
  114.  
  115. 5. History:
  116.    --------
  117.  
  118.    Very long. Started in 1987 when I did a wireframe animation of the Space Shuttle.
  119.    This code is a recent re-incarnation.
  120.  
  121. 6. Future:
  122.    -------
  123.  
  124.    Dependent on user's feedback.
  125.  
  126.  
  127. 7. Credits:
  128.    --------
  129.  
  130.    Laurence Vanhelsuwé
  131.    Christinastraat 105
  132.    B-8400 Oostende
  133.    Belgium
  134.