ADVANCED GRAPHICS

SYSTEM (AGS)
Software Version 2.03
User Manual
Manual Version A

P.N. 990-240-00
April 21, 1999

MIKOHN GAMING CORPORATION

License Agreement

IMPORTANT
Initial use of this product in a commercial or engineering environment indicates acceptance of the terms and
conditions of this License Agreement, and represents and warrants legal capacity to enter this agreement
and authority to bind its employer. If not in agreement with these terms and conditions, promptly return the
package for refunding. This license is not a sale of Mikohn Gaming Corporation (hereinafter MIKOHN)
proprietary software or of the engineering concepts employed in the hardware. The customer assumes the
responsibility for product configuration, installation and intended results.

1. CUSTOMER OBLIGATION
The customer assumes full responsibility that the MIKOHN hardware and software received upon purchase meets
the specifications, capacities, versatility, capability and any other requirements of the customer. Furthermore, the
customer assumes full responsibility for the condition and effectiveness of the operating environment in which the
products (hardware and software) are to function, and for installation procedures.

2. COPYRIGHT
MIKOHN Gaming Corporation, 1989-1999. All rights are reserved worldwide. No part of this publication may be
reproduced, transmitted, stored in a retrieval system, or translated into any foreign language without PRIOR written
permission from MIKOHN. MIKOHN reserves all rights to look, feel, and design of the company products, the
company and product logos and trademarks. All MIKOHN software programs are copyrighted, and are the exclusive
property of MIKOHN. This includes the compression technology of the Storyboard Plus Interpreter. Any attempt or
action to reproduce, modify, encrypt, decompile, reverse engineer or otherwise attempt to interpret existing
code or engineering concepts is strictly beyond the intent of this agreement.
3. DISCLAIMER
Neither MIKOHN, nor its distributors, make any representation, either expressed or implied, with respect to liability
for software or products described in this manual, their quality, performance, merchantability, or suitability for any
specific purpose. In no event will MIKOHN, nor its distributors, be liable for direct, indirect, incidental,
special, or consequential damages, including the expressed warranty described in this document, resulting
from any defect of the manual, software, hardware, or supporting products. Furthermore, MIKOHN reserves
the right to revise any of its publications, software or hardware and to make changes from time to time, without
obligation of MIKOHN to notify any person or organization of such changes. MIKOHN assumes no responsibility for
failure of the purchaser to receive such information, either in whole or in part. Publications could include technical
inaccuracies or typographical errors. As a result, the purchaser assumes the entire risk as to the quality and
performance of the software and products. The publications, software, and hardware are purchased "AS
IS". Some states or countries do not allow an express or implied warranty disclaimer; therefore this section may not
apply.
4.

LIMITED WARRANTY AND DISCLAIMER OF WARRANTY

All MIKOHN products, hardware and software, are covered by a limited one year warranty to the original customer.
This license warranty is transferable only if prior written permission is obtained from MIKOHN. If possession
of the product or any portion of the product is transferred to another party, the license agreement and this warranty is
automatically terminated. The License Agreement can only be extended to another party if written notification of
such transfer is provided to MIKOHN, and the concurrence of MIKOHN to the transfer. The warranty is void if any of
the hardware or software components are serviced by an unauthorized technician or if abnormal use has occurred.
MIKOHN is under no obligation to replace or repair expendable items. The warranty begins as soon as the product
leaves the factory and is evidenced by the date noted on the sale receipt. MIKOHN assumes no responsibility for,
and the warranty does not include, damage done to any of its products during transportation and delivery. Should
such damages occur in transportation and delivery, the liability is between the carrier and the purchaser.
Enforcement of the warranty is under the sole discretion of MIKOHN. MIKOHN assumes no responsibility for
coding or compiling errors that may exist in its proprietary software programs. All vendor-supplied programs are
provided "AS IS". Neither MIKOHN nor its distributors, make any warranty, either expressed or implied, as to the
quality and performance of these programs. Should any of these programs prove defective, MIKOHN will not
assume any cost for service, repair, correction, or lost revenue. These include programs supplied by any
outside vendor, such as IBM, Microsoft, or Tandy. MIKOHN warrants the media on which the software resides to be
free from defects in materials and workmanship for the period of one year, under normal use, to the original
customer. The "normal use" clause designates that the hardware and software has been installed according to the
instruction procedures and proper care has been demonstrated in maintenance operations. Normal use also includes
operating MIKOHN equipment according to and within specifications and design limitations. MIKOHN reserves the
right as final judge in any software or hardware arbitration. In no case, under any circumstance, will
MIKOHN assume liability for lost revenue.

iii

