home *** CD-ROM | disk | FTP | other *** search
/ Qu-ake / Qu-ake.iso / qu_ke / editor / 013 / README.TXT < prev   
Encoding:
Text File  |  1996-09-24  |  6.8 KB  |  152 lines
  1. LEET VIS
  2.  
  3. Current Version: 31337
  4. ----------------------
  5.  
  6. standard disclaimer
  7. -------------------
  8. If this program causes your computer to have problems in any way, whether it
  9. explodes or loses its cmos or whatever, its not my fault.  By reading this
  10. and using leetvis you understand and acknowledge this disclaimer. 
  11.  
  12. Intro
  13. -----
  14. For some time I have been working on a better version of the vis utility that
  15. was released by idsoftware.  I started out with something called supervis
  16. that was just a few standard additions to vis much like all the extra faces
  17. and stuff people have been adding to qbsp.  Then I made a much more feature-
  18. rich version and called it leetvis.  Leetvis went through several revisions
  19. and the code soon became friggin huge.  Since that was a mess and I really
  20. needed to return to fundamentals to code my own utility, I am currently
  21. working on a vis program called pvs.
  22.  
  23. PVS will fix a lot of problems that I saw with vis.  There will be a lot more
  24. optimizations in PVS that hopefully will make it faster.  Also there will be
  25. a client/server ipx paradigm that will let you speed things up via network.
  26. However at the heart of pvs is an old kernal for the vis job itself that I am
  27. still calling leetvis.  I may even have lighting code in pvs because the light
  28. job can be sped up by using the pvs.
  29.  
  30. Anyway I have decided to go back and add in a few features to vis like the
  31. original plan.  I have made a lame set of extra features and put it in the
  32. old code from id.  A lot of the really cool stuff that is in pvs is not here
  33. but what do you expect from 20 minutes of coding?  Besides my pvs code is now
  34. very different from carmacks vis at this point anyway.  I hope you enjoy
  35. the program and find it useful.
  36.  
  37. Care and Feeding
  38. ----------------
  39. Leet Vis is a redo of the vis program for generating the potentially visible
  40. set of quake maps.  Several modifications have been made to allow for better
  41. performance and ease of use.
  42.  
  43.   Leet Vis relies less upon command line parameters than the old vis
  44. program.  It will check the portal file generated by qbsp and determine how
  45. complex it will be to vis the map.  Based upon that complexity the program
  46. will be able to give a very very approximate time of vising.  The vis-time
  47. equation is still very rough so expect at least 2-300% errors.  Leetvis also
  48. tries to determine how difficult it will be to vis and tells you that too.
  49.  
  50.   If you want to use leet vis and dont have the bsp file available for use,
  51. just run leetvis -nobsp and it will use the .prt file only.  This is useful
  52. to me while I am designing the program and it may be useful for benchmarking
  53. if you terminate a qbsp compile and just want to see a quick estimate of how
  54. long it would take to vis that level.  Quick and dirty.
  55.  
  56.   I have talked to the person who developed powerbsp and he said there was a
  57. suggestion to implement a switch to turn off sounds in vis.  Leet Vis has
  58. that option.  It is leetvis -nosound.  This just keeps vis from adding in
  59. the sound effects to textures it finds in the map.
  60.  
  61.  
  62.   Right now I am trying to implement a way for vis to stop what its doing
  63. right in the middle of a run.  If this works you would press the "Q" key
  64. and leetvis would write the current run out to a tmp.vis file.  Later you
  65. would run leetvis -resume and the run would keep going as if nothing happened.
  66.  
  67.  
  68.   Soon there will be implemented four different types of optimization that
  69. should speed up vis speed on the pc a bit.  Currently only one of the
  70. optimizations is in place.  The others will be added as soon as I get a better
  71. handle on a better understanding of the fundamentals of pvs generation.
  72.  
  73.   Since vis is a highly parallel operation, I have thought about putting in
  74. ipx support for vis.  This would allow you to spawn tasks on other machines
  75. and theoretically speed up the program.  As I see it I will have one machine
  76. as the server and the others as clients doing a leaf at a time.
  77.  
  78.  
  79.   Keep looking forward to my next project.  It will be a super version of
  80. qbsp that does everything and I will call it "yermom".
  81.  
  82.  
  83. misc stuff I am doing:
  84. added a -noprint option to prevent screen flooding by *, and . :)
  85.  
  86. -working on stopping execution and resuming in the middle.  You simply press
  87.  "q" and vis stops running, saves your work, and exits.  Then you run
  88.  leetvis -resume later to keep going.
  89.  
  90. -working on a possible new optimization for vising.
  91.  
  92. -working on putting in ipx for network stuff.  Probably will be some sort
  93. of client/server thing.  Currently have the ipx drivers written but trying
  94. to figgure out exactly how I am going to implement it.
  95.  
  96. new options to come:
  97. -client <nodenum>  makes this a network client machine with that id
  98. -host <numnodes> make a server that looks for so many nodes
  99. these options will replace -threads and spawn network threads
  100.  
  101.  
  102.    Soon I plan on adding custom texture names for water brush sounds,
  103. lava sounds, and sky sounds.  Should make for some interesting maps in
  104. the future :)
  105.  
  106. known problems:
  107.    Occasionally a page fault is encountered.  I have tracked that down and it
  108. is a problem with memory.  On my 16 mb pentium I get it occasionally with
  109. larger files.  I am redoing a lot of the file io and various arrays to remedy
  110. that situation.  Already I have removed a lot of the static arrays that plague
  111. qbsp but this build of leetvis will have to wait on that because I dont have
  112. a current file on my work machine.
  113.  
  114.  
  115. current options for leetvis
  116. ---------------------------
  117. leetvis [-level 0-4] [-fast] [-v] [-nosound] [-noprint] [-prt] bspfile 
  118.  
  119. level - same old same old.  Sets vis testlevel.
  120. fast  - fast but loose vis for testing purposes
  121. v     - verbose mode on
  122. nosound - will not assign sounds to textures
  123. noprint - will not print out symbols for vis recursion
  124. prt     - use portal file instead of bsp file
  125.  
  126.  
  127. Thanks and greetz
  128. -----------------
  129.   Thanks to GOD or else we wouldnt be here.  Also thanks go out to iD
  130. software because they love us almost as much as He does ;-)  Also I would
  131. like to thank Billy Zelsnack for his putting up with me and being such a
  132. great help in my other projects.  Special greets to Dave Taylor at crack.com,
  133. Ryan Geithman at bossgames, and all my wonderful friends on irc.
  134.  
  135.  
  136. Starving Coder Standard Beg for dollars section
  137. -----------------------------------------------
  138. LeetVis is FREEWARE.  Use it and  give it to your friends.  If you like the
  139. program and it gives you a wood, please feel free to make a $5 donation to
  140. Feed The Children, the Red Cross, or the Salvation Army.  There are those
  141. who need it a lot more than you or I.
  142.  
  143.  
  144. Complaints, Concerns, Comments, etc...
  145. --------------------------------------
  146. They all go to vile@dazed.nol.net or /dev/null depending on how angry you are
  147. at me ;)
  148.  
  149.  
  150. --------------------------------
  151. .prts is .prts and pieces .prts.
  152.