# Visplane Explorer

## Introduction

Visplane Explorer is a stand-alone program to visualize possible visplane overflow (VPO) errors in DOOM maps. This is useful when mapping for vanilla DOOM, because when an overflow occurs the game simply quits with an error message (or crashes), which is pretty harsh on the person playing.

Visplane Explorer can check not only "visplanes", but also "draw-segs" and "solid-segs". When draw-segs overflow, it is not too bad since it just produces rendering glitches, but solid-seg overflow will corrupt memory and probably crash. Visplane Explorer works by using a stripped down version of the DOOM rendering code, with increased limits and extra checks to prevent overflowing the buffers and crashing.

Caveat : while this program is a useful tool, it cannot predict every situation (for example, an Archvile making the player jump in the air, which means more geometry can be seen and hence higher visplane counts). You should always test your map in the original game.

(Note: there is also a plugin for Doom Builder 2 called "Visplane Explorer", which was based on this program. If you are looking for that, then I suggest trying the Doom Builder website or forums.)

## Screenshot

## Downloads

Windows binary : visexp-1.0-win32.zip

MacOS X package : visexp-1.0-osx.dmg

Debian Linux package : visplane-explorer_1.0-1_i386.deb

Source code : visexp-1.0-source.tar.gz and

## Summary of Keyboard and Mouse usage:

- scroll map with mouse button or cursor keys
- zoom with the mouse wheel or + / - keys
- switch modes quickly with `V` / `D` / `S` keys

## Credits

This GUI program was created by Andrew Apted (me).

The MacOS X package was made by Ioan Chera.

It includes a very stripped down version of the DOOM rendering code, which I took from Chocolate Doom (by Simon Howard), which in turn is based on the DOOM source code release by Id Software. Hence these guys are included in the copyright notice.

## Copyright and License

      Visplane Explorer

      Copyright (C) 2012-2014 Andrew Apted
      Copyright (C) 2005-2008 Simon Howard
      Copyright (C) 1993-1996 Id Software, Inc.

      This program is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
      by the Free Software Foundation; either version 2 of the License,
      or (at your option) any later version.

      This program is distributed in the hope that it will be useful, but
      WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
      GNU General Public License for more details.

See GNU General Public License for the full text.