home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Game Killer
/
Game_Killer.bin
/
013.UNZPTL30.DOC
< prev
next >
Wrap
Text File
|
1990-11-24
|
29KB
|
488 lines
╔═══════════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ Version 3.0 ║
╚═══════════════════════════════════╝
UNZPTL30.EXE currently allows for the management of up to 400 MAHJONGG tile
files on a hard disk. Each time the program is loaded, it creates and
displays a menu of all the tile files currently residing in a file called
MAHJTILE.ZIP. This file is created and maintained within the program via
the PKZIP and PKUNZIP file compression utilities. Each tile file in its
normal state consumes 33,600 bytes of disk space; compressed its size may
range from 2500 to 8000 bytes. UNZPTL30 hence puts the tile files at your
fingertips while conserving considerable hard disk space.
───────────────────────────────────
The main difference between version 2.5 and 2.0 is the addition of mouse
support.
The main differences between version 2.5 and 3.0 are as follows:
1). The correction of bug when displaying over 99 tiles.
2). The Setup facility was expanded as follows:
a). To allow for online creation and maintenance of the tile
argument files (*.ARG) and the default system parameter file
(MAHJONGG.PRM).
b). Selection of tile color attributes from a screen palette.
c). Ability to run STATGEN from within the program on any valid
statistics file in both edit and display mode.
d). All runtime definitions are accessible through the main
program excluding the need for word processor intervention.
───────────────────────────────────
The program requires the DOS sort utility (SORT.EXE) as well as both
PKZIP and PKUNZIP (by Phil Katz) which is available from most BBS's.
The following files must reside in the current subdirectory or path
statement unless the file setup (described below) is run:
1. PKZIP.EXE {From BBS}
2. PKUNZIP.EXE {From BBS}
3. MAHJONGG.EXE {From BBS}
4. STATGEN.EXE {From BBS}
5. UNZPTL30.EXE {Supplied}
6. MAHJTILE.ZIP {Skeleton supplied}
7. SORT.EXE {DOS sort utility}
If all files can be located, the program will load and display the
following screen: This is the Main Screen from where all activity
originates.
╔══════════════════════════════╡ U N Z I P T I L ╞════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ Version 3.0 ║
║ by Dick Koster ║
║ ║
║ ║
║ ┌──────────────────┐ ┌─────────┤MAHJONGG.PRM Active├─────────┐ ║
║ │▒▒▒1▒▒▒▒Mahjongg▒▒│ │ {E} = Exit Program │ ║
║ │ 2 ALASKA │ │ {N} = Create a New MAHJTILE.ZIP │ ║
║ │ 3 ALFABET │ │ {A}dd, {D}elete *.TIL & *.ARG Files │ ║
║ │ 4 ALPH │ │ {Enter} = Select Hilighted Tile │ ║
║ │ 5 ANIMALS │ │ {Arrow} = Up/Down Single Line │ ║
║ │ 6 ART │ │ {PgUp,PgDn} = Forward/Back Window │ ║
║ │ 7 ASCII │ │ {Home, End} = Window Top/Bottom │ ║
║ │ 8 ASCIIM │ └───────────────────────────────────────┘ ║
║ │ 9 ASTRO │ ║
║ │ 10 BALLOONS │ ║
║ │ 11 BASEBALL │ ║
║ │ 12 BATH │ ║
║ │ 13 BEARS │ ║
║ │ 14 BEER │ ║
║ │ * 15 BIRDS │ ║
║ └──────────────────┘ ║
╚════════════════════════════════════════╡ F4·Color ╞════════╡ F5·Files ╞═════╝
The SETUP facility is now in two parts and is accessible through the main
program. The file setup (F5 Files) option is used to select the paths of
the abovementioned files. If the files already reside in the run
subdirectory or are in the PATH statement, then it is not necessary to run
this option.
If any of the required files cannot be located at execution time, a warning
message is displayed and the program automatically runs the SETUP program
as illustrated below:
╔══════════════════════════════╡ U N Z I P T I L ╞════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ Version 3.0 ║
║ by Dick Koster ║
║ ║
║ ╔═════════════════════════════════════════════════╗ ║
║ ║ Setup Drive and Paths for the following files: ║ ║
║ ╚═════════════════════════════════════════════════╝ ║
║ ║
║ 1. MAHJONGG.EXE ▒▒▒▒\GAMES\MAHJ3\▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
║ 2. MAHJTILE.ZIP \GAMES\MAHJ3\TILES\ ║
║ 3. PKUNZIP.EXE \PKWARE\ ║
║ 4. PKZIP.EXE \PKWARE\ ║
║ 5. SORT.EXE \DOS\ ║
║ ║
║ ║
║ ║
║ ╔═════════════════════════════════════════════════╗ ║
║ ║ {Arrow}=Move { F8 }=DosShell { F9 }=Save ║ ║
║ ║ {Esc}=Exit to Dos { F6 }=No Changes ║ ║
║ ╚═════════════════════════════════════════════════╝ ║
║ ║
║ ║
╚═════════════════════════════════════════════════════════════════════════════╝
You may move the highlighted cursor line via the Up/Down arrows or click on
the line with the mouse. You may SHELL to DOS within the SETUP program via
(F8) to move files around, etc. When finished, you may save the SETUP file
via (F9) and return to the main menu, exit to DOS via (ESC), or return to
the main menu without saving via (F6). (Note: if you try to return to the
main menu program without successful location of all files, the SETUP
program will be reinitiated until designated correctly!).
The second SETUP option (F4 Color) refers to the creation, maintenance, or
deletion of unique "argument or parameter" files corresponding to a
specific tile file. The user first highlights the desired tile on the
main menu screen and then selects F4 which displays a menu of available
options. The selected options are stored in MAHJTILE.ZIP with its
respective tile file name but with the extension of ".ARG".
If MAHJONGG itself is selected from the menu, two file options are made
available:
╔══════════════════════════════════╗
║ Select ARG or PRM: ║
║ 1 = {MAHJONGG.ARG} ║
║ 2 = {MAHJONGG.PRM} ║
╚══════════════════════════════════╝
The ARG file refers only to the MAHJONGG tile set just as BIRDS.ARG would
refer to BIRDS.TIL. The PRM file refers to all tile sets that do NOT have
a respective ARG file. Any tile selection other than MAHJONGG (such as
BIRDS) would bypass the above screen and display the following:
╔══════════════════════════════╡ U N Z I P T I L ╞════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ Version 3.0 ║
║ by Dick Koster ║
║ ║
║ ║
║ ╔══════════╡ Tile: BIRDS ╞════════════╗ ║
║ ║ A. Hercules ║ ║
║ ║ B. EGA -E ║ ║
║ ║ C. Mono EGA ║ ║
║ ║ D. Laptop ║ ║
║ ║ E. No Title -N ║ ║
║ ║ F. Use Mouse -M ║ ║
║ ║ G. No Y/N Prompt -Y ║ ║
║ ║ H. Play Board # 12345 ║ ║
║ ║ I. Time (30 Max) 25 ║ ║
║ ║ J. Color -C10 -D12 ║ ║
║ ║ K. Stat File birds ║ ║
║ ║ ║ ║
║ ║ Select {A-K} ║ ║
║ ║ ║ ║
║ ╚═════════════════════════════════════╝ ║
║ ║
╚═══╡ F4·StatGen ╞════════╡ F7·Clear ARG ╞════╡ Esc·Cancel ╞════╡ F9·Save ╞═══╝
You may select only 1 of items A-D. Selecting a second deletes the current
selection.
Item "E" inhibits the initial display of the MAHJONGG title screen.
Item "F" turns mouse support on, but the MAHJONGG program will
automatically do this for you.
If item "G" is on, then the YES/NO prompt will be inhibited when a pair of
tiles have been successfully selected.
Item "H" will force a specific board to always be active.
Item "I" sets a time limit from 1 to 30 minutes; no limit if left blank.
Item "K" allows for the designation of a specific statistics file for this
tile set. You can have many statistics files for the same tile set as long
as you select the proper one here before playing a game.
Item "J" will be discussed in a moment.
If (F9 Save) is selected, the current arguments will be saved and
automatically loaded in MAHJTILE.ZIP with its respective tile set.
If (Esc Cancel) is selected, the original status of the argument file will
be retained.
If (F7 Clear Arg) is selected, the argument file for the selected tile set
will be removed from MAHJTILE.ZIP. If MAHJONGG.PRM was originally
selected, then that file will be deleted.
If (F4 StatGen) is selected, the following window will appear:
╔══════════════════════════════╡ U N Z I P T I L ╞════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ Version 3.0 ║
║ by Dick Koster ║
║ ║
║ ║
║ ║
║ ╔═══════════╡Tile: BIRDS╞═══════════╗ ║
║ ║ ║ ║
║ ║ ║ ║
║ ║ Enter Statistics Filename: ║ ║
║ ║ ║ ║
║ ║ {Enter} = MAHSTATS ║ ║
║ ║ ║ ║
║ ║ BIRDS ║ ║
║ ║ ║ ║
║ ║ {E}dit or {D}isplay ║ ║
║ ║ ║ ║
║ ║ ║ ║
║ ║ ║ ║
║ ╚═══════════════════════════════════╝ ║
║ ║
║ ║
╚═══╡ F4·StatGen ╞════════╡ F7·Clear ARG ╞════╡ Esc·Cancel ╞════╡ F9·Save ╞═══╝
Depressing or clicking on {Enter} will select the default MAHSTATS
statistics file. You may type in the name at the cursor or click on the
tile name in the upper border if that is the desired name. Once selected,
the option to EDIT or DISPLAY will be displayed. Select or click on "E" or
"D".
<<REMEMBER>> To exit the STATGEN program, depress the {Enter} key! To
leave this option at any time, depress (ESC).
Item "J" (on the argument selection screen) allows for the selection of
background and mouse border colors as shown below:
╔════════════════════╡ Select Background & Mouse Colors ╞═════════════════════╗
║ ║
║ 0 Black··········· < ███████████████ > ║
║ 1 Blue············ < ░░░░░░░░░░░░░░░ > ████████████████████ ║
║ 2 Black··········· < ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ > ████████████████████ ║
║ 3 Cyan············ < ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ > ██████▀▀▀▀▀▀▀▀██████ ║
║ 4 Red············· < > ████▒▒ o o ██████ ║
║ 5 Magenta········· < ███████████████ > ████▒▒ ¿ ██████ ║
║ 6 Brown··········· < ░░░░░░░░░░░░░░░ > ████▒▒ ≈≈≈ ██████ ║
║ 7 White··········· , ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ > ████▒▒ ██████ ║
║ 8 Black··········· < ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ > ████▒▒▒▒▒▒▒▒▒███████ ║
║ 9 Light Blue······ < > ████████████████████ ║
║ 10 Green··········· < ███████████████ > ████████████████████ ║
║ 11 Light Cyan······ < ░░░░░░░░░░░░░░░ > ║
║ 12 Light Red······· < ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ > ║
║ 13 Light Magenta··· < ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ > ║
║ 14 Yellow·········· < > ║
║ 15 Bright White···· < ███████████████ > ║
║ ║
║ ┌─────────────────────────────┐ ║
║ │ Enter Background No: │ ║
║ └─────────────────────────────┘ ║
║ ║
╚══════╡ F5·Background ╞═════╡ F6·Mouse ╞═════╡ Esc·Clear ╞═════╡ F9·Save ╞═══╝
To select either background or mouse colors, first select F5 or F6 (or
click on the appropriate box). Once the prompt is available, enter the
desired color number (or click on the actual color/verbiage). The pattern
at the top-right corner will give some idea as to the display of the
selected colors.
Enter F9 to place the color combination into the argument table. If ESC is
depressed, the color combination will be cleared and the tile set will
display whatever is the current default. The argument screen will be
displayed after entry of either F9 or ESC.
┌─────────────────────┐
│ Main Menu Screen │
└─────────────────────┘
╔══════════════════════════════╡ U N Z I P T I L ╞════════════════════════════╗
║ Mahjongg Tile File Manager ║
║ ┌───────────────┐ Version 3.0 ║
║ │ Argument File │ by Dick Koster ║
║ └───────────────┘ ║
║ ║
║ ┌──────────────────┐ ┌─────────┤MAHJONGG.PRM Active├─────────┐ ║
║ │ 16 BODY │ │ {E} = Exit Program │ ║
║ │ 17 CABLETV │ │ {N} = Create a New MAHJTILE.ZIP │ ║
║ │ 18 CAIRO │ │ {A}dd, {D}elete *.TIL & *.ARG Files │ ║
║ │ 19 CANS │ │ {Enter} = Select Hilighted Tile │ ║
║ │ 20 CARDS │ │ {Arrow} = Up/Down Single Line │ ║
║ │ 21 CARS │ │ {PgUp,PgDn} = Forward/Back Window │ ║
║ │ 22 CARS1 │ │ {Home, End} = Window Top/Bottom │ ║
║ │ 23 CARS2 │ └───────────────────────────────────────┘ ║
║ │ 24 CIRCUS │ ║
║ │ 25 COMPUTR1 │ ║
║ │ 26 COMPUTR2 │ ┌───────────────────────────────────────┐ ║
║ │ 27 CRAZY │ │ This will replace MAHJTILE.ZIP │ ║
║ │ 28 CTHULHU │ │ with current *.TIL & *.ARG files... │ ║
║ │▒*▒29▒▒▒DISNEY1▒▒▒│ │ Continue: {Y}es, {N}o │ ║
║ │ * 30 DISNEY2 │ └───────────────────────────────────────┘ ║
║ └──────────────────┘ ║
╚════════════════════════════════════════╡ F4·Color ╞════════╡ F5·Files ╞═════╝
Before taking each item in the main command window, please note the
following:
1. An asterisks (*) by a tile name in the tile window indicates that it
currently has an argument file. When highlighted, the "ARGUMENT FILE"
box in the upper left-hand corner is displayed.
2. If the default parameter file (MAHJONGG.PRM) exists, it is displayed in
the border of the main command window.
3. The left-hand vertical tile window displays the tile sets 15 at a time
in alphabetical order.
4. Below the command window is the confirmation/processing window which
will allow for confirming, cancelling, or watching the currently
selected processing task.
┌──────────────────────────┐
│ Command Window Options │
└──────────────────────────┘
1. {N} = Create a new MAHJTILE.ZIP: This will clear out the current
MAHJTILE.ZIP file and reload it with selected *.TIL files. The
confirmation prompt is indicated above. If yes is selected, the
prompt box will ask:
┌───────────────────────────────────────┐
│ Enter Drive & Path to *.TIL/ARG │
│ {Enter} = Current Directory │
│ c:\work\hold_______________________ │
└───────────────────────────────────────┘
Click on or depress {Enter} to default to the current run
subdirectory. Otherwise enter the desired subdirectory. To cancel
the operation, enter ESC.
2. {A} = Add *.TIL & *.ARG Files: This will append new tile files to an
existing MAHJTILE.ZIP file. The confirmation box is shown below:
┌───────────────────────────────────────┐
│ This will append MAHJTILE.ZIP │
│ with current *.TIL & *.ARG files... │
│ Continue: {Y}es, {N}o │
└───────────────────────────────────────┘
If yes is selected, the drive/path to the desired tile files is
prompted as above. ESC will cancel the operation if so desired.
While tile files are being added to MAHJTILE.ZIP, the following
message will display in the prompt/processing window:
┌───────────────────────────────────────┐
│ Adding *.TIL/ARG files to MAHJTILE │
│ │
│ Working, please wait... │
└───────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────┐
│ <<< W A R N I N G >>> │
│ │
│ If they are in the same subdirectory as UNZPTL30.EXE they will be │
│ deleted at end-of-program! Place in another subdirectory or floppy │
│ and indicate its path when prompted. │
└─────────────────────────────────────────────────────────────────────┘
3. {D} = Delete *.TIL & *.ARG File: This will remove a single tile file
and any associated argument file from MAHJTILE.ZIP. If selected, the
confirmation prompt below will display:
┌───────────────────────────────────────┐
│ This will remove from MAHJTILE.ZIP │
│ Tilename: BIRDS │
│ Continue: {Y}es, {N}o │
└───────────────────────────────────────┘
If yes is selected, you will then be prompted (as shown below) for a
subdirectory in which to off-load the selected tile set. In this way,
it will not be lost, and you have final say over its demise!
┌───────────────────────────────────────┐
│ Enter Drive & Path to copy BIRDS │
│ {Enter} = Current Directory │
│ c:\junk____________________________ │
└───────────────────────────────────────┘
As before, depressing {Enter} defaults to the current runtime
subdirectory, and ESC will cancel the operation.
4. Other options in the command window are for movement around the tile
name window. The Up/Down arrows move one line at a time. Home & End
move to either top or bottom of the current window. Page Up/Down move
forward/backward one tile window at a time.
5. {E} = Exit Program: Clicking on this box, entering "E", or ESC will
terminate the program.
6. {Enter} = Run Highlighted Tile: First use the arrow keys or mouse to
highlight the desired tile set. Depress or click on {Enter} to launch
MAHJONGG and the selected tile set. (Note: Once the tile set is
highlighted, clicking the Right mouse button emulates the {Enter} key).
┌─────────────────────────────────────────────────────────────────────────┐
│ The syntax for running the program is: │
│ │
│ UNZPTL30 { Normal program operation } │
│ │
│ UNZPTL30 /m { Forces monochrome in case the auto │
│ video adaptor I.D. routine fails │
└─────────────────────────────────────────────────────────────────────────┘
┌─────────────────────┐
│ │
│ Program Operation │
│ │
└─────────────────────┘
Using the BIRDS.TIL tile file as an example, when UNZPTL30 runs, it
extracts all BIRDS.* files from MAHJTILE.ZIP. If it finds a matching ARG
file, it will use those parameters. If no parameter file is found, it will
look for the "master" parameter file MAHJONGG.PRM. If this is found, it
will use those parameters for the current tile set. If the "master"
parameter file is not found, the MAHJONGG.EXE program runs with its built-
in default parameters as well as checking for EGA, mouse, etc.
************************************
A word about the "standard" tile set, MAHJONGG.TIL. The program will use
the default tile set built into MAHJONGG.EXE and not the tile set named
MAHJONGG.TIL which can also be supplied externally.
If you wish to alter MAHJONGG.TIL via TILEMAKR, load the newly created
version onto MAHJTILE.ZIP with another unique name. This can then be
retrieved in the same manner as the other tile sets.
(This was done to avoid a filename conflict with any MAHJONGG.* files you
may have in the current subdirectory during wildcard deletes of the
temporarily loaded tile & argument files!).
__________________________________________
This was written and tested on an 80286 IBM clone using MSDOS 3.3 with
EGA video. It was also tested on a like machine using a Hercules
monochrome graphics adaptor. The colors chosen are such that all screen
data will appear in the mono mode as well.
The program interrogates the video adaptor card for current color/mono mode
and sets the color scheme accordingly. If however you wish to force
monochrome, merely include a "/m" on the command line of either program.
UNZPTL30 shells out to PKZIP, PKUNZIP, SORT, STATGEN, and MAHJONGG, and was
written using MicroSoft Quick Basic Ver. 4.5 as a stand-alone EXE. It was
then further compressed using LZEXE by Fabrice Bellard.
───────────────────────────────────
This little utility is free so your conscience may rest in peace!
However, I am interested in receiving any comments you may have especially
concerning errors.
Forward any comments, postcards, or bug reports to:
Dick Koster
35 Guinevere Road
N. Easton, MA 02356
╔═══════════════════════════════════════════════════════════════════════╗
║ ║
║ LIMIT OF LIABILITY ║
║ ────────────────── ║
║ The author disclaims all warranties, expressed or ║
║ implied and assumes no liability for damages either from its ║
║ direct use or as a consequence of its use. Have you hugged ║
║ your backup today? ║
║ ║
╚═══════════════════════════════════════════════════════════════════════╝