Tutorials


QVIS3 Errors

if you have any answers to these errors or have errors to add then please email us.



  • WARNING: Leaf portals saw into leaf
      This means a leaf could see into itself, which by itself isn't an error. However, I recently had a lot of problems with this warning in a complex, underwater cave, and Quake 2 didn't want to draw all polygons that were supposed to be visible. This is due to a bad PVS. If you think you have such an error, try setting r_novis to 1. If the error goes away, this is your problem. I have reason to believe that this indicates that your map will have problems with a bad PVS, but often, you won't notice it while playing the level. Getting rid of this warning is tough. You can try to make brushes in the trouble area detail brushes. If the area is complex, you can also try inserting a few strategically placed hint and skip brushes (placing these is also a tough one). You can also try to simplify the area.



      Regarding the Leaf portals saw into leaf error on the RUST site, I've found the information presented already, is pretty much correct, and by some experimenting here's what I found about what causes and how to correct this error:

      Take for example, a rectangular hallway, and rectangular room. When you have cut a hole in a wall of the room, big enough to slide the hallway into (instead of making it flush with the wall) you are basically taking one viewable area (according to PVS) and inserting it in another. Essentially, you have two hollowed out volumes that intersect. Volumes of this type CANNOT intersect (this is also one cause of the AREAPORTAL doesn't touch 2 areas error). To VIS, it is sort of like looking into two seperate areas at the same time, while being in both at the same time--not possible.

      The two volumes can meet each other and be flush however. To fix the error (in this example) you need to cut the hallway brushes along the outside edge of the room. Essentially what you have left, is a hallway, which will meet flush against a room (which has part of the hallway in it). This should work for any type of "intersecting volumes."

      By default, a WARNING will not stop you from compiling a level with all the features. This particular QVIS warning has EXTREMELY bad side-effects and so it is highly recommended the warning be eliminated. Side effects are as follows:

      1. VIS time. Your VIS time can increase up to 50 times at least, even for moderately sized/designed maps.

      2. Final .bsp size. Your final .bsp can be 40% or more LARGER than the same map without the warning. In my tests, I used a 1200 brush map, which normally would be about 2MB. With the error, the size was about 3.45MB. The only difference between the two was the hallway was sliced in the 2MB map, making it about 6 brushes larger than the map in error.

      NB: The error may not necessarily appear right away (i.e. be reported as a warning) but the side-effects might begin happening, and only become full blown when the warning appears.

      Some pretty bad side-effects, huh? -Joel Caesar

  • Empty map
      You have to make a map before vising it!
  • usage: vis [-threads #] [-level 0-4] [-fast] [-v] bspfile
      you need to specify the bsp file to vis. ex. qvis3 suckymap.bsp
  • CheckStack: leaf recursion
  • CheckStack: late leaf recursion
  • AllocStackWinding: failed
  • FreeStackWinding: allready free
  • NewWinding: %i points
  • portal not done
  • Vismap expansion overflow
      The PVS is too large. Simply your level, or use detail brushes to reduce its size.
  • LoadPortals: couldn't read %s\n
      An error occured while loading the xyz.prt file. It could be corrupted, missing (if you have a leak), or your map is too complex for qbsp3 too generate a valid .prt file.
  • LoadPortals: failed to read header
      An error occured while loading the xyz.prt file. It could be corrupted, missing (if you have a leak), or your map is too complex for qbsp3 too generate a valid .prt file.
  • LoadPortals: not a portal file
      An error occured while loading the xyz.prt file. It could be corrupted, missing (if you have a leak), or your map is too complex for qbsp3 too generate a valid .prt file.
  • LoadPortals: reading portal %i
      An error occured while loading the xyz.prt file. It could be corrupted, missing (if you have a leak), or your map is too complex for qbsp3 too generate a valid .prt file.
  • LoadPortals: portal %i has too many points
      An error occured while loading the xyz.prt file. It could be corrupted, missing (if you have a leak), or your map is too complex for qbsp3 too generate a valid .prt file.
  • Leaf with too many portals
  • Bad bit in PVS
  • Unknown option
      Your running qvis3 with an option that is invalid.




  • Copyright Crap