5. LIMITATIONS OF REMEDIES
MlKOHN's entire liability and the customers exclusive remedy shall be as follows:
A. Transportation of defective software or hardware
The cost of transportation from the customer to MIKOHN is paid by the customer. The cost of
transportation from MIKOHN to the customer is paid by MIKOHN. MIKOHN assumes no liability caused
by delay in either direction, to or from the customer.
B. Defective Software
In all situations involving performance or nonperformance of software during the one-year warranty period,
the exclusive remedy is at MlKOHN's discretion. Software must be returned to MIKOHN, or its
distributor, with a copy of the receipt. All such software will be examined by MIKOHN and a determination
made. MIKOHN will replace software that it determines defective and meets the warranty time period.
C. Defective Hardware
In all situations involving performance or nonperformance of hardware during the one-year warranty
period, the exclusive remedy is at MlKOHN's discretion. Hardware must be returned to MIKOHN, or its
distributor, with a copy of the receipt. All such hardware will be examined by MIKOHN and a determination
made. MIKOHN will replace hardware that it determines defective and meets the warranty time period.
D. Liability
In no event will MIKOHN or its distributors be liable for any damages, including interruption of
service, lost profits, lost savings, lost anticipatory profits, or consequential damages arising out of
the use or inability to use any MIKOHN or supportive products, even if MIKOHN or its distributors
has been advised of the possibility of damages or any claim by another party.
E. Limited Jurisdiction
Some jurisdictions do not allow the limitation or exclusion of liability clauses for incidental or consequential
damages. In these areas, the limitation or exclusion provisions may not apply.
6. APPLICATION OF WARRANTY
The warranty and remedies set forth above are exclusive and in lieu of all others, oral and written, expressed or
implied. This warranty may be appended or replaced by an authorized MIKOHN employee that is endorsed to make
such modification, extension, or addition. The warranty may not be appended or replaced by a distributor, agent, or
unauthorized employee.
7. OTHER CUSTOMER RIGHTS
This license and warranty give the customer specific legal rights, along with the other rights that may exist from
jurisdiction to jurisdiction.
8. LICENSE
Mikohn grants the customer a non-exclusive license to use its proprietary products subject to the following
conditions:
A. Customer may make as many copies of the MIKOHN proprietary software as necessary for normal
business practices or for archiving purposes.
B. Customer may make any number of copies of original MIKOHN documentation for personal use or the
instruction of other employees of the original purchaser. All copies of the original documentation must
contain the original copyright notice.
C. Customer may sell, give, or loan the complete product (hardware and or software) to another party and
transfer the license agreement by providing written notification to MIKOHN.
D. Customer is granted title to the medium on which the software is recorded (diskette or cassette) or
stored (ROM, PROM, EPROM, or similar unit) but not the title to the software or firmware.
E. Customer is granted title to the hardware, but not to MlKOHN's proprietary conceptual design or
engineering logic employed to create the hardware. The hardware may not be "reverse
engineered" or otherwise disassembled in order to study or examine the components for research
purposes.
F. Customer may resell or distribute the software to another party provided the customer has purchased
from MIKOHN one copy of the software for each one sold or distributed.
MIKOHN hereby agrees to grant the purchaser a non-exclusive license to use its software and associated products,
subject to the terms and conditions set forth in this License Agreement.

Mikohn Gaming Corporation 1045 Palms Airport Drive P.O. Box 98686 Las Vegas, NV 89193-8686
1-800-366-8449 (702) 896-3890 FAX (702) 896-2461 www.mikohn.com

iv

Mikohn Copyrights and Trademarks Used in This Document:

AGS (ADVANCED GRAPHICS SYSTEM)
CHAMELEON
HOT POTATO
JACKPOT TRIGGER DEVICE (JPTD)
Mikohn,
Mikohn Gaming Corporation
MONEYTIME
SUPREME, SUPREME LOGIC BOARD
CHAMELEON

All other trademarks and service marks are the property of their respective owners.
In particular, Sound Blaster is a registered trademark of Creative Lab.

Copyright 1997, 1998, 1999 by Mikohn Gaming Corporation

This document is provided to the customers and authorized service personnel of Mikohn Gaming
Corporation. It is intended for their use only and no other. No part of this publication may be stored in
a retrieval system, transmitted, or reproduced in any way, including but not limited to photocopy,
photograph, and magnetic or other record, without the prior agreement and written permission of the
publisher.

April 21, 1999

990-240-00

THIS PAGE INTENTIONALLY LEFT BLANK

April 21, 1999

vi

990-240-00

Winning Solutions...Worldwide

MIKOHN GAMING CORPORATION OVERVIEW

There is a Mikohn product in every casino in the world. This simple statement is a testimony to
Mikohns influence as a key supplier to the international gaming industry. Within its
three core divisions, Mikohns diversified portfolio encompasses high-tech player
tracking and management information systems, advanced systems for the automation of
table games, turn-key design and manufacturing for high impact interior and exterior
signage and lighting displays, and a wide and growing number of proprietary specialty
games.

DISPLAYS
As the pioneer and industry leader in the development of interior signage and displays in
casinos, Mikohn is renowned for its unique, sensory-stimulating displays. This
specialized form of artwork features multi-dimensional and 3-D elements, thematic
progressive displays, meters, robotics/animatronic technology, and computercoordinated sound and light shows. Mikohn can also customize slot glass to a particular
theme, color, and style, enhancing the overall effect of any game.
Mikohns award-winning exterior lighting and signage design team invents displays that
not only illuminate buildings, but also magnify their presence and theme.

