QGETLEAK v0.02

Copyright 1997 Rand Phares



INTRO
-----

Qgetleak is a program that can help you with leaky maps. It locates the
single node in the PTS file where you're most likely to find the leak.

You might find this quicker than the traditional method of invoking Quake
with the PTS file and tracking the silver dots.


HOW TO USE IT
-------------

Qgetleak is a command-line program that you can insert into your batch qutils
files. Just place it after the qbsp line:

        qbsp mymap
        qgetleak mymap
        light mymap
        vis -fast mymap

If you want to capture Qgetleak's output in a file for later use:

        qbsp mymap
        qgetleak mymap > mymap.lek
        light mymap
        vis -fast mymap

Qgetleaks requires the presence of GO32.EXE, and a copy is provided.


WHAT IF THERE'S NO PTS FILE?
----------------------------

If qbsp doesn't generate a PTS file, your map is probably closed (leak-free),
and qgetleak will give you this message:

        ***** Can't open mymap.pts

This is a GOOD THING.


WHAT DOES QGETLEAK REPORT?
--------------------------

When a PTS file exists, Qgetleak will report something like:

        ***** Leak: (120,-64,312)
                    leak in +X direction
                    leak in +Y direction

This means that in the area of (120,-64,312), you can see into the OUTSIDE
world (that nasty gray stuff) along the +X and +Y directions. No brushes
block the view. All nodes prior to this one in the PTS file have all lines-
of-sight blocked.


BUGS
----

If you get this message:

        ***** All PTS nodes are inside the map!

then contact me. Qgetleak wasn't able to deal with your map properly, and
will need to be changed. This might be due to a odd-shaped brush piercing
an outside wall, which sometimes drives qbsp nuts. Qgetleak is only
interested in actual gaps.


AUTHOR
------

Rand Phares
phares@dg-rtp.dg.com