home *** CD-ROM | disk | FTP | other *** search
/ CD Action 54 / cdactioncoverdisc54.iso / tools / stars.exe / stars.txt < prev   
Text File  |  2000-09-01  |  13KB  |  303 lines
  1.  
  2. Open-GL Stars 0.5.0.0500
  3. ___________________________________________________________________________
  4. Tomasz Porosinski                                               ReadMe File
  5.  
  6.  
  7. Open-GL Stars is a benchmark/demo program I've written to test my Open-GL
  8. and Win32 programming skills. It was meant to be a small project to test
  9. some nice Open-GL features but developed into a fully featured application.
  10. This program was created over the time period of about 2 months and its
  11. status is freeware - have fun and enjoy! 
  12.  
  13. ___________________________________________________________________________
  14. 1. MAIN FEATURES
  15.  
  16. - easy to use BeOS-like user interface 
  17. - fully customizable screen resolution and bit depth
  18. - full-screen or window rendering
  19. - adjustable texture filtering mode: bilinear/bilinear+mipmaps/trilinear
  20. - adjustable gamma setting
  21. - MAPI support 
  22. - many different parameters to play with (press "h" to see on-screen help)
  23. - all parameters are accessible through easy to use menu and stored in one
  24.   .ini file
  25. - many statistics (frames per second, polygons per second, polygons per
  26.   frame...)
  27. - benchmark mode (2000 frames, animation updated by frame - you will see
  28.   identical frames regardless to your machine performance, only time of
  29.   the benchmark pass will vary - just like in Quake 3 timedemo)
  30. - nice Open-GL effects (like lens flare and some nice particles)
  31. - screenshot feature (using Targa file format) - just press "s"
  32. - detailed report of program run and benchmark results are displayed in two
  33.   separate windows
  34.  
  35. If you want to return to default settings - just delete "stars.ini" file
  36. which is located in the main program directory.
  37.  
  38. ___________________________________________________________________________
  39. 2. THINGS YOU NEED TO KNOW BEFORE YOU BEGIN...
  40.  
  41. This 'Software' is free. You can distribute it to anyone as long as it is
  42. given for free and unmodified. However, I do ask you to register it
  43. because I would like to know how far it spreads. Registration is simple
  44. - send an e-mail to the following address: stars@stars.benchmark.pl.
  45.  
  46. Please use it for personal purposes only, don't include this 'Software'
  47. in your projects/themes/whatever without EXPLICIT WRITTEN PERMISSION
  48. of The Author. Thank you.
  49.  
  50. Now, let's begin...
  51.  
  52. ___________________________________________________________________________
  53. 3. FILE LIST
  54.  
  55. Distribiution package contains:
  56.  
  57.   Short name |         Size |     Date |  Time |   Full name
  58. -------------+--------------+----------+-------+-------------
  59. STARS    EXE |      180 736 | 00.09.01 | 12:00 | stars.exe
  60. BENCH    TGA |      262 188 | 00.09.01 | 12:00 | bench.tga
  61. CHARS    TGA |       32 812 | 00.09.01 | 12:00 | chars.tga
  62. END      TGA |       65 580 | 00.09.01 | 12:00 | end.tga
  63. FLARE1   TGA |       16 428 | 00.09.01 | 12:00 | flare1.tga
  64. FLARE2   TGA |       16 428 | 00.09.01 | 12:00 | flare2.tga
  65. FLARE3   TGA |       16 428 | 00.09.01 | 12:00 | flare3.tga
  66. FLARE    TGA |        1 068 | 00.09.01 | 12:00 | flare.tga
  67. GLOW     TGA |       65 580 | 00.09.01 | 12:00 | glow.tga
  68. INTRO    TGA |      262 188 | 00.09.01 | 12:00 | intro.tga
  69. LOGO     TGA |      524 332 | 00.09.01 | 12:00 | logo.tga
  70. OTHER    TGA |       65 580 | 00.09.01 | 12:00 | other.tga
  71. SPACE    TGA |       65 580 | 00.09.01 | 12:00 | space.tga
  72. STAR1    TGA |          300 | 00.09.01 | 12:00 | star1.tga
  73. STAR2    TGA |          300 | 00.09.01 | 12:00 | star2.tga
  74. STAR3    TGA |          300 | 00.09.01 | 12:00 | star3.tga
  75. STARS    TXT |       13 461 | 00.09.01 | 12:00 | stars.txt
  76. STARS-PL TXT |       16 248 | 00.09.01 | 12:00 | stars-pl.txt
  77.  
  78. ___________________________________________________________________________
  79. 4. INSTALLATION
  80.  
  81. Unzip downloaded file (you must have done it already if you are reading
  82. this) with full pathnames and you are ready to go. Enjoy!
  83.  
  84. ___________________________________________________________________________
  85. 5. UNINSTALLATION
  86.  
  87. Just delete Stars directory - this program does not change your system
  88. at all and the settings are stored in "stars.ini" file which is located in
  89. the main program directory.
  90.  
  91. ___________________________________________________________________________
  92. 6. KEYS
  93.  
  94. - press "h" to see on-screen help
  95.  
  96. Warning! All the keys are active only in demo-mode.
  97.  
  98. ___________________________________________________________________________
  99. 7. HARDWARE / SOFTWARE REQUIREMENTS
  100.  
  101. Minimal requirements:
  102. - any PC with Windows 95/98/ME or WindowsNT/2000 and Open-GL driver
  103.  
  104. Recommended hardware:
  105. - PII or AMD-K6II processor
  106. - 16 Megs of RAM
  107. - 3D accelerator with full Open-GL ICD
  108.  
  109. This program was developed on:
  110. - PentiumII 233, 64Mb, Riva 128 4MB AGP (ref. drivers 3.37 & 3.41)
  111. - Celeron 566E, 128MB, ATI Rage 128 Pro 32MB (ref. drivers 06.33 CD21)
  112.  
  113. And tested on:
  114. - Celeron 300A, 64Mb, intel740 8MB AGP (ref. drivers 3.2 & 4.0) - not
  115.   tested with the newest builds
  116. - PentiumII 450, 128MB, Riva TNT 16MB AGP (ref. drivers 3.68 and newer)
  117.  
  118. Tested with the following systems:
  119. - Microsoft Windows 98 Polish (4.10.1998)
  120. - Microsoft Windows 98 Second Edition Polish (4.10.2222)
  121. - Microsoft Windows Millenium Edition English (4.90.3000)
  122. - Microsoft Windows 2000 Polish(?) - version 0.4.4 only
  123.  
  124. It runs pretty smooth on those computers - around 30 fps on i740, 40 fps
  125. on Riva128, 60-70 on RivaTNT and Rage128 Pro (640x480x16 fullscreen).
  126.  
  127. To achieve high and constant fps you need graphic card with good
  128. fill-rate. I recommend to use 32-bit color if it is possible
  129. - the difference between 16 and 32-bits is clearly visible.
  130.  
  131. This program looks pretty ugly on my Riva128, much better on i740 (good
  132. dithering) but it requires 32-bits to look brilliant. Since it uses
  133. blending to draw virtually everything, don't bother enabling 22-bit color
  134. if you have a Voodoo 3 - it will not improve visual quality. Only true
  135. 32-bit rendering looks really good - if your graphic card offers this
  136. feature - you are the winner!
  137.  
  138. ___________________________________________________________________________
  139. 8. "END.TGA" TEXTURE
  140.  
  141. You can modify "end.tga" texture to put your own logo into the program (for
  142. example - when you put this program on your website). The file should have
  143. the dimension of 128x128 pixels and it MUST be a 4 channel, 32 bit Targa.
  144. First 3 channels (RGB) are used for color and the 4th (Alpha) is used for
  145. transparency (blending effect). If you have any questions - look at the
  146. original "end.tga" file.
  147.  
  148. ___________________________________________________________________________
  149. 9. VERSION HISTORY
  150.  
  151. 0.5.0.0500 - [01.09.2000]
  152.       - next official version (Polish version also available)
  153.       - added introduction (only in demo-mode)
  154.       - added adjustable texture filtering mode: bilinear/bilinear+mipmaps
  155.         /trilinear
  156.       - improved textures - new Stars logo, Open-GL logo is now stored in
  157.         other.tga, better space texture
  158.       - particle system optimizations (new equation when rendering
  159.         as points)
  160.       - all selected options are now added to benchmark results (texture
  161.         filtering etc.)
  162.       - full information about initialization and program run in console
  163.         window
  164.       - all screenshots include the address of the official Stars home-page
  165.       - better save dialog on older systems (no "open as read-only" option)
  166.       - messages are now blended correctly
  167.       - revised MAPI support - the program will try to use normal shell
  168.         calls if the MAPI support is disabled
  169.       - fixed WinME wrong icon bug
  170. 0.5.0.0411 - beta1 [15.08.2000]
  171.       - tested and developed under Windows ME (4.90.3000 - Final, English)
  172.       - improved MAPI support
  173.       - improved UI (uses new save dialog from Win2000/WinME)
  174.       - you can now set gamma if you want brighter (or darker) picture
  175.       - completely new Open-GL Info and Help windows
  176.       - finally got rid of some stupid screen-shot bug
  177.       - rewritten clipping planes for stars (huge improvement in panoramic
  178.         /wide resolutions, but it is far from being perfect)
  179.       - more precise lens-flare positioning and rendering
  180.       - (too) many bug-fixes and optimizations
  181. 0.5.0.0250
  182.       - MAPI support
  183.       - customizable fonts and colors
  184.       - you can put your own logo (end.tga) - for example to let everybody
  185.         know where to download the good software from
  186.       - improved GUI (more hints and shortcuts) and space rendering
  187.       - all settings are now stored in stars.ini file
  188.       - the cursor changes to hand when moved over labels linking to some
  189.         web-pages or e-mail addresses
  190.       - many bug-fixes and optimizations
  191. 0.5.0.0201
  192.       - completely new space rendering
  193.       - new user BeOS-like interface
  194.       - more statistics (fill-rate, polygons per second, etc.)
  195.       - updated link to UPX
  196.       - removed command-line
  197. 0.4.4 - first public release [20.03.200]
  198.       - completely new background rendering
  199. 0.4.3 - many small bugfixes (too many...)
  200.       - text and icons are properly scaled with the resolution
  201. 0.4.2 - added lens-flare effect
  202.       - added debug mode to test lens-flare algorithms
  203.       - particles may be rendered as normal textured GL_Quads (some cards
  204.         (like my old i740) do not accelerate smoothed points so it was
  205.         extremely slow with GL_Points)
  206. 0.4.0 - added experimental particle system (using anti-aliased GL_Points)
  207.       - pressing [Alt]+[Tab] closes rendering window
  208.       - more accurate timer routine (timeGetTime)
  209.       - some minor (and major) bugfixes
  210. 0.3.6 - reduced number of glBindTexture calls (stars drawing) from about
  211.         300-1000 (depends on number of stars) to just 3 -> 5% performance
  212.         increase (with 400 stars)
  213. 0.3.5 - rearranged menu (separate Results tab, resizable window...)
  214.       - added textures authenticity verification
  215.       - added extra error checking
  216.       - added console window
  217. 0.3.0 - improved low-level routines, huge performance improvements (added
  218.         clipping to stars code  -> jumped from 48 fps to 72 fps and to
  219.         meteors code -> 3-10% fps increase in close view)
  220. 0.2.5 - lots of improvements to error checking code
  221.       - found a bug in Riva 128 3.37 Open-GL ICD (unable to set proper
  222.         pixel format after selecting 8 or 32 bit software rendering)
  223.         - added error checking, no workaround yet
  224.       - menu now works perfectly
  225.       - resolved bug that caused to slow down animation at very high
  226.         frame-rates
  227. 0.2.2 - lots of improvements to meteors code - finally got rid of this
  228.         annoying "drizzle" bug - it should be smooth now!
  229. 0.2.0 - no more command line only parameters! added menu to select
  230.         resolution and mode (command line options still work
  231.         - for hard-core users)
  232. 0.1.8 - benchmark mode (2000 frames run)
  233.       - resolved command-line parameters bug
  234.       - screen saver is now disabled
  235.       - some code improvements and bug fixes
  236.       - added logo & other things
  237. 0.1.6 - added keys to change Stars and Meteors number
  238.       - added some authenticity verification data
  239. 0.1.4 - results are now exported to Clipboard
  240. ...
  241. 0.0.1 - start of the Stars project
  242.  
  243. ___________________________________________________________________________
  244. 10. KNOWN BUGS
  245.  
  246. As for now - there are no known bugs. If you find a bug - drop me an e-mail
  247. (support@stars.benchmark.pl) with a detailed description of your problem
  248. and your configuration. 
  249.  
  250. ___________________________________________________________________________
  251. 11. THANKS
  252.  
  253. Special thanks go to:
  254.  
  255. - Benchmark3D (http://www.benchmark.pl) - The best Polish hardware site
  256.   and Ceti S.C. - Internet Operator (http://www.ceti.com.pl) for hosting
  257.   my web-site
  258.  
  259. - 2 Polish computer magazines - Enter (http://www.enter.pl) and Reset
  260.   (http://www.reset.com.pl) - for releasing the previous version on their
  261.   CD's
  262.  
  263. - Przemek for being the first person I received the results from
  264.  
  265. - Aleksander Ewich, who sent me the most results
  266.  
  267. - Aleksander Jerzy Jerzak for being the first registered user of my program
  268.  
  269. - Markus Oberhumer & Laszlo Molnar for UPX - The Ultimate Packer
  270.   for eXecutables (http://upx.tsx.org)
  271.  
  272. - Mike Lischke (Lischke@imib.med.tu-dresden.de) for excellent Open-GL
  273.   header files translation and some vector and matrix arithmetic code
  274.  
  275. - Scott Franke (druid-), author of Ambient Psychosis, for some really
  276.   useful Meteors code (http://www-scf.usc.edu/~sfranke/glj)
  277.  
  278. - Nate 'm|d' Miller (vandals1@home.com, http://members.home.com/vandals1)
  279.   for some stars code and excellent Open-GL sample code
  280.  
  281. ___________________________________________________________________________
  282. 12. CONTACTING WITH THE AUTHOR
  283.  
  284. If you have any suggestions or questions about this program,
  285. you can contact me at the addresses below:
  286.  
  287. WWW:
  288.          http://www.stars.benchmark.pl/
  289. Email:
  290.          stars@stars.benchmark.pl
  291. Smail:
  292.          Tomasz Porosinski
  293.          Zmudzka 13/27
  294.          51354 Wroclaw
  295.          POLAND
  296.  
  297. ___________________________________________________________________________
  298. 13. LEGAL COPYRIGHT
  299.  
  300. Copyright 2000 Tomasz Porosinski. All rights reserved.
  301. Unauthorized duplication is a violation of applicable laws.
  302. ___________________________________________________________________________
  303. 01.09.2000                                               12:00 (GMT +01:00)