SPECIALTY GAMES
Mikohn continues to broaden its staple of proprietary specialty table and slot games.
Designed to bring variety to the gaming floor and attract players to under-utilized areas,
these games encourage greater play through their novel looks and concepts, progressive
jackpot systems, and outstanding display features.

ELECTRONIC SYSTEMS
Heralded as the dominant leader in progressive jackpot systems, Mikohn continues to
expand its offerings of sophisticated electronic systems to include advanced management
information and player tracking innovations, related module enhancements, and
bonusing technology.

Mikohn Customer Service Hotline

Inside Nevada (702) 798-1942
US excluding NV 1-800-798-1942
FAX: (702) 263-2834
E-mail: 800Service@mikohn.com
We are here to help you 7 days
a week, 24 hours a day

April 21, 1999

Mikohn Corporate Headquarters

1045 Palms Airport Drive
P.O. Box 98686
Las Vegas, NV 89193-8686
Telephone: 1-800-336-8449
(702) 896-3890
Fax: (702) 896-2461
Web: www.mikohn.com

vii

990-240-00

THIS PAGE INTENTIONALLY LEFT BLANK

April 21, 1999

viii

990-240-00

AGS 2.03 User Manual

Manual Version A

Table of Contents

TABLE OF CONTENTS
CONVENTIONS USED IN THIS MANUAL:............................................................................................... X
1.

OVERVIEW................................................................................................................................. 1
1.1

2.

MINIMUM SYSTEM REQUIREMENTS FOR AGS 2.03: .................................................................. 1

INSTALLATION AND CONFIGURATION............................................................................ 3

2.1 REQUIRED FILES ........................................................................................................................ 3
2.2 PRE-INSTALL REQUIREMENTS.................................................................................................... 3
2.3 INSTALLATION ........................................................................................................................... 3
2.4 STARTING AGS.......................................................................................................................... 3
2.5 COMMAND LINE SWITCHES ....................................................................................................... 4
2.6 EXITING AGS ............................................................................................................................ 4
2.7 THE AGS.INI FILE .................................................................................................................... 5
2.8 CONFIGURING THE BACKGRND.BAT FILE ................................................................................... 6
2.8.1
Backgrnd.bat Command Line Descriptions..................................................................... 6
2.8.2
Example BACKGRND.BAT to play graphics files and sound ......................................... 8
2.8.3
Example BACKGRND.BAT to play a TRIGGER file....................................................... 8
2.8.4
Example BACKGRND.BAT to play graphics file and Progressive Meter Application ... 8
2.9 THE CMD (COMMAND) FILE ..................................................................................................... 9
2.10
HOW TO SET UP AUTOEXEC.BAT ........................................................................................ 10

APPENDIX A - ABOUT LCDs AND PLASMA DISPLAYS .......................................................... 11

APPENDIX B - HOW TO SET UP MONEYTIME ..................................................................... 13
ABOUT .DO FILE LINE STRUCTURE ................................................................................................... 14
APPENDIX C HOW TO SET UP HOT POTATO ....................................................................... 15
APPENDIX D PROGRESSIVE APPLICATIONS FOR MIKOHN GRAPHIC DISPLAYS... 17
PROGRESSIVE DEFINITION FILE (.PDF) ............................................................................................. 17
TEMPLATE FILE ................................................................................................................................. 19
ARGUMENTS TO PROGRESSIVE APPLICATION PROGRAM ................................................................... 20

April 21, 1999

ix

990-240-00

AGS 2.03 User Manual

Manual Version A

Table of Contents

Conventions Used in this Manual:

The following conventions are used in this manual where parameters and parameter lists
are discussed:
<parameter>

indicates a required parameter

<<parameter>>

indicates an optional parameter

Where the parameter is a file, the filename or filename placeholder are in lower case
italic: <filename.ext>
Where the parameter is a numerical value, the parameter is in upper case: <LEVEL>
Where the parameter list is an actual example, no italics or brackets are used.
Acronyms, commands (such as PLAY, SOUND) and computer keys (such as ESCAPE,
ENTER) are represented in upper case. File names and filename extensions, in general
discussions, are also generally represented in upper case.
Trademarked Mikohn products are represented in small caps; for example,
MONEYTIME.

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 1

Manual Version A

1.

Overview and Introduction

Overview

Mikohn Gaming Corporations ADVANCED GRAPHIC SOFTWARE (AGS 2.03) is PCbased software that provides the output for displaying graphics and progressive values
on a variety of displays.
AGS, which was designed to run on Mikohn LCD Boxes and Mikohn Plasma Paks,
supports the display of triggered graphics for use with Merchandising controllers, and
also the display of progressive windows for use with both Mikohn controllers and IGT
CCOM devices. AGS displays the information (graphics or progressive amounts) on
Plasma Displays, LCD units and any type of VGA monitor. When used with a Mikohn
controller, AGS supports the same basic Progressive functions as the SUPREME Logic
Board. AGS does not support JPWin files.

Note:

For more information about LCDs and plasma displays, see Appendix A
- About LCDs and Plasma Displays on page 11.
1.1

