NAME

checkvic - an add-on for VGA Planets (PHOST)


SYNOPSIS

checkvic [options] <planetsforvictory> <consecutiveturns> [<gamedirectory> [<rootdirectory>]]


DESCRIPTION

The add-on checkvic for the Portable Host Project (PHOST) reports the quantity of planets each player holds. If a player controls the given number of planets for a distinct number of turns he will be declared as the winner of the game. Use this add-on in the AUXHOST2 phase.


OPTIONS

-h
Prints a help summary and exits
-v
Prints program version and exits
-u
Reports the number of unowned planets
-e file
Use file as an error log file
-p N
If a player owns N percent of the required number of planets report the amount he controls


ARGUMENTS

planetsforvictory
Number of planets a player has to own in order to win the game

consecutiveturns
Number of turns a player has to hold the above mentioned quantity of planets

gamedirectory
Directory in which game-specific files are expected to reside. The default is the current directory.

rootdirectory
Directory in which global data files usually reside. The default is the current directory.


EXAMPLES

Examples of use are (AUXHOST2.INI):

DOS 

c:\vgapl\checkvic -e c:\vgapl\game1\checkvic.err 125 3 c:\vgapl\game1
c:\vgapl\checkvic 125 3 c:\vgapl\game1

UN*X 

checkvic -e /home/vgapl/game1/checkvic.err 125 3 /home/vgapl/game1
checkvic 125 3 /home/vgapl/game1

A winner has to control 125 planets for 3 consecutive turns. The entire number of planets each player holds will be reported.

 

Another examples are

DOS 

c:\vgapl\checkvic -u -e c:\vgapl\game1\checkvic.err -p 52 125 3 c:\vgapl\game1
c:\vgapl\checkvic -u -p 52 125 3 c:\vgapl\game1

UN*X 

checkvic -u -e /home/vgapl/game1/checkvic.err -p 52 125 3 /home/vgapl/game1
checkvic -u -p 52 125 3 /home/vgapl/game1

The same as above, but now report the number of controlled planets if a player owns more than 65 (52%). Furthermore the number of unowned planets will be shown.


FILES

checkvic.log
The log file.

checkvic.hst
Contains the last turn number and the number of consecutive turns.


SEE ALSO

http://www.phost.de/


VERSION

This manual page describes checkvic version 1.3.


AVAILABILITY

http://phost.de/~vagabond/addons/checkvic/checkvic.zip


AUTHOR

Heiko Schlenker (hschlen@gmx.de)


CREDITS

I would like to thank the PDK authors Andrew Sterian, Thomas Voigt, Steffen Pietsch and Stefan Reuther for their wonderful work and Tim Wisseman for writing VGA Planets, of course. Checkvic is linked with the PDK software library and some initialization stuff is derived from the example program ex1.c. You can obtain a copy of the PDK package from http://www.phost.de/.


ACKNOWLEDGMENTS

Thanks to Degi (matthias.degenhardt@gmx.de) who induced me to write this add-on. Oliver Korn (o.korn@tu-bs.de) suggested the -p option. Peter Scholz (peter_scholz@t-online.de) gave me the idea of the -u option.

 

  Last Modified: 23-Nov-2003
<URL:http://phost.de/~vagabond/addons/checkvic/checkvic.html>
<URL:mailto:the_vagabund@gmx.de>