VGA Planets Interface Program Configuration File Definition:

The VGA Planets Interface Program (registered version) has the ability to 
read and write a configuration file (BPSVP.CFG) which nearly completely 
defines its operation.  The file is completely accessible to the online 
SysOp through the VGAP Interface Program, but the file and its contents 
are described here for those who may wish to look at it.

Section 1 - Flags:
All of the flags (BOOLEANS) used to configure PCBVP's operation are stored 
in a packed word (2 bytes) which then occupies the first two bytes of the 
configuration file.  The flags are described below:

  Bit #  Description              Default
     1 - Log to callers log          T
     2 - Log to external file        F
     3 - Log program entry           T
     4 - Log game joined             T
     5 - Log file transfer           T
     6 - Log transfer abort          T
     7 - Log test results            T
     8 - Test uploaded file          T
     9 - Display test results        T
    10 - Delete failed upload        T
    11 - Key file found              F
    12 - Reserved                    F
    13 - Reserved                    F
    14 - Reserved                    F
    15 - Reserved                    F
    16 - Reserved                    F

Section 2 - Security Fields:
The following fields are used to set security options to restrict users 
from certain aspects of the door.

    Field                           Default Level
    Security to join/play a game           0
    Security to play multiple games        0 
    Security to initialize games         110
    Security for Configuration menu      110

Section 3 - Display Options Fields:
These fields set the colors for the various displays created by PCBVP.  
All of the fields are single byte integers (0-255) which describe both 
foreground and background attributes.  PCBVP takes these integers and 
converts them to PCBoard @X codes internally.
                                                       Default Values
     Field                                        Foreground     Background
     Menu heading color                           Br. White      Black
     Color of games in which the user is active   Br. Magenta    Black
     Color of available games which user isn't in Br. Blue       Black
     Color of other menu options                  Br. Cyan       Black
     Menu highlighting color                      Br. Red        Black
     Prompt color                                 Br. Cyan       Blue  

Section 4 - Variable length fields.
Since BBS setups vary widely, any fields which rely on path or filename 
information were made variable length.  This allows flexibility for those 
SysOps who have things buried deeply in many levels of subdirectories, 
creating long pathnames, while saving space for those who have shorter 
pathnames.  Since software should be written to suit everyone's needs, the 
only acceptable option was to make each of the fields the maximum 
available length (2048 bytes) which would be a tremendous waste of storage 
space.  Each field which has significance to the program is preceeded by a 
2 byte integer describing the length of the field.
Note that these fields are all NULL until you run the PCBVP configuration 
option.

     Field                                      Default
     External log filename length                   0
     External log filename                  
     VGA Planets executables directory length       0
     VGA Planets executables directory               
     VGA Planets game template dir length           0
     VGA Planets game template dir
     PCBoard event filename length                  0
     PCBoard event filename