Minimum System Requirements for AGS 2.03:

Hardware:

100 Mhz Pentium (running MS-DOS)

8 MB RAM

1 GB Hard Drive

1 Sound Card (Sound Blaster-compatible)

Software and Drivers:

MS-DOS Version 6.x operating system

DOS4GW.EXE executable file

VESA video driver (if not supported on hardware)

Sound Card driver

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 1

Manual Version A

Overview and Introduction

THIS PAGE INTENTIONALLY LEFT BLANK

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

Installation and Configuration

2.

Installation and Configuration

2.1

Required Files

The following files must be in the application directory in order for AGS 2.03 to run:

AGS.EXE Main Program File

DOS4GW.EXE Required by AGS.exe

AGS.INI File containing initialization information for AGS

BACKGRND.BAT Batch file containing instructions for AGS to follow

Application Specific Files Graphics Files, Trigger Files, BACKGRND.BAT

files designed specifically for a single application (for example,
MONEYTIME).

Note:
The AGS.INI files, BACKGRND.BAT and AUTOEXEC.BAT files,
and application-specific files such as the TRIGGER.DO (discussed
below in sections 2.7, 2.8 and 2.10) are ASCII text files that can be easily
edited using the MS-DOS EDIT command.

2.2

Pre-Install Requirements

The driver for any sound cards present should be installed prior to installing AGS.

2.3

Installation

To install AGS 2.03 on the PC, perform the following steps.

1. Create a directory on the PC for AGS (for example,. md\AGS)
2. Copy files from the AGS disk to the created directory
3. Copy application specific files from the application disk to the created
directory
2.4

Starting AGS

To start running AGS, from the prompt type:

AGS <command line switches>
See the next section, Section 2.5, for more information about Command Line Switches.
April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

2.5

Installation and Configuration

Command Line Switches

The command line switches are parameters added to the AGS command line (at the MSDOS prompt). To run AGS, you would type AGS at the DOS prompt (for example,
C:\AGS> AGS) and press ENTER. To run AGS with specific parameters, such as
which COM port to use or what mode to start up in, you would type AGS at the DOS
prompt and add the switches to the command line. For example, you might type:
C:\AGS> AGS /S2 /P256. This example would start up AGS using COM2 as the
active COM port and configured for a s 256 color pallet.
Following is a list of Command Line Switches that can be added to the AGS command
line:

2.6

/P?

Set palette to 196 for use with meter applications. Set to 256 when
utilizing the entire 256 color palette (and no meter.)

/N

No Sound Do not initialize or use sound

/S1

Use COM1 (communication port #1)

/S2

Use COM2 (communication port #2)

/V?

Set the sound volume (0-7)

/M0

Set the Video Mode to (320x200x256.) DEFAULT

/M1

Set the Video Mode to (640x400x256.) Requires VESA (not frequently

used)

/M2

Set the Video Mode to (640x480x256.) Requires VESA

/M3

Set the Video Mode to (800x600x256.) Requires VESA (not frequently

used)

/M4

Set the Video Mode to (1024x768x256.) requires VESA (not frequently

used)

/M5

Set the Video Mode to (1280x1024x256.)

frequently used)

Requires VESA (not

Exiting AGS

To exit AGS, simply press the ESCAPE (Esc) key.

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

2.7

Installation and Configuration

The AGS.INI File

When the AGS program starts up, it has to run an initialization (.INI) file to establish the
initial conditions and preferences. The AGS.INI file identifies the group address and
machine to which the system will send the defined graphic response to any given system
communication. The following sections can be used in the AGS.INI file:

Note:
All sections except [VIDEOGRAND] and [MACHINE] are applicable
only to meters.
[GROUP]

Defines the group address. The default is 0.

[MACHINE]

Defines which machine the AGS program is set to.

[VIDEOGRAND]

Defines what is the video granularity of the video adapter

(Only if VESA is used. Only 1,4, 16 and 64 are valid. 1 is
default.)*

[SERIAL]

The serial mode to use CCOM is IGT CCOM, and the

default is MIKOHN.

[ODSPEED]

Defines what odometer speed to use. The range is 2

through 99. 10 is the default, but if using CCOM it is best
to use 3 to keep the odometer moving.

[COMTIME]

Set C1 communications timeout (the default is 5

seconds). The range is 0

C1 messages (the default is 0, show C1 messages).

Note:
C1 functions apply only when using a meter application.

* If the video display is not correct, change this value.

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

2.8

Installation and Configuration

Configuring the Backgrnd.bat File

As stated earlier, the BACKGRND.BAT file must reside in the application directory.
After the software initializes (processes its command line parameters and then reads the
AGS.INI), it will read and execute commands from the BACKGRND.BAT file. The
following six (6) application-specific commands may be included in the
BACKGRND.BAT file:

PLAY

Plays the specified animation file.

TRIGGER

Waits for the specified trigger and, when it is

detected, calls the file to be triggered.

PRGSV

Progressive Application Command - Contains

information about locations and sizes of
progressive meter windows.

SOUND

Plays the specified sound file.

VOLUME

Sets the volume.

MODE

Sets the video mode.

2.8.1 Backgrnd.bat Command Line Descriptions

PLAY <filename.ext> <<TIMES>> <<DELAY>>
Plays an .FLI animation file where:

<filename.ext> is the name of the file to display

<<TIMES>>

the number of times to repeat the animation. This is optional.

The default is 1, and -1 repeats continuously.

<<DELAY>> sets the number of milliseconds to delay between frames. This

is optional. The default is 35.
Note: The filenames extension (.EXT) will probably be .FLI or .FLC.

TRIGGER <filename.do>
Responds to Jackpot Trigger Device (JPTD)-type command protocols to play
.FLI animations or command files. The .DO file is read and the .FLI animations
played as directed by JPTD settings.

Note:
For every Mikohn application running under AGS and requiring a
TRIGGER.DO file, Mikohn will provide that file. Do not touch this file
except under extenuating circumstancesthen, consult your Mikohn
technician.
April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

Installation and Configuration

PRGSV <filename.pdf> (Meter Application)

The PRGSV application is set up with a definition file. This Progressive
Definition File (.PDF) contains all the information about the window locations
and sizes and the message files for each window. Without a .PDF file, the
PRGSV application will not execute. The format for a .PDF is as follows:
TEMPLATE: <filename.pcx> to load the FILENAME.PCX image
as the background graphic template
OR
TEMPLATE: <filename.flc> to load the FILENAME.FLC FLI
image as the background graphic template
Wn: <X1, Y1, X2, Y2, MFILE, GROUP, FONT> to open a metered
window with given parameters. n is a number from 0 to 7.

.PDF Command Descriptions

The TEMPLATE command specifies the user-defined Background Image file.

Only one TEMPLATE command can be used in each .PDF. You can choose
<filename.pcx> or <filename.flc> Background Image files. An .FLC file is an
animated graphic and a .PCX file is a still image.
The Wn command allows the user to select and open one of eight windows (0-7)
with the given parameters, defined as follows:
X1, Y1, X2, and Y2 define the upper left and lower right coordinates (on
the display) of the meter window to be opened. Their ranges are current
resolution 1. For example, with resolution at 320X200, the ranges are 0319 for X and 0-199 for Y.
MFILE is a set of pre-defined message format files, formerly used to protect customers
from having to perform complex message programming. These predefined messages,
however, do not function with the advanced background templates (TEMPLATE)
used with new applications, and are not used.
Note: MFILE is NO LONGER USED.
GROUP is the number of the specific jackpot group (0-7) whose value is
to be displayed.
FONT sets the Mikohn font for the display. It is important to define this
because the default is six pixels. (Note: the desired font must be in the
application directory.)
SOUND <filename.wav>
Play the sound file.
VOLUME<LEVEL>
Sets the volume level, from 0 to 7

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

Installation and Configuration

MODE <MODE NUMBER>

Sets the video mode, from 0 to 5, where:

MODE 0 = 320 by 200

MODE 1 = 640 by 400
MODE 2 = 640 by 480
MODE 3 = 800 by 600
MODE 4 = 1024 by 768
MODE 5 = 1280 by 1024
2.8.2 Example BACKGRND.BAT to play graphics files and sound

SOUND ATTRACT.WAV
PLAY ATTRACT.FLC
PLAY MIKLOGO.FLC
The above BACKGRND.BAT file is written to play a sound file called
ATTRACT.WAV, then play the graphic files ATTRACT.FLC and MIKLOGO.FLC.
Once the MIKLOGO.FLC has finished playing, the BACKGRND.BAT file repeats
from the start
2.8.3 Example BACKGRND.BAT to play a TRIGGER file

TRIGGER TRIGGER.DO
The above BACKGRND.BAT file is written to play a trigger file called TRIGGER.DO.
Once the trigger file has started, it will loop with out end. Therefore any other
command within the BACKGRND.BAT file after the trigger command will not be run.
2.8.4 Example BACKGRND.BAT to play a graphics file and a Progressive
Meter Application

PLAY MIKLOGO.FLC 2
PRGSV LEVEL1.PDF 90
The above BACKGRND.BAT file is written to play a graphic file called
MIKLOGO.FLC two times then display a Progressive Meter window, as specified by
LEVEL1.PDF, for 90 seconds.

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

2.9

Installation and Configuration

The CMD (Command) File

The .CMD (command) file is similar to the BACKGRND.BAT file in that it contains a
list of commands to be carried out by AGS. This file is executed when a trigger
command is received from a controller.
The .CMD file is executed through the .DO file. All of the commands in the .CMD file
will be executed each time it is commanded in the .DO file. The .CMD file may contain
any of the following commands:
PLAY<filename><DELAY>

Plays the FLI animation with the specified delay

between frames (DELAY is optional 35ms
default)

SOUND< filename >

Plays the sound file

VOLUME<LEVEL>

Sets the volume (0 to 7)

SERIAL<STRING>

Sends out a string command to other peripheral

devices on the serial line

DISABLE ON

Animation is uninterruptible until End of File

(EOF) or DISABLE OFF command

DISABLE OFF

Animation is interruptible (this is the default)

REPEAT

Sets a pointer. When the EOF of the .CMD file

is read, the application will rewind the file back to
this point. Only one REPEAT command is
allowed in each .CMD file.

The following is a sample .CMD file:

SOUND <sound1.wav> Start playing the SOUND1.WAV sound file
PLAY <file1.flc>

Play FILE1.FLC (only on the first execution of the file)

REPEAT

Set the repeat point; the next execution of this file starts here

PLAY <file2.flc>

Play only this file until the JPTD state changes

April 21, 1999

990-240-00

AGS 2.03 User Manual

Chapter 2

Manual Version A

Installation and Configuration

Notes about the commands in the .CMD file:

These commands are not the same as the similar commands used in the
BACKGRND.BAT file.

The PLAY command is a blocking command. When the command to PLAY

a file is executed, the .DO file will not proceed until that action is complete.
The SOUND command is a non-blocking command. When it is executed,
the .DO file continues to the next command. This is how sounds and
animations are run concurrently on the display device.

When an .FLI file is called out, if there is a .WAV file with the same file
name, it will run concurrently.

If you write your own .FLI files they must be converted with the Mikohn
converter utility, which will allow them to run properly on the AGS system
under the following conditions:
1. If the file was created in 256 color mode and is being used as a
background for a progressive meter.
2. If the file was created in 256 color mode and AGS in not being run in
256 color mode.

2.10 How to Set Up Autoexec.bat

To Play Sound
The SET BLASTER = ? statement must be in AUTOEXEC.BAT in order to play
sound. Insertion of this statement should be taken care of automatically during
installation of the software driver. If it is not, try re-installing the driver.
To run AGS on PC bootup
To run AGS on PC bootup place the following lines at the end of the
AUTOEXEC.BAT file:
CD\<AGS DIRECTORY>
AGS <Parameter List>
For more information about the Parameter List, and how to format it, see Section 2.5,
Command Line Switches.

April 21, 1999

10

990-240-00

AGS 2.03 User Manual

Appendix A

Manual Version A

About LCDs and Plasma DisplaYS

Appendix A - About LCDs and Plasma Displays

The Mikohn LCD (Liquid Crystal Display) is a small (7 inch x 5.25 inch) display screen
with a 320x200 resolution driven by software in an attached computer.
The Plasma display is a large flat panel unit capable of displaying VGA graphics. The
typical plasma display is 42 in diagonal measure.
The LCD and computer are combined in one unit that is installed in gaming machines.
The unit adds 256-color animation and sounds to Mikohn games such as
MONEYTIME or HOT POTATO.
S
P
E
A
K
E
R

K
E
Y
B
O
A
R
D

V
G
A

C R
O S
M
2
1 3
2

C R
O S
M
4
2 8
5

Top View

It's Money
Time!
Front View
Figure A.1 Sketch of Liquid Crystal Display box
April 21, 1999

11

990-240-00

AGS 2.03 User Manual

Appendix A

Manual Version A

About LCDs and Plasma DisplaYS

Consult the figure below for a better understanding of connections to the plasma display
via Mikohns plasma pack.

Male/Male VGA Cable

VGA Splitter
DIP Switch Settings
1 Down
2 Up
3 Down
4 Up

Male/Male VGA Cable

RS485 Distribution
Board
Display Data From DCU
Distributuion Board
Jumper Settings
For RS485 to RS232

RS232
Connection

Male/Male VGA Cable

Standard Programming
Cable Will Work

DRIVE ACCESS LED

JP 20,21,13

NETWORK PORT (RJ45)

RS232 PORT

MOUSE PORT
VGA OUTPUT

PARALLEL / KEY PORT

KEYBOARD PORT

I
O

POWER SWITCH

CONNECTOR VIEW OF PLASMA PAK

Note: VGA Splitter comes with

one (1) male/male VGA cable

6700 S. Paradise Rd. Suite E. Las Vegas, Nevada 89119

Figure A.2 Connector View of Plasma Pak

April 21, 1999

12

990-240-00

AGS 2.03 User Manual

Appendix B

Manual Version A

How to Set Up MONEYTIME

Appendix B - How to Set Up MONEYTIME

1. Verify that the AGS directory contains the file BACKGRND.BAT. If it
does not, create the file.
2. Verify that the BACKGRND.BAT file contains the command
TRIGGER TRIGGER.DO. (This should be the only line in the .BAT file.)
If the command line is not there, create it.
3. Insure that the necessary MONEY.DO file has been provided by Mikohn,
on the application-specific disk. Place the MONEY.DO file in the AGS
directory. The file should look like this:
?????????????101 BONUS-EL.FLC
?????????????100 ELIGIBLE.FLC
?????????????000 ATTRACT.FLC
?????????????001 BONUS.FLC
00000000??????1? WIN0.FLC
00000001??????1? WIN1.FLC
00000010??????1? WIN2.FLC
00000011??????1? WIN3.FLC
00000100??????1? WIN4.FLC
00000101??????1? WIN5.FLC
00000110??????1? WIN6.FLC
00000111??????1? WIN7.FLC
4. Verify that the following files are in the AGS directory. If not, download
them.
BONUS-EL.FLC
ELIGIBLE.FLC
ATTRACT.FLC
BONUS.FLC
WIN0.FLC
WIN1.FLC
WIN2.FLC
WIN3.FLC
WIN4.FLC
WIN5.FLC
WIN6.FLC
WIN7.FLC

April 21, 1999

13

990-240-00

AGS 2.03 User Manual

Appendix B

Manual Version A

How to Set Up MONEYTIME

About .DO File Line Structure

The .DO file is limited to 100 commands using the following format, where X is
replaced by 0 if the relay output is low and 1 if the relay output is high, or ? if the value
of that character is unimportant (disregarded by the triggering process):
XXXXXXXXXXXXXXXX<FLI_FILENAME>
XXXXXXXXXXXXXXXX<COMMAND_FILENAME>
The following is another sample .DO file:
???????????????0 IDLE.FLC

Play IDLE.FLC file when the last bit is low

???????????????1 JACKPOT.CMD

Process JACKPOT.CMD file while last bit is high

Ambiguous cases are resolved by the priority given to the left-most digit. For example,
????????1??????0 JACKPOT.CMD would be keyed to an activation of that signal. The
activation or deactivation of the later signal would be ignored.

April 21, 1999

14

990-240-00

AGS 2.03 User Manual

Appendix C

Progressive Application for Mikohn Graphic Displays

Appendix C How to Set Up HOT POTATO

When setting up a Mikohn graphic display to support the HOT POTATO application, be
sure to perform the following steps:
1. Verify that the AGS directory contains the file BACKGRND.BAT. If it does
not, create the file.
2. Verify that the BACKGRND.BAT file contains the command TRIGGER
TRIGGER.DO. If it does not, enter the command.
3. The TRIGGER.DO file should look like:
?????????????000 default.flc
?????????????001 attract.flc
00000000?????010 trans2.flc
00000001?????010 trans3.flc
00000010?????010 trans5.flc
00000011?????010 trans10.flc
00000100?????010 trans15.flc
00000101?????010 trans30.flc
00000000?????011 elig2x.flc
00000001?????011 elig3x.flc
00000010?????011 elig5x.flc
00000011?????011 elig10x.flc
00000100?????011 elig15x.flc
00000101?????011 elig30x.flc
00000000?????110 2xwin.cmd
00000001?????110 3xwin.cmd
00000010?????110 5xwin.cmd
00000011?????110 10xwin.cmd
00000100?????110 15xwin.cmd
00000101?????110 30xwin.cmd

April 21, 1999

15

990-240-00

AGS 2.03 User Manual

Appendix C

Progressive Application for Mikohn Graphic Displays

4. In addition to the basic program file, BACKGRND.BAT and

TRIGGER.DO, verify that the following files are in the AGS directory. If
not, copy them from the supplied disk into the AGS directory.
2XWIN.FLC

3XWIN.FLC

5XWIN.FLC

10XWIN.FLC

15XWIN.FLC

30XWIN.FLC

2XWIN.CMD

3XWIN.CMD

5XWIN.CMD

10XWIN.CMD

15XWIN.CMD

30XWIN.CMD

ATTRACT.FLC

DEFAULT.FLC

DEF1.FLC

ELIG2X.FLC

ELIG3X.FLC

ELIG5X.FLC

ELIG10X.FLC

ELIG15X.FLC

ELIG30X.FLC

TRANS2.FLC

TRANS3.FLC

TRANS5.FLC

TRANS10.FLC

TRANS15.FLC

TRANS30.FLC

Note:
HOT POTATO is run on IGT Vision Series machines which have their
own LCD unit and do not require AGS. AGS is used for the overhead
signage driving a Plasma Display using video mode 2 (i.e. switch /M2).

April 21, 1999

16

990-240-00

AGS 2.03 User Manual

Appendix D

Progressive Application for Mikohn Graphic Displays

Appendix D
Progressive Applications for Mikohn Graphic Displays

Mikohns graphic displays have an optional progressive application to display up to eight

(8) progressive windows simultaneously on a user-defined background. This allows an
infinite number of configurations to present progressive values in a casino. The user
controls various aspects of the presentation, such as:
1. Size of up to eight (8) windows (areas filled with progressive values).
2. Location of up to eight (8) windows.
3. Message content for one (1) window, selectable default messages for
remaining windows.
4. Template for background image.
5. Active jackpot groups to represent.
The progressive application uses two (2) files; one required and one optional. The first
file (a .PDF Progressive Definition File see next header) is required, and contains
coordinates and various parameters for progressive windows. The second file, optional,
is the background image template file (having the extension .PIC, .PCX or .FLI) which
displays a user-defined background.
Progressive Definition File (.PDF)
The progressive definition file, sometimes called a .PDF file, is an ASCII text file with a
.PDF extension. The .PDF file can be created from EDLIN or any text editor that
doesnt use control characters. The format of the definition file is as follows:
TEMPLATE: <filename.ext>
WO:<X1,Y1,X2,Y2,GROUP,MFILE>
W1:<X1,Y1,X2,Y2,GROUP,MFILE>
W2:<X1,Y1,X2,Y2,GROUP,MFILE>
W3:<X1,Y1,X2,Y2,GROUP,MFILE>
W4:<X1,Y1,X2,Y2,GROUP,MFILE>
W5:<X1,Y1,X2,Y2,GROUP,MFILE>
W6:<X1,Y1,X2,Y2,GROUP,MFILE>
W7:<X1,Y1,X2,Y2,GROUP,MFILE>
Figure 1 Progressive Definition File

The TEMPLATE:<filename.ext> field defines the background image template file.

This graphic file is placed behind the displayed windows, to act as a background. The
filename is in the following format:
April 21, 1999

17

990-240-00

AGS 2.03 User Manual

Appendix D

Progressive Application for Mikohn Graphic Displays

FILENAME.EXT Filename Format:

Maximum of eight (8) character filenames, hence filename.

Filenames suffix must be .PIC.

File must be present in the displays directory. If file isnt found, then a black
background will be the default.

Example:

TEMPLATE:mikohn.pic

Note:
Make sure filenames are copied exactly. Include all commas, periods and
spaces, since the program will not run if filenames are incorrect.
The windows are defined by beginning a new line with a W followed by a number
from 0 to 7 (for the window number) and a colon :. Following the colon are the
window coordinates, which are defined as (x1,y1) for the upper-left corner and (x2,y2)
for the lower-right corner of the window. Window coordinates must meet the following
criteria:

(x1, y1)

(x2, y2)

where:
1)
2)
3)
4)
5)

x1 must be less than or equal to (x2 -4) but greater than 1

y2 must be greater than or equal to y1
1 <= x1 <= x2 <= maximum display width
1 <= y1 <= y2 <= maximum display height
x1 must be a multiple of four plus one,
i.e. x1 = ((x1 div 4) X 4 + 1)
6) x2 must be a multiple of four, i.e. x2 = ((x2 div 4) X 4)
7) y1 can be on any row
8) y2 must be a multiple of eight from (y1 - 1)
i.e. y2 = ((window height div 8) X 8 +(y1 -1)
9) maximum window width and height is 180 X 24
10) at least one (1) window must be defined.

Figure C.2 Window Coordinates

April 21, 1999

18

990-240-00

AGS 2.03 User Manual

Appendix D

Progressive Application for Mikohn Graphic Displays

The GROUP field specifies which jackpot group for which the window will display
winner information. That is, if a jackpot occurs on the specified group, the window will
display a winning amount and/or a winning machine number. The valid range for
GROUP specifications are 0 7.
The MFILE field is a message field, which, for older Mikohn display programs,
carries a message defining a default graphics file

Note:
MFILE is not used by Mikohns AGS (Advanced Graphics System).
The only MFILE specifications that are valid are:
0: user-defined JPOT.DO, JACK1.DO, JACK2.DO, JACK3.DO and JACK4.DO
files. (CHAMELEON fashion)
1: default message which displays the value of the active jackpot in red.
2: default message which displays the value of the active jackpot in green.
3: default message which displays the value of the active jackpot in yellow.
4: default message which displays the value of the active jackpot in a dancing color
pattern.
5: default message which displays the value of the active jackpot with red color, and
paint.
6: default message which displays the value of the active jackpot with green color, and
paint.
7: default message which displays the value of the active jackpot with yellow color,
and paint.
8: default message which displays the value of the active jackpot with dancing color
pattern, and paint.
Example:
W0:13,53, 168, 60,0,0
defines a window 155 X 7 display JP0 in Chameleon mode.

Template File
The template file is a picture filethe graphic background for the overlaid windows. For
AGL applications, the extension will be .PIC. For SUPREME applications, the extension
will be .PCX. With Mikohns AGS, the extension will be .PCX or .FLI.

April 21, 1999

19

990-240-00

AGS 2.03 User Manual

Appendix D

Progressive Application for Mikohn Graphic Displays

Arguments to Progressive Application Program

To invoke the progressive application, modify the BACKGRND.BAT file so that it
contains a line with the following:
PRGSV xxxxxxxx.pdf/Tyyy
where the user must fill in the xs and ys with the appropriate information. The fields
containing xs and ys are called command line arguments. The command line arguments
must be listed in the following order:
1. The definition filename (xxxxxxxx) must have the extension .PDF (PDF stands
for Progressive Definition File). If no definition file is given, the progressive
application will abort, thus allowing the display to run the next command in
BACKGRND.BAT. If a definition file is specified, but isnt present in the display,
then the display resorts to an internal default definition file similar to this:
TEMPLATE:
W0:13,53,168,60,0,0
2. The duration for running the progressive application is specified in seconds replacing
the yyy parameters (/T stands for time) like this:
/T600
This would specify 600 seconds, or 10 minutes.
Example:
PRGSV MIKOHN.PDF /T120
This command string does the following:
1. Invokes progressive application program
2. Using the MIKOHN.PDF definition file
3. For a duration of 2 minutes (120 seconds).

April 21, 1999

20

990-240-00