CA2460046C - Method for developing gaming programs compatible with a computerized gaming operating system and apparatus - Google Patents

Method for developing gaming programs compatible with a computerized gaming operating system and apparatus Download PDF

Info

Publication number
CA2460046C
CA2460046C CA2460046A CA2460046A CA2460046C CA 2460046 C CA2460046 C CA 2460046C CA 2460046 A CA2460046 A CA 2460046A CA 2460046 A CA2460046 A CA 2460046A CA 2460046 C CA2460046 C CA 2460046C
Authority
CA
Canada
Prior art keywords
gaming
game
operating system
sgos
data
Prior art date
Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
Expired - Fee Related
Application number
CA2460046A
Other languages
French (fr)
Other versions
CA2460046A1 (en
Inventor
Mark D. Jackson
Current Assignee (The listed assignees may be inaccurate. Google has not performed a legal analysis and makes no representation or warranty as to the accuracy of the list.)
International Game Technology
Original Assignee
International Game Technology
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by International Game Technology filed Critical International Game Technology
Publication of CA2460046A1 publication Critical patent/CA2460046A1/en
Application granted granted Critical
Publication of CA2460046C publication Critical patent/CA2460046C/en
Anticipated expiration legal-status Critical
Expired - Fee Related legal-status Critical Current

Links

Classifications

    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F8/00Arrangements for software engineering
    • G06F8/20Software design
    • GPHYSICS
    • G07CHECKING-DEVICES
    • G07FCOIN-FREED OR LIKE APPARATUS
    • G07F17/00Coin-freed apparatus for hiring articles; Coin-freed facilities or services
    • G07F17/32Coin-freed apparatus for hiring articles; Coin-freed facilities or services for games, toys, sports, or amusements
    • GPHYSICS
    • G07CHECKING-DEVICES
    • G07FCOIN-FREED OR LIKE APPARATUS
    • G07F17/00Coin-freed apparatus for hiring articles; Coin-freed facilities or services
    • G07F17/32Coin-freed apparatus for hiring articles; Coin-freed facilities or services for games, toys, sports, or amusements
    • G07F17/3202Hardware aspects of a gaming system, e.g. components, construction, architecture thereof
    • GPHYSICS
    • G07CHECKING-DEVICES
    • G07FCOIN-FREED OR LIKE APPARATUS
    • G07F17/00Coin-freed apparatus for hiring articles; Coin-freed facilities or services
    • G07F17/32Coin-freed apparatus for hiring articles; Coin-freed facilities or services for games, toys, sports, or amusements
    • G07F17/3225Data transfer within a gaming system, e.g. data sent between gaming machines and users
    • G07F17/323Data transfer within a gaming system, e.g. data sent between gaming machines and users wherein the player is informed, e.g. advertisements, odds, instructions
    • GPHYSICS
    • G07CHECKING-DEVICES
    • G07FCOIN-FREED OR LIKE APPARATUS
    • G07F17/00Coin-freed apparatus for hiring articles; Coin-freed facilities or services
    • G07F17/32Coin-freed apparatus for hiring articles; Coin-freed facilities or services for games, toys, sports, or amusements
    • G07F17/3225Data transfer within a gaming system, e.g. data sent between gaming machines and users
    • G07F17/3232Data transfer within a gaming system, e.g. data sent between gaming machines and users wherein the operator is informed
    • GPHYSICS
    • G07CHECKING-DEVICES
    • G07FCOIN-FREED OR LIKE APPARATUS
    • G07F17/00Coin-freed apparatus for hiring articles; Coin-freed facilities or services
    • G07F17/32Coin-freed apparatus for hiring articles; Coin-freed facilities or services for games, toys, sports, or amusements
    • G07F17/3225Data transfer within a gaming system, e.g. data sent between gaming machines and users
    • G07F17/3232Data transfer within a gaming system, e.g. data sent between gaming machines and users wherein the operator is informed
    • G07F17/3237Data transfer within a gaming system, e.g. data sent between gaming machines and users wherein the operator is informed about the players, e.g. profiling, responsible gaming, strategy/behavior of players, location of players
    • G07F17/3239Tracking of individual players
    • AHUMAN NECESSITIES
    • A63SPORTS; GAMES; AMUSEMENTS
    • A63FCARD, BOARD, OR ROULETTE GAMES; INDOOR GAMES USING SMALL MOVING PLAYING BODIES; VIDEO GAMES; GAMES NOT OTHERWISE PROVIDED FOR
    • A63F2300/00Features of games using an electronically generated display having two or more dimensions, e.g. on a television screen, showing representations related to the game
    • A63F2300/60Methods for processing data by generating or executing the game program
    • A63F2300/6009Methods for processing data by generating or executing the game program for importing or creating game content, e.g. authoring tools during game development, adapting content to different platforms, use of a scripting language to create content
    • A63F2300/6018Methods for processing data by generating or executing the game program for importing or creating game content, e.g. authoring tools during game development, adapting content to different platforms, use of a scripting language to create content where the game content is authored by the player, e.g. level editor or by game device at runtime, e.g. level is created from music data on CD

Abstract

The present invention in various embodiments provides a computerized wagering game method and apparatus that features an operating system kernel (201), a system handler application (202) that loads and executes gaming program shared objects (203) and features nonvolatile storage (204) that facilitates sharing of information between gaming program objects (203). The system handler of some embodiments further provides an API library of functions callable from the gaming program objects (203), and facilitates the use of callback functions on change of data stored in nonvolatile storage (204). The nonvolatile storage (204) also provides a nonvolatile record of the state of the computerized wagering game, providing protection against loss of the game state due to power loss. The system handler application (202) in various embodiments includes a plurality of device handlers (210), providing an interface to selected hardware and the ability to monitor hardware-related events.

Description

METHOD FOR DEVELOPING GAMING PROGRAMS COMPATIBLE
WITH A COMPUTERIZED GAMING OPERATING SYSTEM AND
APPARATUS
NOTICE OF COPENDING APPLICATIONS
This application is a non-provisional application claiming priority from Provisional Patent Application Serial No. 60/318,369 filed September 10, 2001, entitled: Method for Developing Gaming Programs Compatible with a Computerized Gaming Operating System and Apparatus (Attorney Docket No. PA0616.ap.US).
BACKGROUND OF THE INVENTION
1. Field of the Invention The present invention relates to wagering games, particularly computer based wagering games, computer based wagering games running on an operating system, and methods for developing games on a standard gaming operating system.
2. Background of the Art Games of chance have been enjoyed by people for thousands of years and have enjoyed increased and widespread popularity in recent times. As with most forms of entertainment, players enjoy playing a wide variety of games and new games. Playing new games adds to the excitement of "gaming." As is well known in the art and as used herein, the term "gaming" and "gaming devices" are used to indicate that some form of wagering is involved, and that players must make wagers of value, whether actual currency or some equivalent of value, e.g., token or credit.
This is an accepted distinction in the art from the playing of games, which implies the lack of value depending upon the outcome and in which skill is ordinarily an essential part of the game. On the contrary, within the gaming industry, particularly in computer based gaming systems, the absence of skill is a jurisdictional requirement in the performance of the gaming play.
One popular gaming system of chance is the slot machine. Conventionally, a slot machine is configured for a player to wager something of value, e.g., currency, house token, established credit or other representation of currency or credit.
After the wager has been made, the player activates the slot machine to cause a random event to occur. The player wagers that particular random events will occur that will return value to the player. A standard device causes a plurality of reels to spin and ultimately stop, displaying a random combination of some form of indicia, for example, numbers or symbols. If this display contains one of a pre-selected number of winning symbol combinations, the machine releases money into a payout chute or increments a credit meter by the amount won by the player. For example, if a player initially wagered two coins of a specific denomination and that player achieved a payout, that player may receive the same number or multiples of the wager amount in coins of the same denomination as wagered.
There are many different formats for generating the random display of events that can occur to determine payouts in wagering devices. The standard or original format was the use of three reels with symbols distributed over the face of the reel.
When the three reels were spun, they would eventually each stop in turn, displaying a combination of three symbols (e.g., with three reels and the use of a single horizontal payout line as a row in the middle of the area where the symbols are displayed). By appropriately distributing and varying the symbols on each of the reels, the random occurrence of predetermined winning combinations can be provided in mathematically predetermined probabilities. By clearly providing for specific probabilities for each of the pre-selected winning outcomes, precise odds that would control the amount of the payout for any particular combination and the percentage return on wagers for the house could be reasonably controlled.
Other formats of gaming apparatus that have developed in a progression from the pure slot machine with three reels have dramatically increased with the development of video gaming apparatus. Rather than have only mechanical elements such as wheels or reels that turn and stop to randomly display symbols, video gaming apparatus and the rapidly increasing sophistication in hardware and software have enabled an explosion of new and exciting gaming apparatus. The earlier video apparatus merely imitated or simulated the mechanical slot games in the belief that players would want to play only the same games. Early video gaming systems therefore were simulated slot machines. The use of video gaming apparatus to play new gaming applications such as draw poker and Keno broke the ground for the realization that there were many untapped formats for gaming apparatus. Now casinos may have hundreds of different types of gaming apparatus with an equal number of significant differences in play. The apparatus may vary from traditional three reel slot machines with a single payout line, video simulations of three reel video slot machines, to five reel, five column simulated slot machines with a choice of twenty or more distinct pay lines, including randomly placed lines, scatter pays, or single image payouts. In addition to the variation in formats for the play of gaming applications, bonus plays, bonus awards, and progressive jackpots have been introduced with great success. The bonuses may be associated with the play of gaming applications that are quite distinct from the play of the original gaming format, such as the video display of a horse race with "bets" on the individual horses randomly assigned to players that qualify for a bonus, the spinning of a random wheel with fixed amounts of a bonus payout on the wheel (or simulation thereof), or attempting to select a random card that is of higher value than a card exposed on behalf of a virtual "dealer."
Examples of such gaming apparatus with a distinct bonus feature includes U.S. Patent Nos. 5,823,874; 5,848,932; 5,836,041; U.K. Patent Nos. 2 201 821 A; 2 202 984 A; and 2 072 395A; and German Patent DE 40 14 477 AL Each of these patents differs in fairly subtle ways as to the manner in which the bonus round is played. British Patent 2 201 821 A and DE 37 00 861 A1 describe a gaming apparatus in which after a winning outcome is first achieved in a reel-type gaming segment, a second segment is engaged to determine the amount of money or extra games awarded. The second segment gaming play involves a spinning wheel with awards listed thereon (e.g., the number of coins or number of extra plays) and a spinning arrow that will point to segments of the wheel with the values of the awards thereon. A player will press a stop button and the arrow will point to one of the values. The specification indicates both that there is a level of skill possibly involved in the stopping of the wheel and the arrow(s), and also that an associated computer operates the random selection of the rotatable numbers and determines the results in the additional winning game, which indicates some level of random selection in the second gaming segment.
U.S. Patents Nos. 5,823,874 and 5,848,932 describe a gaming device comprising:
a first, standard gaming unit for displaying a randomly selected combination of indicia, said displayed indicia selected from the group consisting of reels, indicia of reels, indicia of playing cards, and combinations thereof; means for generating at least one signal corresponding to at least one select display of indicia by said first, standard gaming unit; means for providing at least one discernible indicia of a mechanical bonus indicator, said discernible indicia indicating at least one of a plurality of possible bonuses, wherein said providing means is operatively connected to said first, standard gaming unit and becomes actuatable in response to said signal. In effect, the second gaming event simulates a mechanical bonus indicator such as a roulette wheel or wheel with a pointing element.
A video terminal is another form of gaming device. Video terminals operate in the same manner as a conventional slot and video machine, except that a redemption ticket rather than an immediate payout is dispensed. The processor may be present in the terminal or in a central computer.
The vast array of electronic video gaming apparatus that is commercially available is not standardized within the industry or necessarily even within the commercial line of apparatus available from a single manufacturer. One of the reasons for this lack of uniformity or standardization is the fact that the operating systems that have been used to date in the industry are primitive. As a result, the programmer must often create code for each and every function performed by each individual apparatus.
Attempts have been made to create a universal gaming engine for a gaming machine and are described in Carlson U.S. Patent 5,707,286. This patent describes a universal gaming engine that segregates the random number generator and transform algorithms so that this code need not be rewritten or retested with each new game application. All code that is used to generate a particular game is contained in a rule EPROM in the rules library. Although the step of segregating random number generator code and transform algorithms has reduced the development time of new games, further improvements were needed.
One significant economic disadvantageous feature with commercial video wagering gaming units that maintains an artificially high price for the systems in the market is the use of unique hardware interfaces in the various manufactured video gaming systems. The different hardware, the different access codes, the different pin couplings, the different harnesses for coupling of pins, the different functions provided from the various pins, and the other various and different configurations within the systems has prevented any standard from developing within the technical field. This is advantageous to the equipment manufacturer, because the gaming formats for each system are provided exclusively by a single manufacturer, and the entire systems can be readily rendered obsolete, so that the market will have to purchase a complete unit rather than merely replacement software, and aftermarket gaming designers cannot easily provide a single gaming application that can be played on different hardware.
The invention of computerized gaming systems that include a common or "universal" video wagering game controller that can be installed in a broad range of video gaming apparatus without substantial modification to the gaming apparatus controller has made possible the standardization of many components and of corresponding gaming software within gaming systems. Such systems desirably will have functions and features that are specifically tailored to the unique demands of supporting a variety of gaming applications and gaming apparatus types, and doing so in a manner that is efficient, secure, and cost-effective to operate.
What is desired is an architecture and method of providing a gaming-specific platform that features reduced game development time and efficient gaming operation, provides security for the electronic gaming system, and does so in a manner that is cost-effective for gaming software developers, gaming apparatus manufacturers, and gaming apparatus users. An additional advantage is that the use of the platform will speed the review and approval process for gaming applications with the various gaming agencies, bringing the gaming formats and gaming applications to market sooner.
The nature of gaming systems and the stringent controls applied to gaming systems and gaming applications by jurisdictional controls (e.g., the Nevada State Gaming Commission, the New Jersey State Gaming Commission, the Mississippi State Gaming Commission, the California State Gaming Commission, the United Kingdom Gaming Commission, etc.) makes the development of a standard operating system and the ability of the game developers to work with such gaming operating systems unique within the field of computer based designer/developer interactions.
One of the reasons that Microsoft Windows became the leading operating system throughout the world for personal computers was based upon its business strategy of providing access to Microsoft Windows on-line to developers using an Application Program Interface (API) through which developers could communicate with the Windows operating system, without being able to modify the underlying operating system (OS). This enabled Windows to be supported by a vast network of private developers so that significant amounts of software became available for Windows while other competing operating systems (e.g., Mac OS, Unix and Linux) had much fewer numbers of software programs available to use with these systems.
However, the Microsoft Windows operating system was not designed to support gaming systems and does not contain the essential software components needed for a gaming jurisdiction approvable operating system or gaming application.
Some game systems (as opposed to gaming systems) also attempted an on-line approach to assisting developers in using proprietary game operating systems for development of games compatible with the game operating system. One such on-line system was Adventurebuilder, which has apparently been removed from active on-line operation, even though its API addressable OS has been archived at http://archive.wustl.edu.languages/smalltalk/Smalltalk/st80_CastleMS-.../CastleMS.s and the entire 195 pages of text can be accessed at that site.
Additionally, U.S. Patent No. 6,181,336 B1 (Chiu et al.) describes a system for providing an integrated, efficient and consistent production environment for the shared development of multimedia productions. Examples of multimedia productions include feature animation films, computerized animation films, interactive video games, interactive movies, and other types of entertainment and/or educational multimedia works. The development of such multimedia products typically involves heterogeneous and diverse forms of multimedia data. Further, the production tools and equipment that are used to create and edit such diverse multimedia data are in and of themselves diverse and often incompatible with each other. The incompatibility between such development tools can be seen in terms of their methods of operation, operating environments, and the types and/or formats of data on which they operate. The common utilities, methods and services disclosed therein, are used to integrate the diverse world of multimedia productions.
By using the common utilities, methods and services provided, diverse multimedia production tools can access, store, and share data in a multiple user production environment in a consistent, safe, efficient and predictable fashion.
SUMMARY OF THE INVENTION
In accordance with one embodiment, there is provided a method for a developer to access a unique gaming operation system that can support a wide variety of gaming applications. The developer can access the operating system through an Application Program Interface (API), respond to input from the developer without alteration of the gaming components stored in the operating system, and then enables the developer, by communication with the operating system, to develop a chip, gaming unit or other software that can be communicationally connected to the operating system to play or execute a gaming application, using the operating system as the primary engine for running the gaming application. The developer is capable of using any desired software system to develop the gaming application (e.g., Windows 98, Windows NT, Windows XP, Mac OS, Unix, Linux, etc.) and still communicate to the gaming operating system through the API. The developed chip or software stored on one or more different media, such as EPROM flash memory, CD ROM, etc. or other software containing the gaming play content of a new gaming format may then be inserted into any gaming box with the host operating system by simply replacing a gaming chip CD ROM, disc or other storage media that has been developed through use of access to the operating system through the API, and that gaming application is assured of performance and can have a significantly reduced approval time through jurisdictional gaming agencies.
In various embodiments, there is provided such a method to be practiced on a computerized wagering gaming operating system and apparatus that features a proprietary operating system, such as, for a preferred example, an operating system kernel. The apparatus also may include selected device handlers and system libraries, and have other device handlers that are disabled or removed. The present invention features a system handler application that may be part of the operating system. The system handler loads and executes gaming program objects that are part of the operating system and features nonvolatile storage that facilitates sharing of information between gaming program objects. The system handler of some embodiments further provides an API library of functions callable from the gaming program shared objects, and may in some embodiments facilitate the use of callback functions on change of data stored in nonvolatile storage. A nonvolatile record of the state of the computerized wagering gaming application is stored on the nonvolatile storage, providing protection against loss of the gaming state due to power loss. The system handler application in various embodiments includes a plurality of device handlers, providing an interface to selected hardware and the ability to monitor hardware-related events.
In accordance with another embodiment, there is provided a method of generating a computer based wagering application comprising: providing a gaming operating system operable 1) to load a gaming application comprising a plurality of game program objects and to generate a wagering game on a computing system in response to information received from the gaming application, 2) to maintain a set of gaming data variables for reconstructing a state of the wagering game in response to a power loss or other malfunction on the computing system wherein the gaming operating system comprises a plurality of software components, one or more Application Program Interfaces (APIs), associated with the plurality of software components, that define information recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system, and plural gaming callback functions that allow the wagering game to be provided on the computing system, said plurality of software components and gaming callback functions compatible with one or more of a plurality of different computing systems, a plurality of different gaming applications or combinations thereof; and wherein said plurality of software components and gaming callback functions can be provided by a plurality of different software vendors, 3) to determine a vendor associated with each of the plurality of software components, the one or more APIs associated with the plurality of software components and gaming callback functions; 4) to determine whether each software component associated with the vendor is related to a presentation, a determination or a storage of win-loss information for said wagering game; 5) to determine whether the vendor is license by a gaming regulatory authority to provide software components associated with the presentation, the determination, or the storage of win-loss information for said wagering game based upon said determination of whether each software component associated with the vendor is related to the presentation, the determination or the storage of win-loss information for said wagering game; providing the one or more APIs that define the information that is recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system wherein the one or more APIs are designed or configured to allow the gaming application to at least 1) access a non-volatile memory (NV-RAM) wherein the NV-RAM is for at least storing the set of gaming data variables, 2) specify storage requirements for the NV-RAM including information related to the set of gaming data variables, 3) provide instructions related to outputting video data or audio data available with the gaming operating system, provide instructions for peripheral devices recognized by the gaming operating system wherein the instructions are translated by the gaming operating system into formats recognized by the peripheral devices, 5) request one or more random number to be generated and 6) provide gaming application specific data used in the wagering game. The method also comprises:
determining that a portion of the plurality of software game components and call back functions are required by the gaming application; providing a configuration file for running the gaming operating system on the computing system; and compiling a gaming program specific to the gaming application and that is compatible with the gaming operating system wherein the gaming program includes the portion of the plurality of software gaming components and the callback functions.
In accordance with another embodiment, there is provided a method wherein after compiling the gaming program specific to the gaming application that is compatible with the gaming operating system, the gaming program manages data in the computer based wagering game apparatus via a system handler application, where managing data comprises: loading a first game program object in the plurality of game program objects, executing the first game program object, and accessing and storing game data related to the play of the wagering game in the NV-RAM.
8a In accordance with another embodiment, there is provided a gaming machine comprising: a computerized game controller comprising a processor, an executable memory, and a non-volatile memory (NV-RAM); and a gaming application executed by the computerized game controller. The gaming machine also comprises a gaming operating system executed by the computerized gaming controller operable 1) to load the gaming application and to generate a wagering game on the gaming machine in response to information received from the gaming application and 2) to maintain a set of gaming data variables in the NV-RAM
for reconstructing a state of the wagering game in response to a power loss or other malfunction on the computing system wherein the gaming operating system comprises a plurality of software gaming components, one or more Application Program Interfaces (APIs), associated with the plurality of software components, that define information recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system and plural gaming callback functions that allow the wagering game to be provided on the computing system, said plurality of software gaming components and gaming callback functions compatible with one or more of a plurality of different gaming devices, a plurality of different gaming applications or combinations thereof;
wherein said plurality of software gaming components and gaming callback functions can be provided by a plurality of different software vendors; and 3) to determine a vendor associated with each of the plurality of software gaming components, the one or more APIs and gaming callback functions; 4) to determine whether each software component associated with the vendor is related to the presentation, the determination, or the storage of win-loss information for said wagering game; 5) to determine whether the vendor is licensed by a gaming regulatory authority to provide software components associated with the presentation, the determination or the storage of win-loss information for said wagering game based upon said determination of whether each software component associated with the vendor is related to the presentation, the determination or the storage of win-loss information for said wagering game. The gaming machine also comprises the one or more APIs that define the information that it recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system wherein the one or more APIs are designed or configured to allow the gaming operation to at least 1) access the NV-RAM wherein the NV-RAM
is for at least storing the set of game data variables, 2) specify storage requirements for the NV-RAM
8b including information related to the set of gaming data variables, 3) provide instructions related to outputting video data or audio data available with the gaming system, 4) provide instructions for peripheral devices recognized by the gaming operating system into formats recognized by the peripheral devices, 5) request one or more random number to be generated and 6) provide gaming application specific data used in the wagering game to the gaming operating system.
The gaming machine also comprises: one or more value handling devices for inputting, outputting or combinations thereof, credits on the gaming machine wherein the credits are for wagers on the wagering game; one or more input devices for providing input used to play the wagering game; and a display device for displaying the wagering game on the gaming machine.
BRIEF DESCRIPTION OF THE DRAWINGS
Figure 1 shows a computerized wagering game apparatus as may be used to practice an embodiment of the present invention.
Figure 2 shows a more detailed structure of program code executed on a computerized wagering game apparatus, consistent with an embodiment of the present invention.
Figure 3 is a diagram illustrating another exemplary embodiment of a universal gaming system according to the present invention having a universal or open operating system.
8c Figure 4 is a diagram illustrating one exemplary embodiment of a method of converting a gaming system to a gaming system having an open operating system according to the present invention.
Figure 5 is a diagram illustrating one exemplary embodiment of a set of devices used for interfacing with a device driver or handler in an open operating system in a gaming system according to the present invention.
Figure 6 is a diagram illustrating one exemplary embodiment of a resource manager used in a gaming system according to the present invention.
Figure 7 is a diagram of a table illustrating one exemplary embodiment of a resource file used in a gaming system according to the present invention.
Figure 8 is a diagram illustrating one exemplary embodiment of a cashless gaming system using the universal gaming system according to the present invention.
Figure 9 is a diagram illustrating one exemplary embodiment of configuring a game usable in a gaming system according to the present invention.
Figure 10 is a diagram illustrating another exemplary embodiment of configuring and/or storing a game on a removable media useable in a gaming system according to the present invention.
Figure 11 is a diagram illustrating another exemplary embodiment of a gaming system according to the present invention wherein the game layer is programmable or configurable via a web page at a location remote from the gaming system.
Figure 12 is a diagram illustrating one exemplary embodiment of a web page template used in the gaming system shown in Figure 11.
Figure 13 is a diagram illustrating one exemplary embodiment of nonvolatile memory used in a gaming system according to the present invention, wherein the nonvolatile memory is configured as a RAID system.
Figure 14 is a block diagram that shows the operation of API's between software components.
DETAILED DESCRIPTION OF THE INVENTION
In the following detailed description of sample embodiments of the invention, reference is made to the accompanying drawings that form a part hereof, and in which is shown by way of illustration specific sample embodiments in which the invention may be practiced. These embodiments are described in sufficient detail to enable those skilled in the art to practice the invention, and it is to be understood that other embodiments may be utilized and that logical, mechanical, electrical, and other changes may be made. The following detailed description is, therefore, not to be taken in a limiting sense, and the scope of the invention is defined only by the appended claims. It is essential to an appreciation of the practice of the present invention that the jurisdictional approval requirements and the industry standards of the gaming industry be considered in determination of the skill and technical sophistication of the present technology and invention.
In this document, the term "software component" can refer to any software module or grouping of modules. Under this definition a protocol module could be considered to be a type of software component, as could a complete operating system, or even a piece of an operating system. For the purposes of this document, a "software component" will be considered to be the set of code that an individual operating system provider provides.
The Nevada Gaming Control Board defines a gaming-related software component and uses a simple test to determine if a software subsystem falls under the definition of a gaming device. A primary element of a "Gaming Device" under NRS 463.0155 is a component that must be used remotely or directly in connection with a game (gaming application) and that affects the result of a wager by determining win or loss (based on a probability). Taking into account this definition, the Nevada Gaming Control Board uses a simple test:
if an operating system or other software component can be shown to be usable in other fields or applications and the component is not involved in the calculation of wagering win or loss, then it is not a gaming-related piece of software. Those software components that relate to the presentation, decision-making and storage of win/loss information are the ones that are of primary concern to the Commission.

Nevada gaming laws and regulations require that the "Manufacturer" of a gaming device must be licensed. Manufacturer is defined in NRS 463.0172 as one ' who: "manufactures, assembles, programs or makes modifications to a gaming device or cashless wagering system ... or who designs, controls the design or maintains a copyright over the design of a program which can't be reasonably demonstrated to have any use other than in a gaming device or cashless wagering system."
Therefore, where a gaming device contains software written by multiple vendors, an analysis must be made as to whether a gaming license is required by each vendor depending on whether the component provided by each vendor is gaming related. It may be that a vendor that supplies certain code may not have to be licensed in order for a licensed vendor to include that code on a gaming device. The complications arise when considering the different possibilities that can occur, as considered below.
The concept of trust or authenticity is the basis of all gaming regulations.
To have a high degree of confidence in the fairness, integrity and security of a gaming device, it is necessary to be able to trust that the software components really do what they have been tested for and approved to do. There are different ways to establish such trust. Providing source code and other documentation of the software component is one such method. Other methods include public key infrastructure (PKI) to authenticate game code and data, requiring that the physical storage location for the code be on unwritable media, etc. In the case of PKI authentication, it is critical that the software component that provides the authentication service has the highest level of trust. If this is not true, then the purpose is entirely lost. For the purposes of this document, it will help with clarity to refer to the software component that provides authentication services as the operating system, or just OS.
This is mainly for readability and understanding, but it is important that in systems that contain multiple software components, an OS/application type-relationship between the components is just one configuration.

Most gaming jurisdictions require devices that contain code that is stored in writable media to have an approved method to verify the integrity of the code that is stored there. Using PKI signatures is a commonly used and accepted method for such authentication. This implies that one software component inherently has a higher trust level than the one being authenticated. In gaming jurisdictions, read-only storage on EPROM with available source code has the highest level of trust because the code can be easily verified by spot-checking devices in the field. The code that exists on the EPROM will in turn check the signatures for the code stored on the writable media. Assuming things check out, the device may now proceed with operation. U.S. Patent Nos. 6,149,552; 6,106,396; 6,104,859; and 5,643,086 (The Alcorn Patents) describe various authentication techniques for use in gaming systems.
Although authentication and/or encryption systems are essential for commercial computer based gaming products, they need not be present on the system that is provided for access to the developer. The absence of the authentication system at this point in the development procedure may simplify communication and additionally speed up development. The authentication system and the encryption processes attendant thereto may be added into the commercial gaming apparatus without adversely affecting the ability of the developed gaming application or gaming rules chip to operate on the operating system.
The availability of source code mentioned above is extremely important when one considers this hierarchy of trust between software components that has to be strictly enforced in order to not compromise the integrity of the system. Only those software components that have the highest level of trust should be in a position to certify or authenticate other components. Those components that exist on writable media or do not have source code availability automatically have a lower level of trust. In the case of unlicensed vendors of operating systems with no source code available, for example, you have a situation where an untrusted, unproven software = component provides authentication to a component on writable media, which is questionable at best. That provides a complication in the development of gaming =

application software and hardware to be used on a proprietary operating system, particularly on-line (over the intemet) where identification of users may be problematic and control over secondary distribution or redistribution of the operating system and its source codes are problematic. Such uncontrolled distribution could compromise the ultimate security of the gaming apparatus in the casinos, and could lead to a refusal of gaming operators for the proprietary gaming operating system and for gaming applications provided on that operating system.
As indicated above, an API, or Application Programming Interface, is a set of methods used to interface from one communicator (e.g., a developer operating on its own computer and operating system) to a distal information component such as a software component (distal meaning over the internet, on-line, off a memory source such as compact disk, floppy disk, connected hard drive, or other information storage media with which the developer can communicate). These methods may be implemented using message passing, function calls using static or dynamic linking, or some other way. The important common function of every API is to isolate the data and low-level functions in one software component from being accessed except through the use of a common set of access methods.
The primary problem with having a number of software components existing on a single system has to do with defining the boundaries between the components.
The only way the components can be separated into completely contained pieces is to define an API to which all the components conform. As long as this is the only way in which the pieces interact, the security of the distal information component is satisfactory.
One way of overcoming the delays and difficulties in introducing gaming applications to the industry is by practicing a method within the scope of the present invention. As a first step, a gaming operating system is provided that contains objects that can be used in gaming applications and gaming apparatus (whether video gaming or reel-type gaming apparatus). This gaming operating system would include functions in a secure computing system (e.g., computer, server, microprocessor, etc.) or memory system (floppy disk, compact disk, optical disk, hard drive, etc.), these functions being useful in gaming apparatus. The developer provides gaming application specific data (that is rules, directions, payout schedules, numbers of rounds, player activity requirements, and the like) to the Application Programming Interface, creates and ultimately compiles the information needed to direct the gaining operating system to execute the functions necessary to play the gaming application, and provide that compiled information to a gaming apparatus with the operating system in a commercial environment to practice the game. .
The method comprises assisting in the development of a computer based wagering gaming application with at least the steps of:
providing a gaming operating system comprising a library of at least two software gaming callback functions and/or primary gaming states;
providing an Application Programming Interface enabling communication from a distal intelligence source to the gaming operating system; , communicating with the Application Programming Interface to the functions and/or primary gaming states in the library of the gaming operations;
providing gaming specific data relating to at least one specific gaming application; and compiling a program specific to at least one gaming application that is compatible with the gaining operating system through the use of the gaming operating system API.
This method could have the compiled program specific to at least one gaming application provided on a storage device. Some gaming applications have multiple games, and/or bonus rounds that can be included on the storage device. The method may be practiced either with or without security features enabled when communicating with the Application Programming Interface is performed.
Security features can be added later when the commercial product is introduced or qualified by the regulatory commissions.

Another way of describing the method would be as assisting in the development of a computer based wagering gaming application comprising the steps of:
providing a gaming operating system comprising a library of at least two software gaming elements selected from the group consisting of a random number generator, a game initiation sequence, a value module (e.g., one or more modules providing controls relating to coin changing, coin recognition, currency recognition, credit recognition/storage, ticket recognition/printout, etc.), a bonus module (e.g., bonus, jackpot, additional play, alternative play), a video gaming module (e.g., including actual image files, image sequencing files, clip art files, video storage files [e.g., empty or partial files], color files, etc.), an audio gaming module (sound files, sound sequence files, sound files tied to video events, volume controls, etc.), a jackpot module, a graphics conversion tool, a debugging tool, a pay-out table module, a value-handling module, a power-loss back-up module, a gaming payout history module, a player history module, and a user interaction module (e.g., handle controls, button controls, touch-screen controls, joystick controls, etc.);
providing an Application Programming Interface enabling communication from a distal intelligence source to the gaming operating system;
communicating with the Application Programming Interface to functions and/or primary gaming states in the library of the gaming operating system;
and compiling a program specific to at least one gaming application that is compatible with the gaming operating system.
The method may affect compiling of the program including writing a program that comprises gaming application specific commands that communicate with the gaming operating system. The method may be practiced in conjunction with a user manual with directions on accessing files in the library and is used by using specific commands in the user manual to access specific files or functions in the operating system through the Application Programming Interface.

For those software components which use PKI (public key infrastructure) for authentication of other components in the system, it is desirable to create a new pair of public/private keys for each software release. There are several reasons for this:
= Matching software releases by version = Simplification of the regulatory approval process = Barrier to brute-force cracking techniques = Preventative security measures = Jurisdictional non-compatibility "Revving" is the process by which public or private keys are replaced in the OS
ROM. Private keys are used to generate signatures and the public key is used to verify the signatures. This ordinarily is done every time that a new version of software is introduced into new gaming jurisdictions or even the same gaming applications to different jurisdictions.
In the software development process, small inconsistencies and incompatibilities will creep into an API as new features are added and changes are made to the internal workings of a software component. This is true especially in an embedded environment where it is not cost effective or space effective to have multiple sections of redundant code. One way to ensure that the devices in the field are using compatible software components is to somehow prevent incompatible versions from co-existing. Revving the public/private key pairs with each release of a trusted software component is one such method.
One significant delay in the introduction of gaming applications to the market has involved the complexity and length of regulatory approval. For example, consider a circumstance where there are hundreds of games deployed with a certain OS. Each of these games runs on a certain version of the software (most likely the latest version) but not necessarily so. When a new version of that OS is released, gaming regulations require that approval is obtained for all possible game configurations which exist in the field. This means that if every version of OS uses the same keys, it would be necessary to test and submit for approval every old game that existed in the field with old versions, because there would be no mechanism preventing someone from using an old version with new game code.
With a different key pair for every OS version, only new games would ever have to be submitted for approval, since the old games would automatically not work with the new keys and consequently, the new operating system.
If someone wanted to discover a private key and did not have a mathematical way of doing so (for the encryption technique described above, there are no such , known methods) they would try to discover the key by guessing. This may be hard to do with a key length of 512 bits, but someone with a lot of computer power might eventually be able to guess the correct key. By using very long keys, this approach has been made as impractical as possible. For this reason, the more impractical it is to guess keys the better, as far as security of keys is concerned. Therefore, if new keys are generated every time a version of software is released, it will be that much more impractical for someone to try to guess the keys. This makes the overall system more secure.
One of the most important aspects to consider with the PKI method of using signatures for the verification of gaming chips is that regulatory agencies base their approval on the confidence that exists in maintaining the secrecy of the private key.
Since anyone who might want to cheat the gaming application must modify the game code, if they do not know the private key, they will be unable to generate signatures for the gaming application to work. If a private key is lost, the integrity of every machine in the field which uses that public/private key set is compromised.
The only way to correct this compromise in security is to generate a new public/private key pair and upgrade every machine with the new public key. If the same set of keys has been used for every software release, this means the manufacturer must generate a new public/private key pair and upgrade every version of OS in the field. With a different public/private key set for each OS version, only a subset of machines in the field will have to be upgraded if a key is compromised, which translates to less cost and less disruption to the casino's business.
Another important issue to consider is the fact that some manufacturers may use the same software component in several different jurisdictions. It is desirable to ensure that a gaming application written for one jurisdiction will not operate in a , machine in a different jurisdiction. Also, vendors that are licensed in one jurisdiction should not have the keys to produce gaming applications for another jurisdiction. It will be desirable, therefore, to have different sets of keys for different gaming jurisdictions as well as for each software release.
When software components that exist on a system are the property of different vendors, complications arise in the case where one piece is found to have a serious security hole or other bug that causes the regulatory agency to have to disapprove the software. When any software component on a gaming device is disapproved, the gaming device as a whole will be disapproved. There are several issues with this set of circumstances, including at least liability, procedures and unlicensed vendor complications.
The timing of re-submission versus deadlines to remove the disapproved software from the field causes a potential liability issue when a bug fix cannot be found quickly enough. There should most likely be procedures that vendors should follow for tracking software installation and revisions in the field. Without such procedures, it would be impossible to do a coordinated software upgrade if the need arises.
If more than one software component interacts with a third component through the same API, there can be side effects known as couplings. For example, if a software function enables or disables a software feature, then an outside module could call the function to turn the feature on and a second module may then turn the feature off. Unless the two modules are communicating with each other, there will be problems with the two modules existing on the same system.
In systems where there is an OS / application relationship between software components, there can be a time coupling between all API calls, especially if there is an ability to preemptively multitask the application processes in the system.
Because the multitasking can happen at any time, the order in which API calls can happen may change from run to run. This means that the application code needs a layer of error checking to prevent race condition bugs that would otherwise be unnecessary.
For this reason, having a single thread of execution for which the order that API
calls are made is always the same will automatically have a greater level of trust than will a multitasking OS. This is not to say that a multitasking OS cannot overcome this deficiency by correctly using mutexes, but this obviously is more complicated to test and therefore is harder to trust and obtain approval.
There can also exist couplings between API calls. These couplings are different from the interaction couplings pointed out earlier. These couplings are inherent in the way the API operates. The classic example of this type of coupling is the following API for a voltmeter:
Set_range(volts) Set_sensitivity(volts_per_division) The underlying parameters that are being controlled by both of these API calls are the minimum and maximum voltages that will be sensed by the voltmeter. However, at high voltage range settings, certain sensitivities may be unavailable due to the way the voltmeter senses voltages. This illustrates a functional coupling in an API.
The generic way to describe these couplings is that one API call can affect the available settings or range of settings that are available to another API call.
One method of verifying software components is to define a series of regression tests and expected test results for the individual pieces. This method is useful for identifying programming errors and bounds checking problems with the API implementation, but is less useful in identifying system-level weaknesses which my be inherent in the design.
A front-end code verifier or pre-parser may be written that allows developer code to be scanned before compiling to identify errors in the code as it relates to the gaming operating system API. This type of scanner can be used to find couplings and other errors that a regression tester may not find.
In the past, vendor collaboration by defining a standard API specification in the gaming industry has been difficult and unsuccessful. A good example of this is the various protocol implementations that exist which are not always 100%
compatible. With software components co-existing on the same machine, there can be no way around the fact that if something is not 100% compatible with the API
specifications, there could easily be bugs introduced which would compromise the integrity of the device, which is clearly unacceptable in any jurisdiction.
For purposes of this disclosure, the following terms have specialized meaning, and are defined below:
"Memory" for purposes of this disclosure is defined as any type of media capable of read/write capability. Examples of memory are RAM, tape, flash memory, disc on chips and floppy disc.
"Shared or Game Program Objects" for purposes of this disclosure are defined as self-contained, functional units of game code that define a particular feature set or sequence of operation for a game. The personality and behavior of a gaming machine of the present invention are defined by the particular set of shared objects called and executed by the operating system. Within a single game, numerous game objects may be dynamically loaded and/or executed.
"Architecture" for purposes of this disclosure is defined as software, hardware or both.
"Dynamic Linking" for purposes of this disclosure is defined as linking at run time.

"API" for purposes ofrthis disclosure is an Application Programming Interface. The API includes a library of functions.
"System Handler" for purposes of this disclosure is defined as a collection of code written to control non-gaming specific device handlers. Examples of device handlers include I/O, sound, video, touch screen, nonvolatile RAM and network devices.
"Gaming Data Variables" for purposes of this disclosure includes at a minimum any or all data needed to reconstruct the gaming state in the event of a power loss.
The present invention comprises various elements to enable the use and installation of a novel gaming operating system that in turn enables more rapid development and deployment of novel gaming games. One element of the invention is a computerized wagering game apparatus comprising:
a computerized game controller operable to control the computerized wagering game having a processor, memory, and nonvolatile storage; and an operating system comprising: a system handler application which provides gaming related functions and services to game programs; and an operating system kernel that executes the system handler application. The computerized wagering game apparatus may have the system handler application comprise at least one system selected from the group consisting of a) a plurality of device handlers, b) software having the ability when executed to:

load a gaming program and execute the new gaming program; c) an API with functions callable from the game program; d) an event queue; e) a game personality described in a selected mode; and f) a combination of an event queue that determines the order of execution of each specified device handler; an API having a library of functions; an event queue capable of queuing on a first come, first serve basis; and an event queue capable of queuing using more than one criteria. The computerized wagering game apparatus may have game data modified by gaming program objects that are stored in nonvolatile storage or wherein the system handler and kernel work in communication to hash system handler code and operating system kernel code.
By way of non-limiting examples, the game data modified by gaming program objects may be stored in nonvolatile storage and changing game data in nonvolatile storage causes execution of a corresponding callback function in the system handler application. The computerized wagering game apparatus may have the operating system kernel as a Linux operating system kernel having customized proprietary modules and the kernel has at least one modification wherein each modification is selected from the group consisting of: 1) accessing user level code from ROM, 2) executing from ROM, 3) zeroing out unused RAM, 4) testing and/or hashing the kernel, and 5) disabling selected device handlers. The computerized wagering game apparatus may have the apparatus contain a machine-readable element with machine-readable instructions thereon, the instructions when executed operable to cause the processor to manage at least one gaming program object via a system handler application and to execute a single gaming program object at any one time, wherein gaming program objects are operable to share game data in nonvolatile storage within the processor in the computerized wagering game system.
The computerized wagering game apparatus may have programming direct the gaming apparatus to effect a procedure selected from the group consisting of a) only one gaming program object executes at any one time, b) there are instructions operable when executed to cause a computer to provide functions through an API
that comprises a part of the system handler application, and c) when instructions are executed, the instructions are operable to store game data in nonvolatile storage, such that the state of the computerized wagering game system is maintained when the machine loses power.
A method of assisting in the development of a computer based wagering gaming application can utilize any of the apparatus described herein by the steps of:
providing a gaming operating system comprising a library of at least two software gaming callback functions and/or primary gaming states;
providing an Application Programming Interface enabling communication from a distal intelligence source to the gaming operating system;

communicating with the Application Programming Interface to the functions and/or primary gaming states in the library of the gaming operating system by providing a Makefile or other procedure for building a gaming application, and a configuration file for running the gaming operation system on a proximal computing system;
providing gaming specific data relating to at least one specific gaming application; and compiling a program specific to at least one gaming application that is compatible with the gaming operating system.
This method of assisting in the development of a computer based wagering gaming application may also comprise using a library of at least two software gaming elements comprising gaming elements selected from the group consisting of random number generator, game initiation sequence, bonus module, video gaming module, audio gaming module, jackpot module, graphics conversion tool, debugging tool, pay-out table module, value-handling module, power-loss recovery module, gaming payout history module, player history module, and user interaction module.
Also, the process may have public and/or private authentication keys revved and different public and/or private authentication keys are provided to each of at least two different legal jurisdictions.
A method of managing data in a computerized wagering game apparatus as described herein can be practiced via a system handler application in a method of loading a shared object, executing the shared object, and accessing and storing game data in nonvolatile storage. This method may have further steps of a) unloading the first program object, and loading a second program object or b) executing a corresponding callback function upon alteration of game data in nonvolatile storage.
The present invention also includes a machine-readable memory storage element with instructions thereon, the instructions when executed operable to cause a computer to: load a first program shared object, execute a first program shared object, store gaming data in nonvolatile storage, such that a second program object later loaded can access gaming data variables in nonvolatile storage, unload the first program shared object from system memory, and load the second program shared object to system memory so that the second program shared object is accessible to the computer as instructions. This machine-readable memory storage element may have additional instructions operable when executed to cause a computer to perform a task selected from the group consisting of a) executing a corresponding callback function upon alteration of game data in the nonvolatile storage; and b) managing events via the system handler application.
Another aspect of the present invention includes a universal operating system stored in a memory storage component that may be operatively inserted along with game identity data into an electronic or electromechanical gaming device having ancillary functions so that the gaming device can effect play of the game provided in the game identity data. The operating system will control at least one ancillary function selected from the group consisting of coin acceptance, credit acceptance, currency acceptance and boot up, the gaming device having at least one system handler application, and the operating system comprising a system handler and an operating system kernel. This operating system may also have at least one of a plurality of APIs, an operating system kernel customized for gaming purposes, and an event queue, or a system handler having a plurality of device handlers or the operating system controls a networked on-line system or control a progressive meter. The operating system may also have a kernel customized for gaming purposes utilizing a method of operation selected from the group consisting of: 1) accessing user level code from ROM, 2) executing from ROM, 3) zero out unused RAM, 4) test and/or hash the kernel, and 5) disabling selected device handlers.
Another method within the scope of the invention can be generally described as a) customizing an operating system kernel and b) providing the customized kernel of the operating system into a gaming apparatus, at least one customization being effected to obtain functionality of the gaming apparatus, the customization being a kernel modification for a process selected from the group consisting of:

1) accessing user level code from ROM;
2) executing user level code from ROM;
3) zeroing out unused RAM;
4) testing and/or hashing the kernel; and 5) disabling selected device handlers.
Another method within the scope of the invention can be generally described as converting a first game that operates on a first gaming system so that the game operates on a universal gaming system, the method comprising: removing a first game operating system from the gaming system, the first game operating system including hardware and software; installing the universal gaming system in place of the game operating system, the universal gaming system including a game program layer, an open operating system, and a game controller for running the game program layer on the open operating system; providing functional interfaces between the universal gaming system and game devices; and installing a second game specific program in the game program layer configured to operate with the open operating system.
This method may have at least one step selected from the group consisting of:
a) providing the open operating system with a system application handler, wherein the functional interfaces include a functional interface between the gaming system and the game devices via the system application handler;
b) configuring the system handler application to include one or more device handlers for interfacing with the game devices, wherein at least one of the device handlers operates as a protocol manager between the games device and the open operating system;
c) providing the open operating system to include an operating system kernel that executes the system handler application; and d) providing the game program layer with at least one gaming program object.
This method may have the at least one gaming program object specific to a type of game played on the universal gaming system. The method may also have at least one step selected from the group consisting of:

changing a type of game played on the universal gaming system by changing game program objects;
configuring the game program layer to operate the game as a slot machine;
operating the slot machine as a mechanical reel-based slot machine;
and configuring the open operating system to include a resource manager for mapping game specific resources.
This method may include mapping game specific resources by parsing a configuration file, mapping operating system resources based on the configuration file, and storing the resource map in memory. This mapping of the operating system resources may be based on the configuration file includes mapping input/output lines to system resources. The method may enable converting the first gaming system from a cash accepting gaming system to a cashless gaming system, the method including providing the open operating system with a system application handler, wherein the functional interfaces include a functional interface between the gaming system and the game devices accomplished via the system application handler, and configuring the system handler application to include one or more device handlers for interfacing with the game devices, the configuring including installing a card reader device handler, and installing a card reader in communication with the card reader device handler, and optionally including configuring the system handler application to include a ticket printer device handler; and installing a ticket printer in communication with the ticket printer device handler. This method may be practiced, by way of a non-limiting example on a slot machine game operating system that is removed from the first gaming system and where the functional interfaces are between the universal gaming system and slot machine game devices. This method may also perform at least one step selected from the group consisting of: a) providing the open operating system with a system application handler, wherein the functional interfaces include a functional interface between the gaming system and the slot machine game devices via the system application handler; b) configuring the system handler application to include one or more device handlers for interfacing with the slot machine game devices, wherein at least one of the device handlers operates as a protocol manager between the slot machine games device and the open operating system; c) configuring an I/0 device handler to interface with slot machine input devices and slot machine output devices; d) providing slot machine input devices that include a mechanical arm, button acceptor and coin acceptor; and e) providing the slot machine with output devices inclusive of slot machine reels, credit displays, and speakers. The method may act to convert the mechanical reel slot machine game having only cash, token, credit balance and currency acceptance capability to a cashless gaming system via the system handler application, the converting including providing a card reader device handler, and installing a card reader in communication with the card reader device handler and optionally providing a ticket printer device handler, and installing a ticket printer in communication with the ticket printer device handler.
Another aspect of the method of the present invention is a method of configuring a game program layer for a universal gaming system that is configured for a game program layer and an open operating system, the method comprising:
configuring the game program layer on a computer remote from a first non-universal gaming system; and downloading the game program layer into the universal gaming system and performing at least one sequence comprising:
a) defining a game template; and configuring the game program layer using the game template;
b) storing the game program on a removable media card; and c) providing removable media as flash memory.
This method may be practiced, for example, where the game program is stored on a removable media card and the removable media card is plugged into the gaming system, and then running the game program layer via the open operating system from the removable media card. This method may also have an additional step of preparing the game program layer for authentication by plugging the removable media card into an authenticating system. This method may be performed, in a non-limiting example, as a network based method of providing a game program layer for a universal gaming system configured for remote operation using an open operating system, the method including defining a user interface to communicate between the remote computer and the universal operating system. For example, the game program layer is configured to use user interface remote from the gaming system or via a web page template at the user interface.
The present invention may also comprise a gaming system suitable for use in a casino comprising: a game controller configured to operate the gaming system;
and a first nonvolatile memory and a second nonvolatile memory for storing critical gaming information, wherein the first nonvolatile memory and the second nonvolatile memory are configured to communicate with the game controller as a gaming RAID

system for redundant storage of critical gaming information. RAID not defined in text, the gaming system enabling redundant NVRAM storage to be replaceable while operating power for the system is on.
The present invention includes a method of accessing a computerized gaming operating system by a method and apparatus. The operating system has novel gaining-specific features that improve security, make development of game code more efficient, and do so using an apparatus and software methods that are cost-effective and efficient. The present invention also reduces the amount of effort required to evaluate and review new game designs by gaming regulators, because the amount of code to be reviewed for each game is reduced by at least as much as 40%, preferably at least 50%, more preferably at least 60% or even at least 70%, and as much as 80% or more over known, machine-specific architecture that one skilled in the art might wish to insert into gaming systems. That is, in the practice of the present invention, rather than having every line of code or software screened, certain software is essentially 'pre-approved' by previous inspection and only game code additions (and the like) need to be reviewed for approval. The invention provides, in various embodiments, features such as a nonvolatile memory for storing gaming application variables and game state information, provides a shared object architecture that allows individual game objects to be loaded and to call common functions provided by a system handler application, and in one embodiment provides a custom operating system kernel that has selected device handlers disabled.
The Shuffle Master Gaming, Game Operating System "SGOS" Developer's Manual, revised May 2001 comprises 175 pages attached hereto as part of this specification. This Developer's Manual has not been published, but has been provided under limited access under confidentiality agreements with potential developers, and does not constitute prior art. No commercial products have been introduced using this manual or the development procedures and systems of the present invention as of 10 September 2001.
Figure 1 shows an exemplary gaming system 100, illustrating a variety of components typically found in gaming systems and how they may be used in accordance with the present invention. User interface devices in this gaming system include push buttons 101, joystick 102, and pull arm 103. Credit for wagering may be established via coin or token slot 104, a device 105 such as a bill receiver or card reader, or any other credit input device.
A card reader 105 may also provide the ability to record credit information on a user's card when the user has completed gaming, or credit may be returned via a coin tray 106 or other credit return device.
Information is provided to the user by devices such as video screen 107, which may be a cathode ray tube (CRT), liquid crystal display (LCD) panel, plasma display, light-emitting diode (LED) display, mechanical reels or wheels or other display device that produces a visual image under control of the computerized game controller. Also, buttons 101 may be lighted to indicate what buttons may be used to provide valid input to the game system at any point in the game. Still other lights or other visual indicators may be provided to indicate game information or for other purposes such as to attract the attention of prospective game users. Sound is provided via speakers 108, and also may be used to indicate game status, to attract prospective game users, to provide player instructions or for other purposes, under the control of the computerized game controller.

The gaming system 100 further comprises a computerized game controller 111 and I/0 interface 112, connected via a wiring harness 113. The universal game controller 111 need not have its software or hardware designed to conform to the interface requirements of various gaming system user interface assemblies, but can be designed once and can control various gaming systems via the use of machine-specific I/0 interfaces 112 designed to properly interface an input and/or output of the universal computerized game controller to the harness assemblies found within the various gaming systems.
In some embodiments, the universal game controller 111 is a standard IBM
Personal Computer-compatible (PC compatible) computer. Still other embodiments of a universal game controller comprise general purpose computer systems such as embedded controller boards or modular computer systems. Examples of such embodiments include a PC compatible computer with a PC/104 bus that is an example of a modular computer system that features a compact size and low power consumption while retaining PC software and hardware compatibility. The universal game controller 111 provides all functions necessary to implement a wide variety of games by loading various program code on the universal controller, thereby providing a common platform for game development and delivery to customers for use in a variety of gaming systems. Other universal computerized game controllers consistent with the present invention may include any general-purpose computers that are capable of supporting a variety of gaming system software, such as universal controllers optimized for cost effectiveness in gaming applications or that contain other special-purpose elements yet retain the ability to load and execute a variety of gaming software. Examples of special purpose elements include elements that are heat resistant and are designed to operate under less than optimal environments that might contain substances such as dust, smoke, heat and moisture. Special purpose elements are also more reliable when used 24 hours per day, as is the case with most gaming applications.

The computerized game controller of some embodiments of the present invention is a computer running an operating system with a gaming application-specific kernel. In alternative or further embodiments, a game engine layer of code executes within a non-application specific kernel, providing common game functionality. The gaming program shared object in such embodiments is therefore only a fraction of the total code, and relies on the game engine layer and operating system kernel to provide a library of gaming functions. A preferred operating system kernel is the public domain Linux 2.2 kernel available on the Internet. Still other embodiments will have various levels of application code, ranging from embodiments containing several layers of game-specific code to a single-layer of game software running without an operating system or kernel but providing its own computer system management capability.
Figure 2 illustrates the structure of one exemplary embodiment of the invention, as may be practiced on a computerized gaming system such as that of Figure 1. The invention includes an operating system 300, including an operating system kernel 201 and a system handler application 202. An operating system kernel 201 is first executed, after which a system handler application 202 is loaded and executed. The system handler application in some embodiments may load a gaming program shared object 203, and may initialize the game based on gaming data variables stored in nonvolatile storage 204. In some embodiments, the gaming data variables are mapped using a Game. State data file 205, which reflects the data stored in nonvolatile storage 204. The nonvolatile RAM (NV-RAM) according to the invention has read/write capability. The gaming program object in some embodiments calls separate API functions 206, such as sound functions that enable the gaming apparatus to produce sound effects and music.
The OS kernel 201 in some embodiments may be a Linux kernel, but in alternate embodiments may be any other operating system providing a similar function. The Linux 2.2 operating system kernel in some further embodiments may be modified for adaptation to gaming architecture. Modifications may comprise erasing or removing selected code from the kernel, modifying code within the kernel, adding code to the kernel or performing any other action that renders certain device handler code inoperable in normal kernel operation. By modifying the kernel in some embodiments of the invention, the function of the computerized gaming apparatus can be enhanced by incorporating security features, for example. In one embodiment, all modifications to the kernel are of the form of proprietary kernel modules loadable at run-time.
In one embodiment, the system is used to execute user level code out of ROM.
The use of the Linux operating system lends itself to this application because the source code is readily available. Other operating systems such as Windows and DOS
are other suitable operating systems.
Embodiments of the invention include hard real time code 310 beneath the kernel providing real time response such as fast response time to interrupts.
The hard real time code 310 is part of the operating system in one embodiment.
In one embodiment of the invention, all user interface peripherals such as keyboards, joysticks and the like are not connected to the architecture so that the operating system and shared objects retain exclusive control over the gaming machine. In another embodiment, selected device handlers are disabled so that the use of a keyboard, for example, is not possible. It is more desirable to retain this functionality so that user peripherals can be attached to service the machine.
It might also be desirable to attach additional user peripherals such as tracking balls, light guns, light pens and the like.
In another embodiment, the kernel is further modified to zero out all unused RAM. This function eliminates code that has been inserted unintentionally, such as through a Trojan horse, for example.
In one embodiment, the kernel and operating system are modified to hash the system handler and shared object or gaming program object code or both, and to hash the kernel code itself. These functions in different embodiments are performed continuously, or at a predetermined frequency.
The system handler application is loaded and executed after loading the operating system, and manages the various gaming program shared objects. In further embodiments, the system handler application provides a user Application Program Interface (API) 206 that includes a library of gaming functions used by one or more of the shared objects 210. For example, the API in one embodiment includes functions that control graphics, such as color, screen commands, font settings, character strings, 3-D effects, etc. The device handler callbacks 210 are preferably handled by an event queue 320. The event queue schedules the event handlers in sequence. The shared object 203 calls the APIs 206 in one embodiment. The system handler application 202 in various embodiments also manages writing of data variables in the "game.state" file 205 into the nonvolatile storage 204, and further manages calling any callback functions associated with each data variable changed.
The system handler 202 application of some embodiments may manage the gaming program shared objects by loading a single object at a time and executing the object. When another object needs to be loaded and executed, the current object may remain loaded or can be unloaded and the new object loaded in its place before the new object is executed. The various shared objects can pass data between objects by storing the data in nonvolatile storage 204. For example, a "game.so" file may be a gaming program object file that is loaded and executed to provide operation of a feature set of a computerized wagering game, while a "bonus.so" gaming program object file is loaded and executed to provide a feature set of the bonus segment of play. Upon changing from normal game operation to bonus, the bonus.so is loaded and executed upon loading. Because the relevant data used by each gaming program object file in this example is stored in nonvolatile storage 204, the data may be accessed as needed by whatever gaming program object is currently loaded and executing.

The system handler application in some embodiments provides an API that comprises a library of gaming functions, enabling both easy and controlled access to various commonly used functions of the gaming system. Providing a payout in the event of a winning round of game play, for example, may be accomplished via a payout function that provides the application designer's only access to the hardware that pays out credit or money. Restrictions on the payout function, such as automatically reducing credits stored in nonvolatile storage each time a payout is made, may be employed in some embodiments of the invention to ensure proper and secure management of credits by the computerized gaming system. The functions of the API may be provided by the developer as part of the system handler application, and may be a part of the software provided in the system handler application package.
The API functions may be updated as needed by the provider of the system handler application to provide new gaming functions as desired. In some embodiments, the API may simply provide functions that are commonly needed in gaming, such as computation of odds or random numbers, an interface to peripheral devices, or management of cards, reels, video output or other similar functions.
The system handler application 202 in various embodiments also comprises a plurality of device handlers 210 that monitor for various events and provide a software interface to various hardware devices. For example, some embodiments of the invention have handlers for nonvolatile memory 212, one or more I/0 devices 214, a graphics engine 216, a sound device 218, or a touch screen 220. Also, gaming.
specific devices such as a pull arm, credit receiving device or credit payout device may be handled via a device handler 222. Other peripheral devices may be handled with similar device handlers, and are to be considered within the scope of the invention. In one embodiment, the device handlers are separated into two types. The two types are: soft real time 210A and regular device handlers 210B. The two types of device handlers operate differently. The soft real time handler 210A
constantly runs and the other handler 210B runs in response to the occurrence of events.
, The nonvolatile storage 204 used to store data variables may be a file on a hard disc, may be nonvolatile memory, or may be any other storage device that does not lose the data stored thereon upon loss of power. In one embodiment the nonvolatile storage is battery-backed RAM. In another embodiment, the non-volatile storage is flash memory. The nonvolatile storage in some embodiments may be encrypted to ensure that the data variables stored therein cannot be corrupted. Some embodiments may further include a game.state file 205, which provides a look-up table for the game data stored in nonvolatile storage 204. The game.state file is typically parsed prior to execution of the shared object file. The operating system creates a map of NVRAM by parsing the game.state file. The look-up table is stored in RAM. This look-up table is used to access and modify game data that resides in NVRAM 204. This game data can also be stored on other types of memory.
In some embodiments, a duplicate copy of the game data stored in NVRAM
204 resides at another location in the NVRAM memory. In another embodiment, a duplicate copy of the game data is copied to another storage device. In yet another embodiment, two copies of the game data reside on the NVRAM and a third copy resides on a separate storage device. In yet another embodiment, three copies of the game data reside in memory. Extra copies of the game data are required by gaming regulations in some jurisdictions.
Data written to the game state device must also be written to the nonvolatile storage device, unless the game state data device is also nonvolatile, to ensure that the data stored is not lost in the event of a power loss. For example, a hard disc in one embodiment stores a file that contains an unencrypted and nonvolatile record of the encrypted data variables in nonvolatile storage flash programmable memory (not shown). Data variables written in the course of game operation may be encrypted and stored in the nonvolatile storage 204, upon normal shutdown. Loss of power leaves a valid copy of the most recent data variables in the non-volatile storage.

In an alternate embodiment, a game state device 205 such as a game.state file stored on a hard disc drive provides variable names or tags and corresponding locations or order in nonvolatile storage 204, in effect, providing a variable map of the nonvolatile storage. In one such embodiment, the nonvolatile storage may then be accessed using the data in the game state file 205, which permits access to the variable name associated with a particular nonvolatile storage location. Such a method permits access to and handling of data stored in nonvolatile storage using variable names stored in the game state file 205, allowing use of a generic nonvolatile storage driver where the contents of the nonvolatile storage are game-specific. Other configurations of nonvolatile storage such as a single nonvolatile storage are also contemplated, and are to be considered within the scope of the invention.
Callback functions that are managed in some embodiments by the system handler application 202 may be triggered by changing variables stored in NVRAM
204. For each variable, a corresponding function may be called that performs an action in response to the changed variable. For example, every change to a "credits"
variable in some embodiments calls a "display_credits" function that updates the credits as displayed to the user on a video screen. The callback function may be a function provided by the current gaming program shared object or can be called by a different gaming program object.
The gaming program's shared objects in some embodiments of the invention define the personality and function of the game. Program objects provide different game functions, such as bookkeeping, game operation, game setup and configuration functions, bonus displays and other functions as necessary. The gaming program objects in some embodiments of the invention are loaded and executed one at a time, and share data only through NVRAM 204 or another game data storage device. The previous example of unloading a game.so gaming program object and replacing it with a bonus.so file to perform bonus functions is an example of such use of multiple gaming program shared objects.

Each gaming program object may require certain game data to be present in NVRAM 204, and to be usable from within the executing gaming program shared object 203. The game data may include meter information for bookkeeping, data to recreate game on power loss, game history, currency history, credit information, and ticket printing history, for example.
The operating system of the present application is not limited to use in gaming machines. It is the shared object library rather than the operating system itself that defines the personality and character of the game. The operating system of the present invention can be used with other types of shared object libraries for other purposes.
For example, the operating system of the present invention can be used to control networked on-line systems such as progressive controllers and player tracking systems. The operating system could also be used for kiosk displays or for creating "picture in picture" features in gaming machines. A gaming machine could be configured so that a video slot player could place a bet in the sports book, then watch the sporting event in the "picture in picture" feature while playing his favorite slot game.
The present invention provides a computerized gaming apparatus and method that provides a gaming-specific platform that features reduced game development time and efficient game operation via the use of a system handler application that can manage independent gaming program objects and gaming-specific API, provides game functionality to the operating system kernel, provides security for the electronic gaming system via the nonvolatile storage and other security features of the system, and does so in an efficient manner that makes development of new software games relatively easy. Production and management of a gaming apparatus is also simplified, due to the system handler application API library of gaming functions and common development platform provided by the invention.

Figure 3 is a,diagram illustrating one exemplary embodiment of a gaming system 400 according to the present invention including universal operating system 300. As previously described herein, game layer 402 includes gaming program shared objects 203 which are specific to the type of game being played on gaming system 400. Exemplary game objects or modules include paytable.so 406, help.so 408 and game.so 410. Game layer 402 also includes other game specific independent modules 412. Game engine 404 provides an interface between game layer 402 and universal operating system 300. The game engine 404 provides an additional application programming interface to the game layer application. The game engine 404 automates core event handling for communicating with the game operating system 300, and which are not configurable via the specific game layer game code.
The game engine 404 also provides housekeeping and game state machine functions.
The game layer objects 203 and/or modules 406, 408, 410 may also directly call user API 206.
As previously described herein universal operating system 300 is an open operating system which allows for conversion of the gaming system 400 into different types of games, and also allows for future expandability and upgrading of associated hardware in the gaming system 400 due to its open architecture operating system.
In operating system 300, device handlers 210 provide the interface between the operating system 300 and external gaming system input and output devices, such as a button panel, bill acceptor, coin acceptor, mechanical arm, reels, speaker, tower lights, etc. Each device handler 210 is autonomous to the other. The device handlers or drivers 210 operate as protocol managers, which receive information from a gaining system device (typically in the gaming system device protocol) and convert the information to a common open operating system protocol usable by operating system 300. Similarly, the device drivers or handlers 210 receive information from the open operating system and convert the information to a gaming device specific protocol. The specific device handlers or drivers used are dependent upon what game you are using, and may be loadable or unloadable as independent, separate objects or modules. The exemplary embodiment shown includes total I/0 device handler 414, sound device handler 416, serial device handler 418, graphics device handler 420, memory manager device handler 422, NVRAM device handler 424, protocols device handler 426, resource manager device handler 428 and network device handler 430.
Other suitable device handlers for adapting the operating system 300 to other gaming systems will become apparent to one skilled in the art after reading the present application.
Figure 4 is a diagram illustrating one exemplary embodiment of a method of converting an existing gaming operating system to a gaming system 400 having an open operating system 300 according to the present invention. The gaming system 400 according to the present invention is suitable for converting both video based gaming systems and also electrical/mechanical based operating system, such as a mechanical reel based slot machine, and combinations of the two in a unit (by way of a non-limiting example, where one system is an underlying game and the other system is a bonus, jackpot or contemporaneous game). Once the existing game operating system has been changed over to a universal gaming system 400 having a universal operating system 300 according to the present invention, the type of game itself may be changed via changing out the game specific code in the game layer 402.
At 450, the existing game operating system is removed from the game. The existing game operating system is typically a proprietary operating platform consisting of computer hardware and software which is specific to the game being changed out. At 452, a universal gaming system 402 including an open operating system 300 is installed in the game. At 454, functional interfaces are provided between the open operating system and the existing gaming system devices. At 456, a game specific program (i.e., game layer 402) is installed in the universal gaming system. The game specific program is configured to communicate with the open operating system 300.

In one exemplary embodiment, the gaming system according to the present invention is used in a mechanical reel-based slot machine, either in a new slot machine or in converting an existing slot machine to an open operating system according to the present invention. Exemplary conventional reel-based slot machines include an IGT S-plus slot machine or a Ba11YTM slot machine.
Figure 5 is a diagram illustrating one exemplary embodiment of I/0 devices which must be functionally interfaced within adopting gaming system 402 to a reel-based game. The exemplary embodiment shown includes devices which interface with a digital I/0 device driver. In one embodiment, input devices 462 includes a button panel device 466, a mechanical arm device 468, a bill acceptor device 470, and a coin acceptor device 472. Each of the input devices 462 receives information from the specific game devices and provides the information to the gaming system 400 via the I/0 device driver.
Output devices 464 receive information from operating system 300 which provides an output via the I/0 device driver to gaming devices 464. In the example shown, output devices 464 include reels device 474 which receives an output to the stepper motors controlling the reels. Credit displays device 476 which receives an output to the LED driven credit displays. Speaker device 478 which receives a sound output to the game speakers. On-line system protocol devices 480 are communication interfaces between the open operating system 300 and the game on-line system.
Tower light devices 482 receive an interface between the open operating system and the game tower lights.
Figure 6 is a diagram illustrating one exemplary embodiment of a resource manager used in a gaming system according to the present invention. The resource manager 500 is a software module which receives a resource configuration file and stores it in memory 504. In one aspect, memory 504 is stored in nonvolatile memory, which in one embodiment is flash memory. The resource manager parses the resource configuration file and stores individual resources in memory for fast recall.

In one embodiment, the resource manager 500 stores the file 502 in the form of a lookup table. In one preferred embodiment, the resource manager reads the configuration files at startup, parses the configuration files and stores them in memory 504. The resource manager file 506 may then be accessed by the rest of the operating system 300 software applications. The resource manager operates to map digital lines, com ports, game specific resources, kernel modules to load, etc.
Figure 7 is a diagram of a table illustrating one exemplary embodiment of a portion of a resource file 506 according to the present invention. The resource manager 500 operates to map the input/output (I/0) line to the operating system resources. Instead of changing pin locations for different games, the resource manger provides for mapping of I/0 lines via software. In one aspect, 64, 1/0 (X8) lines are mapped to the various operating system resources. In one aspect, the I/0 line at PIN#
1 510 is mapped to resource R20 512; and PIN# 2 514 is mapped to resource R3 516;
PIN# 3 518 is mapped to resource R38 520; PIN# 4 522 is mapped to resource R10 524; PIN# 5 526 is mapped to resource R11 528; PIN# 6 530 is mapped to resource R12 532; PIN# 7 534 is mapped to resource R13 536; and PIN# N 538 is mapped to resource R51 540, etc.
The gaming system 400 according to the present invention is adaptable for use as a cashless gaming system. As such, it is useable for converting existing coin-based or token-based gaming systems into a cashless gaming system.
Figure 8 is a diagram illustrating one exemplary embodiment of converting cash, coin, or token-based gaming system to a cashless gaming system using the universal gaming system 400 according to the present invention. References also made to Figures 1-7 previously described herein. A card reader or coupon acceptor 550 and ticket printer 552 are added to the game. The card reader 550 and ticket printer 552 are easily adaptable to interface with the gaming system 400 according to the present invention. In particular, card reader device driver 554 is added to open operating system 300 to enable card reader 550 to communicate with the operating system. Similarly, a ticket printer device driver 556 is added to the operating system 300 in order to allow ticket printer 552 to communicate with the operating system.
For example, an existing cash-based reel slot machine can be converted according to the present invention to a cashless gaming system. The card reader 550 can operate to read credit cards, magnetic strip based cards, or accept coupons which includes credits such as promotional gaming credits received from a casino. The card or coupons may be obtainable from a central or kiosk location. Once play is complete on the gaming system 400, the ticket printer 556 is operable to print a ticket representative of the amount of credits or money won on the gaming system. The ticket 560 may then be used as a card or coupon in another gaming system, or alternatively, may be turned in at a kiosk or central location for money.
Figure 9 is a diagram illustrating another exemplary embodiment of the , gaming system 400 according to the present invention. Due to the open operating system 300, game layer 402 may be configurable remote from the gaming system 400, such as on a remote computer or laptop computer 580. Game layer 402 is constructed into game objects or modules 302. As such, templates for specific types of games are configured to allow a game programmer to specify game specific configurable options from a remote computer 580. In another aspect, game specific modules are created on the remote computer 580. The game layer is then assembled and transferred into memory 582. In one aspect, memory 582 is nonvolatile memory located in the gaming system 400. In one aspect, the nonvolatile memory is flash memory. In one exemplary embodiment, the flash memory is a "Disk on a Chip", wherein the game layer 402 is downloaded from the remote computer 580 onto the disk on a chip 582.
Figure 10 is a diagram illustrating another exemplary embodiment of programming and/or configuring a game layer at a location remote from the gaming system 400. In this embodiment, game layer 402 is programmed or configured on remote computer 580. After completion of configuring and/or programming game layer 402, the game layer 402 is transferred via remote computer 580 to a removable media 584. In one preferred embodiment, the removable media is a flash memory card, and more preferably is a CompactFlashTM card. In one aspect, the flash memory card plugs into remote computer 580 via a PCMCIA slot. Suitable flash memory cards (i.e., a CoinpactFlashTM card) are commercially available from memory manufacturers, including SanDisk and Kingston.
The removable media 584 is removed from remote computer 580 and inserted in gaming system 400. In one aspect, removable media 584 can be "hot-inserted"

directly into the controller board of gaming system 400. The removable media contains game layer 402 including the game specific code and program files. As such, removable media 584 remains inserted into gaming system 400 during operation of the gaming system. In an alternative embodiment, the game layer 402 can be transferred (e.g., via a memory download) from removable media 584 to memory inside of gaming system 400.
In one embodiment, the removable media 584 is maintained in gaming system 400 during operation of the gaming system. As such, the gaming system program files may be verified for authenticity by gaming officials by simply removing the removable media 584 and inserting it in a computer or controller used for verifying/authenticating game code, indicated at 586.
Figure 11 is another exemplary embodiment of a gaming system according to the present invention wherein the game layer is programmable or configurable at a location remote from the gaming system 400. In this embodiment, game layer 402 is configurable over a network based communication system. In one embodiment, network based system 600 includes a user interface 602, network or network communication link 604, and controller 606. Controller 606 is configured to communicate with user 610 via network 604. In particular, centralized controller 606 includes web server 612. User 610 accesses web server 612 via user interface 602, and downloads a web page suitable for configuring a game layer. In one aspect, the web page includes game specific game templates 608, which are utilized for inputting specific user configurations for individual games. Once a game template 608 has been configured, the game template is transferred to controller 606 via network 604.
Controller 606 receives the configuration information associated with game template 608 and assembles game layer or program 402 using the configuration information.
The game layer or program 402 can now be downloaded into memory in gaming system 400 for use by gaming system 400 including the game specific configurable options determined by user 610.
The system 600 also allows other user interfaces 614 for configuring games which may be assembled by controller 606 for use in other gaming systems.
Alternatively, other user interface 614 may be representative of a gaming official checking the game 402 and authorizing use of the game 402 and gaming system 400.
As such, the game layer 402 may be transferred to the gaming system 400 via controller 606, or via a communication link with user interface 614, which may be a direct connection or may be a network. Alternatively, game layer 402 may be transferred from controller 606 or user interface 614 by putting it on a flash memory device (e.g., Disk on a Chip or CompactFlash card) and physically inserted into gaming system 400.
Network 604, as used herein, is designed to include an intemet network (e.g., the Internet), intranet network, or other high-speed communication system. In one preferred embodiment, network 604 is the Internet. While the exemplary embodiment and this detailed description refers to the use of web pages on the Internet network, it is understood that the use of other communication networks or next generation communication networks or a combination of communication networks (e.g., and intranet and the Internet) are within the scope of the present invention. The configuration information received from user interface 602 can be assembled into game layer 402 using hardware via a microprocessor, programmable logic, or state machine, in firmware, and in software within a given device. In one aspect, at least a portion of the software programming is web-based and written in HTML and/or JAVA programming languages, including links to the web pages for data collection, and each of the main components communicate via network 604 using a communication bus protocol. For example, the present invention may or may not use a TC/IP protocol suite for data transport. Other programming languages and communication bus protocols suitable for use with the system 600 according to the present invention will become apparent to those skilled in the art after reading the present application.
Figure 12 is a diagram illustrating one exemplary embodiment of web page game templates used in the system shown in Figure 11. Template 1 is shown at and Template 2 is shown at 624. In one embodiment, upon accessing controller via user interface 602, user 610 selects a game type that the user 610 would like to either program or configure. An example of a game type is a poker template.
Based on the game type 626, a template appears at user interface 602 for that game type which allows the user to specify game configurable options, indicated at 628.
The controller then operates to assemble the game layer or game programs 402 based on the information received via the game template. The configurable options may include any type of game specific configurable options, such as game colors, game sound, percentage payouts, game rules, game options, etc.
Figure 13 is a diagram illustrating one exemplary embodiment of nonvolatile RAM used in a gaming system 400 according to the present invention, wherein the nonvolatile RAM is configured as a redundant memory system. In one exemplary embodiment shown, the nonvolatile RAM is configured as a RAID system. In the hard disk drive industry, RAID (short for redundant array of independent disks) systems employ two or more disk drives in combination for improved disk drive fault tolerance and disk drive performance. RAID systems stripe a user's data across multiple hard disks. When accessing data, the RAID system allows all of the hard disks to work at the same time, providing increase in speed and reliability.
A RAID system configuration as defined by different RAID levels. The different RAID levels range from LEVEL 0 which provides data striping (spreading out of data blocks of each file across multiple hard disks) resulting in improved disk drive speed and performance but no redundancy. RAID LEVEL 1 provides disk mirroring, resulting in 100 percent redundancy of data through mirrored pairs of hard disks (i.e., identical blocks of data written to two hard disks). Other drive RAID
levels provide variations of data striping and disk mirroring, and also provide improved error correction for increased performance and fault tolerance.
In Figure 13, one exemplary embodiment of RAID data storage system used in a gaming system 400 according to the present invention is generally shown at 630.
The RAID storage system 630 includes a controller or control system 632 and multiple nonvolatile RAM data storage units, indicated as RAMA 634 and RAMB
636. In one aspect, RAMA 634 and RAMB 636 each include a backup power system PWR 638 and PWR 640. In one aspect, backup power systems PWR 638 and PWR
640 are battery backup systems. RAMA 634 and RAMB 636 are configured to communicate with control system 632 as a redundant array of storage devices.
Preferably, nonvolatile memory RAMA 634 and nonvolatile memory RAMB 636 are configured similar to a RAID level configuration used in the disk drive industry (i.e., as a "mirrored pair"). Nonvolatile memory RAMA 634 and nonvolatile memory RAMB 636 communicate with control system 632 via communication bus 638, using a communication bus protocol. One exemplary embodiment of a communication bus suitable for use as communication bus 638 is an industry standard ATA or uniform serial bus (USB) communication bus. Control system 632 includes a microprocessor based data processing system or other system capable of performing a sequence of logical operations. In one aspect, control system 632 is configured to operate the RAID system 630 nonvolatile memories RAMA 634 and RAMB 636 as a mirrored pair. As such, read/write to nonvolatile memory RAMA 634 are mirrored to nonvolatile RAMB 636, providing redundancy of crucial gaming specific data stored in nonvolatile memory RAMA 634 and RAMB 636. Alternatively, the nonvolatile memory RAMA 634 and nonvolatile memory RAMB 636 may be configured to communicate with control system 632 similar to other RAID storage system levels, such as RAID LEVEL 0, RAID LEVEL 2, RAID LEVEL 3, RAID LEVEL 4, RAID
LEVEL 5, RAID LEVEL 6, etc. Further, the RAID system 630 may include more than the two nonvolatile memories RAMA 634 and RAMB 636 shown.
Although specific embodiments have been illustrated and described herein, it will be appreciated by those of ordinary skill in the art that any arrangement which is calculated to achieve the same purpose may be substituted for the specific embodiments shown. This application is intended to cover any adaptations or variations of the invention. It is intended that this invention be limited only by the claims, and the full scope of equivalents thereof.
=

to Shuffle Master # GAMING
Shuffle Master Game Operating System "SGOS"
Developer's Manual Rev: May 2001 Overview l. SGOS BASICS
Chapter 1 ¨ Introduction ............................................. 1-1 Chapter 2 ¨ Installing and Configuring SGOS .......................... 2-1 Chapter 3 ¨ SGOS Components ........................................... 3-1 Chapter 4 ¨ Tips to Get Started with SGOS ............................. 4-1 II. PROGRAMMING WITH THE API
Chapter 5 ¨ Scope of Userapi Functions ................................ 5-1 Chapter 6 ¨ Timers, Buttons, and Callbacks ............................ 6-1 Chapter 7 ¨ Handling Graphics ......................................... 7-1 Chapter 8 ¨ Sounds in SGOS ............................................ 8-1 Chapter 9 ¨ Non-Volatile RAM (nvram) ................................. 9-1 III. GAME DEVELOPMENT
Chapter 10 ¨ File Structure ........................................... 10-1 Chapter 11 ¨ Game States and Managing the Game Engine ................. 11-1 Chapter 12 ¨ Initialization (oti) File ....................... = 12-1 Chapter 13 ¨ Multigame Setup .......................................... 13-1 Chapter 14 ¨ Game Development Tools ................................... 14-1 Chapter 15 ¨ Building a Game .......................................... 15-1 IV, API TUTORIAL
Chapter 16 ¨ Displaying Text .......................................... 16-1 Chapter 17¨ Drawing an Icon .......................................... 17-1 Chapter 18 ¨ Using the Frame Buffer and Timers ....................... 18-1 Chapter 19 ¨ Adding Buttons .......................................... 19-1 Chapter 20 ¨ Using Timers to Move an Icon ............................. 20-1 Chapter 21 ¨ Tutorial: Using Nvram .................................... 21-1 V. GAME ENGINE TUTORIAL
Chapter 22 ¨ Build a Simple Game ...................................... 22-1 Chapter 23 ¨ Build a 9-Line Game ...................................... 23-1 VI. HARDWARE SOLUTIONS
Chapter 24 ¨ Hardware Solutions ....................................... 24-1 Chapter 25 ¨ Online Gaming Architecture (olga) ....................... 25-1 APPENDIXES
Appendix A ¨ Linux Setup Considerations ............................... A-1 Appendix B ¨ make and the Makefile .................................... 8-1 Appendix C ¨ Embedded userapi Calls .................................. C-1 Appendix D .oti Configuration File .................................... D-1 Appendix ¨ mygame,state File ......................................... E-1 Appendix F ¨ Generic Game Template File .............................. F-1 Appendix G ¨ Graphics Conversion Tool ................................. G-1 Appendix H ¨ Makestrips Utility (9 Line Games) ........................ H-1 Appendix I ¨ Nine Line Game Template .................................. 1-1 Appendix J ¨ Poker Game Template ..................................... J-1 Appendix K-. Other Templates .......................................... K-1 Appendix L ¨ Online Protocol Exception Codes .......................... L-1 Appendix M ¨ Screens for Setup and Recordkeeping ..................... M-1 Appendix N ¨ Advantec Hardware Solution Information ................... N-1 Appendix 0 ¨ Further Help and Troubleshooting ......................... 0-1 74),Shuffle Master]
4 .4 CiAMING

Table of Contents l. SGOS BASICS
Chapter 1 ¨ Introduction ................................................. 1-1 A. A Universal Game Design Approach ...................................... 1-B. Uses the Stable Linux Platform ........................................ 1-C. Key Game Features .................................................... 1-D. Developing a New Game with SGOS ....................................... 1-E. Potential Users ...................................................... 1-F. Target Machines ...................................................... 1-Chapter 2 ¨ Installing and Configuring SGOS ............................. 2-1 A. Pre-loaded Development System ......................................... 2-B. Install Linux ......................................................... 2-C. Install SGOS .......................................................... 2-D. Disable Functions not Supported by Development Platform ............... 2-E. Tools Available on the Web ............................................ 2-Chapter 3 ¨ SGOS Components .............................................. 3-1 A. Basic SGOS Layout .................................................... 3-B. Linux Real Time and Linux Kernel ..................................... 3-C. User API ............................................................. 3-D. Event Handler ......................................................... 3-E. nvram and Game State .................................................. 3-F. Watchdog ............................................................. 3-Chapter 4 ¨ Tips to Get Started with SGOS ............................... 4-1 A. Unique Aspects of SGOS ............................................... 4-B. About the Examples and Tutorials ..................................... 4-=
II. PROGRAMMING WITH THE API
Chapter 5 ¨ Scope of userapi Functions ................................... 5-1 A. Role of userapi in SGOS Programming .................................. 5-B. Overview of userapi Functions ........................................ 5-Chapter 6 ¨ Timers, Buttons, and Callbacks ............................... 6-1 A. Event-Driven Programming .............................................. 6-B. Launching Timers ..................................................... 6-C. Multiple and Periodic Timers .......................................... 6-D. Using Timers for Screen Updates ....................................... 6-E. Using Timers for Animation ............................................ 6-F. Killing Timers ........................................................ 6-G. Button Events ........................................................ 6-Chapter 7 ¨ Handling Graphics ........................................... 7-1 A. A Different Approach to Graphics ..................................... 7-B. XPM Graphic Format .................................................... 7-C. Converting Icons to XPM ............................................... 7-D. Organizing Icon XPM's ................................................. 7-iri;)Shuffle Master]
,õ/õ. v 4 4 = CIAMINCI

E. Three Graphics Buffers: Screen, Background and Frame ................. 7-F. Setting the Buffer Context for API Functions .......................... 7-G. Colors Reserved for Transparency ...................................... 7-H. "Trans" and "Sprite" Transparency Functions ........................... 7-I. .......................................................................
Drawing to the Three Buffers 7-5 J. Updating Among Buffers with gfx_copybuffer() .......................... 7-K. Limited Animation Using Only the Screenbuffer ......................... 7-L. Using the BACKGROUNDBUFFER for Transparency .......................... 7-M. Double-Buffered Animation ............................................. 7-N. Role of Timers and Callbacks in Animations ............................ 7-O. Uses for the GFX_WORKBUFFER ........................................... 7-Chapter 8 ¨ Sounds in SGOS ............................................... 8-1 A. wav Files ............................................................ 8-Chapter 9 ¨ Non-Volatile RAM (nvram) .................................... 9-1 A. nvram Role in SGOS .................................................... 9-B. Setup of nvram Data with mygame.state ................................ 9-C. nvram API Functions ................................................... 9-D. Clearing NV-RAM ....................................................... 9-E. nvram Callbacks ...................................................... 9-III. GAME DEVELOPMENT
Chapter 10 ¨ File Structure .............................................. 10-A. File Tree ............................................................ 10-B. Required Files ........................................................ 10-Chapter 11 ¨ Game States and Managing the Game Engine .................... 11-A. How the SGOS Game Engine Runs Your Game .............................. 11-B. Interface Between Game and Library Layers ............................ 11-C. Event Queue ........................................................... 11-D. Timer Callbacks ....................................................... 11-E. Game States and nvram ................................................. 11-F. Schematic of Game State Progression ................................... 11-Chapter 12 ¨ Initialization (.oti) File ................................. 12-A. Basic Settings ....................................................... 12-B. Don's New Section .................................................... 12-C. Etc. ................................................................. 12-Chapter 13 ¨ Multigame Setup ............................................. 13-A. Multigame Considerations .............................................. 13-B. Naming of Files ...................................................... 13-C. .oti Initialization .................................................. 13-Chapter 14 ¨ Game Development Tools ..................................... 14-A. C Compiler ........................................................... 14-B. Makefile .............................................................. 14-C. Creation of Reel Strips Tool ......................................... 14-D. Graphics Conversion Tool .............................................. 14-E. Debugging Tools ....................................................... 14-/Shuffle 1V1asterl GAMINCi Chapter 15 ¨ Building a Game ............................................. 15-A. Building a Game on Development Platform .............................. 15-B. Testing Considerations ............................................... 15-C. Building a Game on a Target Machine .................................. 15-IV. API TUTORIAL
Chapter 16 ¨ Displaying Text ............................................. 16-A. Overview .............................................................. 16-B. Assemble Needed Files to Run SGOS ..................................... 16-C. Using gfx Functions From the userapi .................................. 16-D. Using Make and the Makefile .......................................... 16-E. Running the Program .................................................. 16-F, Exercises ............................................................. 16-Chapter 17 ¨ Drawing an Icon ............................................ 17-A. Overview .............................................................. 17-B. Converting a Graphic to XPM Format .................................... 17-C. Using SGOS gfx Functions to Display a Graphic ........................ 17-D. Revise Makefile ....................................................... 17-E. Running the Program .................................................. 17-F. Change the gfx Function to Make Transparency Work Correctly .......... 17-G. Exercises ............................................................. 17-Chapter 18 ¨ Using the Frame Buffer and Timers .......................... 18-A. Overview .............................................................. =

B, Using the Off-Screen Frame Buffer and Timers ......................... 18-C. Writing the Program .................................................. 18-D. Minor Changes to Makefile and Compile ................................ 18-E. Run the Program ....................................................... 18-F. Exercises. 18-5 Chapter 19 ¨ Adding Buttons .............................................. 19-A. Overview .............................................................. 19-B. Using SGOS Buttons .................................................... 19-C. Writing the Program .................................................. 19-D. Make, Compile, and Run the Program ................................... 19-E. Circumstance Where Callbacks Are Not Stopped by timer_kill0 .......... 19-F. Exercises ............................................................. 19-Chapter 20 ¨ Using Timers to Move an Icon ................................ 20-A. Overview .............................................................. 20-B. Getting a Random Number From the SGOS Library ......................... 20-C. Debug Settings ....................................................... 20-D. Writing a Program That Moves an Icon .................................. 20-E. Running the Program .................................................. 20-F. Using Sprite to Fix Animation Clipping ............................... 20-G. Exercises ............................................................. 20-Chapter 21 ¨ Tutorial: Using Nvram ....................................... 21-A. Overview .............................................................. 21-B. Adding nvram to Preserve Data ........................................ 21-47: =
CAAMINI:1 iv C. Use of Multiple Game Modules .......................................... 21-D. Graphics Handling Alternatives ........................................ 21-E. Create a game.state File .............................................. 21-F. Create Module for example6.c ......................................... 21-G. Create Separate Module for gravity.c ................................. 21-H. Make and Compile ..................................................... 21-I. ....................................................................... Run the Program 21-11 J. Exercises ............................................................. 21-V. GAME ENGINE TUTORIAL
Chapter 22 - Build a Simple Game ........................................ 22-Chapter 23 - Build a 9-Line Game ......................................... 23-A. Use the 9-Line Game Template ......................................... 23-VL HARDWARE SOLUTIONS
Chapter 24 - Hardware Solutions ......................................... 24-A. Game Main Module ...................................................... 24-B. Other Supported Hardware .............................................. 24-C. Mechanical Reels ..................................................... 24-Chapter 25 ¨ Online Gaming Architecture (olga) .......................... 25-A. Networking Protocols ................................................. 25-APPENDIXES
Appendix A - Linux Setup Considerations .................................. A-1. General Notes ......................................................... A-1 2. If Linux Is Already Loaded ............................................ A-1 3. Installing Linux on a Dedicated Computer .............................. A-1 4. Sharing with a Windows Computer ....................................... A-1 5. Using the Shuffle Master Development System .......................... A-1 6. Additional Help ...................................................... A-Appendix B ¨ make and the Makefile ....................................... B-1. Overview .............................................................. B-2. A Makefile Example .................................................... B-3. Running Make .......................................................... B-Appendix C ¨ Embedded userapi Calls ...................................... C-1. General Notes About userapi Calls ..................................... C-2. Graphics Routines ..................................................... C-3. Widget Routines ...................................................... C-4. Module handling routines ............................................. C-5. Timer routines ........................................................ C-6. Non-volatile RAM routines ............................................. C-7. Sound routines ....................................................... C-8. Mechanical Reel Routines .............................................. C-# /Shuffle Masterl V 4 =
GAMING' 9. External Display Routines ............................................. C-10. Text Formatting routines ............................................. C-11. Resource routines .................................................... C-12. Miscellaneous routines .............................................. C-13. Engine API Calls ..................................................... C-14. Game Specific API Calls C-11 Appendix D .oti Configuration File ...................................... D-1. mygame.oti File Listing .............................................. D-2. .oti Syntax for the Core System ....................................... D-4 3, New .oti File Syntax .................................................. D-4. .oti File Addresses ................................................... D-Appendix E ¨ mygame.state File .......................................... E-1 Appendix F ¨ Generic Game Template File .................................. F-1 1. Generic_template.c File Listing ....................................... F-2. generic_template.h File Listing ...................................... F-Appendix G ¨ Graphics Conversion Tool .................................... G-1. Location and Use of convgfx.py File ................................... G-1 2. File Listing .......................................................... G-Appendix H ¨ Makestrips Utility (9 Line Games) .......................... H-1. The Makestrips Utility ............................................... H-2. Using Makestrips ...................................................... H-3. Customizing Makestrips ............................................... H-4. The Format of the options file ....................................... H-5. Writing a Par-sheet Parser ........................................... H-Appendix 1 ¨ Nine Line Game Template .................................... 1-1. .......................................................................
nineline_template.c File Listing 1-1 2. nineline_template.h File Listing ...................................... 1-Appendix J ¨ Poker Game Template ......................................... J-1 1, poker_template.c File Listing, ....................................... J-Appendix K ¨ Other Templates ............................................ K-1. Help Template ......................................................... K-2. Last Game Template .................................................... K-3. Pay Table Template ................................................... K-4. Bonus Template ....................................................... K-Appendix L ¨ Online Protocol Exception Codes ............................ L-1 Appendix M ¨ Screens for Setup and Recordkeeping ....................
1. Main Screen .......................................................... M-1 2. Machine Statistics .................................................... M-1 3. Error Counts ......................................................... M-2 4. Ticket-Bill History ................................................... M-3 5. Location Information ................................................. M-4 6. Diagnostic Test Screens ............................................... M-5 # 1Shuffle Nlasterl 43 AMINO:

vi 7. Configuration Guide .................................................. M-8 Appendix N Advantec Hardware Solution Information ........................ N-1. CHIMP ¨ PCM-5864 Embedded Controller .................................. N-2. PCM-3810 RAM Configuration ........................................... N-3. PCM-3810 OS/DOC Configuration ........................................ N-4. HIC .................................................................. N-6 5. HABIT ................................................................. N-6 Appendix 0 ¨ Further Help and Troubleshooting ........................... 0-1. Shuffle Master Website ................................................ 0-1 2. Troubleshooting ....................................................... 0-1 /shuffle 7/ 7 _____________________________________________________________________ -GA
mial vii List of Figures Figure 3-1 SGOS Architecture Showing Library and Game Layers ......... 3-1 Figure 7-1 Use of GFX_BACKGROUNDBUFFER for a Screen Update ........... 7-6 Figure 9-1 Use of nvram with game.so ................................. 9-2 Figure 10-1 SGOS File Tree ........................................... 10-1 Figure 11-1 Event-Driven Game Actions ................................ 11-Figure 11-2 API Calls and Callbacks to Game .......................... 11-4 Figure 11-3 State Machine and Related Game Hooks ........................ 11-Figure 16-1 Tutorial: Hello World Screen ............................. 16-4 Figure 17-1 Tutorial: Ball Icon Screen Display ....................... 17-Figure 18-1 Tutorial: Frame Buffer with Counter ...................... 18-6 Figure 19-1 Tutorial: Screen with Buttons ............................ 19-8 Figure 20-1 Tutorial: Timers and a Moving Icon ...................... 20-4 Figure 21-1 Tutorial: nvram and More Buttons ........................ 21-Figure 21-2 Tutorial: Screen for Second Module .......................... 21-Figure M-1 Setup, Recordkeeping and Diagnostics Main Screen .......... M-1 Figure M-2 Machine Statistics Screen #1 ............................. M-2 Figure M-4 Ticket Bill History Screen #1 ............................. M-3 Figure M-3 Machine Statistics Screen #2 .............................. M-3 Figure M-5 Stacker/Hopper Inventory (Ticket Bill History Screen #2) .. M-4 Figure M-6 Game History Screen ....................................... M-5 Figure M-7 Location Information Screen ............................... M-5 Figure M-8 Diagnostic Tests Menu Screen .............................. M-6 Figure M-9 Touchscreen Test .......................................... M-6 Figure M-10 Bill Test Screen ............................................ M-7 Figure M-11 Hopper Test Screen .......................................... M-7 Figure M-12 Game Configuration Screen ................................... M-8 /Shuffle Niasterl fl List of Tables Table 10-1 Developer Game Files in app.temp Directory ............ 10-2 Table 11-1 SGOS Primary Game States and Callback Functions ....... 11-4 ) Shuffle Masterl v 4 4 CL
AMONG

l. SGOS BASICS
Chapter 1 - Introduction Chapter 2 - Installing and Configuring SGOS
Chapter 3 - SGOS Components Chapter 4 - Tips to Get Started with SGOS
Rev: May 2001 q.
0 Shuffle Master"

CHAPTER 1 ¨ INTRODUCTION
A. A UNIVERSAL GAME DESIGN APPROACH
Until now the countless video and mechanical games of chance offered for sale have not been at all standardized. Programmers often had to create new code in each new game, for every function, and for each hardware apparatus, Shuffle Master's new Game Operating System (SGOS) brings a universal game design approach to electronic games of chance. SGOS includes pre-approved software that handles all common game functions and security features without the need for new code.
For simplicity, this manual will refer to the Shuffle Master Game Operating System software as SGOS.
B. USES THE STABLE LINUX PLATFORM
SGOS runs on the Linux Operating System. The relatively new Linux platform (conceived in 1991, first introduced more widely in 1994) is fast becoming a favorite for countless embed-ded applications because it is much more lean and stable than Windows.
SGOS is written in C and C++. You need to have some basic programming skill to create games with the provided templates. You should be proficient in C and C++ if you will be designing new games from scratch.
C. KEY GAME FEATURES
SGOS takes care of all game actions and hardware interfaces. Functions common to all games are pre-approved and located in the SGOS library. Key features of SGOS are as follows:
= All except game personality is pre-designed and pre-approved = Game initialization and power loss recovery = Included engines: Draw Poker, Video Reel and Mechanical Reel = Support for design of new game engines by developer = Supports both single and multi-game platforms = = Complete animated graphics engine = Game history and accounting = Stereo sound support = Advanced security features = Drivers for all video game hardware = Remote debugging = Online protocol support = Basic level game development requires only graphic and text changes = Advanced level game development allows complete design of graphics, sound, and game logic Rev: May 2001 ?Shuffle Masterl =

1.D ¨ Developing a New Game with SGOS 1-2 D. DEVELOPING A NEW GAME WITH SGOS
The SGOS Software Development Kit supports two levels of development:
1. Basic. Use the included game templates (e.g. 9-line) for an immediate design. With a few interesting graphics and minor code changes, a casino tech or other designer can quickly create a unique new casino game.
2. Advanced. Powerful and flexible platform for a totally new game design.
You can quickly design a unique game with one of the provided game templates, design a fully new game with the generic template, or mix the two approaches for efficient best results. How-ever you proceed, your programming time will be slashed with the pre-designed and pre-approved underlying features of SGOS. You can focus on the new aspects of your game design.
E. POTENTIAL USERS
Any entity that sells, uses, or designs video games of chance can use the Shuffle Master SGOS
to develop a unique new game. The most likely users include the following:
1. Game Manufacturers. Manufacturers can save a great deal of design and approval time by using Shuffle Master's SGOS. A manufacturer can create a new game as unique and complex as desired.
2. Casino Operators. With the SGOS platform, a casino can design its own games. Using one of the included game engines and included tools, the casino's programmer can cre-ate a unique game with new graphics and a new name.
3. Third Party Developers. A third party programmer or developer may provide a new game design for either a manufacturer or a casino.
F. TARGET MACHINES
The examples used in this documentation are based on building a new machine with all new hardware. Refer to Part VI HARDWARE SOLUTIONS in this book for details about com-monly supported hardware.
The same game approach will apply for conversion of existing video or mechanical machines, However, the hardware and software interfaces for existing components are very application-specific and are outside the scope of this documentation.
Rev: May 2001 /Shuffle Master = . GAMING

A. PRE-LOADED DEVELOPMENT SYSTEM
If you have a pre-loaded development system from Shuffle Master, you can skip this chapter and start working with SGOS.
B. INSTALL LINUX
If you do not already have it, first install Linux on the computer you will be using for game development. Refer to Appendix A for suggestions if you are new to Linux. Red Hat Linux 6.x is preferred, but other Linux packages should be satisfactory.
You can use the most current version of Linux on your development machine, but the build machine must use the Linux version included with SGOS. The Linux OS is a part of the pre-approved code.
Neither Linux nor SGOS is greedy for RAM or hard drive space. You should have at least 32 MB of RAM and 500 MB available hard drive space for a comfortable development environ-ment..
=%, TIP... You can set up your computer as a Windows/Linux dual-boot system. Neither Linux nor SGOS will require very much of your hard drive space. Also, some vendors offer a Linux operating system that runs in Windows. Though it is less efficient, it might be easier to install, C. INSTALL SGOS
Install the SGOS library and game development files from the SGOS CD-ROM. When you insert the CD-ROM it will lead you through a menu-driven installation.
1. ***Add notes here based on final installation CD.
2. If you want to load the tutorial files now, create a directory named...***add notes The file tree in Figure 10-1 shows where the CD-ROM install procedure will place files by default.
File Formats .ps.Z compressed PostScript file, for UNIX
.tar UNIX archive file .tar,gz compressed UNIX archive file--"tar fvxz file_name"(to unzip and untar) .gz UNIX compressed archieve file using gzip--"gunzip file_name" to uncompress .bz2 Advance compressed UNIX archive file--"bunzip2 file_name" to unzip .exe Windows executable program .zip Windows archive file Rev: May 2001 010 iShuffle Master!
= = = 1:4AMlF.401 2.0 ¨ Disable Functions not Supported by Development Platform D. DISABLE FUNCTIONS NOT SUPPORTED BY DEVELOPMENT PLATFORM
SGOS configuration files end with an .oti extension. The file mygame. oti provides all settings for the embedded system on a target machine. For your desktop development system, you also must include l oca I . oti if you want to disable hardware that is not supported by your develop-ment machine. Refer to Appendix D for the various .oti file listing and the default version of I oca I . oti, which disables the touch screen and other hardware typically not available on a desktop computer running on Linux.
Note that sound is disabled by default, since sound is a bit more complicated to set up on the Linux platform. Modify I oca I oti as needed for your development setup.
TIP... If your mouse does not work, you probably need to change your svgalib settings, as (I./ follows:
1. Find /etc/vga/I i bvga. confi g in the root directory, and open it for editing.
2. Look for your mouse manufacturer and uncomment the appropriate line, 3. If your mouse still is not working, try reversing mouse_accel _type to ON
or OFF, 4. You can modify many other mouse settings in this configuration file. Review a Linux manual for further suggestions.
E. TOOLS AVAILABLE ON THE WEB
The menu-driven setup process should give you a satisfactory installation. If you are new to the Linux operating system, a Linux manual will help you get up to speed. If you have any problems with the SGOS installation, first look at the README file. Also check the Shuffle Master Web site at shuff I emastersupport. com.
=
Rev: May 2001 ;/;i::.14 /Shuffle Master . .

A. BASIC SGOS LAYOUT
Although you cannot access the SGOS precompiled library layer directly, it will be helpful to see how it interacts with the game layer and your game program.
1. Library Layer Figure 3-1 shows the basic layout of SGOS. The bulk of SGOS resides in the library, including the Linux kernel, drivers, event handler, user API, and watchdog.
The library tracks all game history and accounting and handles hardware interfaces. The library code is pre-compiled and cannot be directly accessed.
Game Objects Game-independent portion Game State , , , 4 ,T Gime M4duies 2: 1:3 CD
CD in in (e4h is autclinomi)us) o in 0 0 , , GAME LAYER
User API
Event Handler/Queue 0 Watch-dog E: 1. z is;
Fg 8 En"FT s ra no) o g O= 0) 0 2: B CD 0 3 0 "6 9 O (7, Linux Kernal Real Time Linux LIBRARY LAYERS - Info Processing Only Figure 3-1 ¨ SGOS Architecture Showing Library and Game Layers Rev: May 2001 a 0 /Shuffle Master"
. = = adaminica 3.B ¨ Linux Real Time and Linux Kernel 4-Z
2. Game Layer With the numerous pre-approved features provided in the SGOS library, you will need only a few configuration and object files to develop a new game. The rest of this document will explain how to set up a new game, either by modifying the included game templates or designing a game from scratch.
Version 2.0 of SGOS includes 9-line, draw poker, and generic game templates.
Chapter describes each of the files you will need to create a working game.
B. LINUX REAL TIME AND LINUX KERNEL
Linux 2.2.13 is the operating system for Version 2.0 of SGOS. For consistency with any state game agency approved code, the Linux version of the SGOS library cannot be changed. How-ever, you can develop your game in a newer version of Linux. Refer to Appendix A if you are new to the Linux platform.
C. USER API
The User API defines all library function calls that can be made from the game layer. The functions called out by the User API provide powerful graphic, sound, and other development options.
Chapter 5 and the tutorials in Part IV, API TUTORIAL give an overview and examples of pro-gramming the user, engine and game API functions. Appendix C provides a complete listing =
which contains the API functions.
D. EVENT HANDLER
Timers and their callback functions are what move a game along in SGOS. The timers are usu-ally tied to graphic events, and may be launched from either of two places:
1. The SGOS game engine (you cannot directly control these callbacks).
2. Your game (you launch timers with the API timer functions).
The event handler queue receives events as they are called, and handles them in the order received. A key feature of SGOS is that events are not threaded together. If a particular event fails, the program will in most cases continue to run. The tutorials show the importance and role of timers, callbacks and the event handler in SGOS programming.
E. NVRAM AND GAME STATE
"Game states" such as BEG I NPLAY, PLAV1, and EVALUATE are held in nvram and contain current and historic game data. Game state values provide data to run the current game, display game history, or resume a game where it left off in the event of a power failure or other program dis-ruption. Table 11-1 lists the primary game states and related callback functions that serve as "hooks" into the game engine.
The pre-approved game engine effectively "runs" the game and handles all game accounting and history. Your game code uses the "hooks" to direct the game engine and create a new game Rev: May 2001 tV,t /Shuffle Master = . = = cAralra=

3.F¨Watchdog 3-3 personality, by defining how the game state callback functions are handled.
Chapter II and the tutorials in Part V GAME ENGINE TUTORIAL explain SGOS's important game state fea-ture. It is an innovative and different approach to game design. The examples will help you discover how to work with game states and callback functions in SGOS.
F. WATCHDOG
The watchdog perfoms a hash on every code segment of RAM at regular intervals, The device will tilt if any of these secure hashes change. The watchdog is part of the pre-approved SGOS
library.
Rev: May 2001 4 14 /Shuffle Master . = = CSAMING

A. UNIQUE ASPECTS OF SGOS
The SGOS library and user interface are programmed in C and C++. If you are an experienced programmer you probably want to get going with SGOS programming!
Because the pre-approved game engine and library are hidden, you need to know the basics of how they work and how to interface with them. Especially, you will need to understand the following key aspects of the SGOS approach:
= How SGOS uses timers and nvram to run the game.
= How and when to interface with the game engine and game library, especially with the API functions and "game states", =
If you skim over the preliminary chapters, keep an eye out for these key concepts.
B. ABOUT THE EXAMPLES AND TUTORIALS
The examples and the tutorial files help to show the unique aspects of SGOS.
The files are included on the CD-ROM. You can run them to see simple applications of buttons, timers, nvram, and other SGOS features.
SGOS includes over 100 API functions. The tutorial examples show use of API
functions for basic game routines such as buttons and animation. See Appendix C for a complete listing of the functions.
The API calls access the SGOS library directly, whereas the callbacks to advance the game states are made via the game engine. To get a quick overview of how these important functions differ and how they are used, refer to Appendix C and Figure 11-1.
Rev: May 2001 41 9 Shuffle Masteri = N
= = CIAMIO

II. PROGRAMMING WITH THE API
Chapter 5- Scope of userapi Functions Chapter 6 - Timers, Buttons, and Callbacks Chapter 7 - Handling Graphics Chapter 8 - Sounds in SGOS
Chapter 9 - Non-Volatile RAM (nvram) Rev: May 2001 ?Shuffle Masteri = . .
A &it No CHAPTER 5 ¨ SCOPE OF USERAPI FUNCTIONS
A. ROLE OF USERAPI IN SGOS PROGRAMMING
Your game code cannot make standard C calls to the library, including file I/0 and the pri ntf family. Instead, SGOS provides a large and versatile set of API functions for all the needed routines to create a game. userapi . h and engi ne_api . h declare these functions, and you make them available by including userapi . h when you build your game.
Like the rest of the library the API is pre-approved and cannot be changed by the programmer, Periodic new SGOS releases will add features. You can also make requests for new API func-tion calls on the support Web site, shuffiemastersupport.com.
Appendix C provides a full listing of the API functions with explanations.
B. OVERVIEW OF USERAPI FUNCTIONS
1. Graphic Routines The API includes over fifteen graphics functions to draw and manipulate various shapes.
An example of a typical graphics function format and variables passed is gfx_drawbar(i nt x, i nt y, i nt w, i nt h, i nt c) which draws a solid rectangle at x, y with width w, height h, and color c.
Several of the graphics functions, including background, buffer and sprite routines are used for animations. The examples in IV API TUTORIAL provide progressive examples of how to handle graphics in SGOS with these functions.
2. Widget Routines *** edit this section when we figure out the widget functions Six widget functions create buttons, set their properties, and enable/disable them. Though all buttons have the same ability to launch an event, SGOS includes three distinct widget types: text only, graphic, and a graphic that changes when the button is pressed.
The "hot spot" function works the same way, except that it does not create any button bor-der, text or graphics. It simply defines an area of the screen that responds like a button if pressed. You can use it for any purpose ¨ for example, to create a button-type response to an area of the screen which a player is intuitively drawn to.
Buttons in SGOS can be disabled and covered with a new button, but cannot be modified or removed until the current module is closed. You may want to use the hot spot along with defined rectangles to build more complex button schemes which can handle changes.
3. Module Handling Routines Three module routines load, jump and exit a module, and either save the current module Rev: May 2001 oi S h u ffle Masteri ===..õ,z9 = it . =
amo ra n 5.B ¨ Overview of userapi Functions 5-2 name for retrieval or revert to the previous remembered module.
4. Timer Routines The two timer routines ¨ ti mer_start and ti mer_ki I I ¨ are very important in SGOS
event driven programming. For more information refer to Chapter 6 and the tutorial exam-ples in Chapter 20, Chapter 19, and Chapter 21.
5. Non-volatile RAM Routines The nvram routines manage stored mygame. state values on the nvram hardware (or in the nvram file on the development platform). The game application cannot directly touch nvram. All game manipulations and retrievals of nvram occur through API
functions.
Refer to Chapter 9 for an explanation of how the SGOS nvram manager works.
The eighteen API functions that work with nvram perform any of the following three actions on the six different types of strings (char, short, int, long, float, double):
1. Set a value 2. Retrieve a value 3. Increment a value 6. Sound Routines API sound routines are available to play or stop ,wav sound files and set the master vol-ume level.
7. Mechanical Reel Routines Specific routines targeted for use with mechanical reel slot machines. Refer to Appendix C.
8. External Display Routines Specific routines targeted for use with external displays. Refer to Appendix C.
9. Text Formatting Routines Three text formatting functions are available for formatting text and numbers.
10. Resource Routines 11. System Routines Miscellaneous API routines include a random number generating routing, setting a lamp defined within the .oti file, and debugging routine. For setting up the debug and for setting a breakpoint refer to Chapter 14-E, Debugging Tools. Two revision information functions return strings with the version and release date of the running version of SGOS. Note that the user's game version is set in the file "version" in app. temp. This file is created/updated at compile time.
Rev: May 2001 41::/Shuffle Master = - = = .m114=

5.6 ¨ Overview of userapi Functions 5-3 12. Engine NVRAM Routines These API calls let you check values in the engi ne. state and other parameters set by the game engine.
13. Multigame Management Routines 14. Miscellaneous Game Engine Routines 15. Game Specific Routines Refer to Appendix C for API calls that are specific to nineline or draw poker games.
Rev: May 2001 It /Shuffle Master 4_9f . .P=74 =
A. EVENT-DRIVEN PROGRAMMING
A game in SGOS is event-dtiven. Timers and their callback functions are the motive force in SGOS that cause a game to proceed and move along. The timers are usually tied to graphic events or player events such as a coin drop or button press. A timer can launch from either of two places:
1. The SGOS game engine (you cannot directly control these callbacks).
2. Your game (you launch timers with the API timer functions).
Even though you can react to or create events from the game side, every event is actually ser-viced on the library side of SGOS.
B. LAUNCHING TIMERS
In an SGOS game, you launch all timers and timer callbacks using the API timer routine:
ti mer_start(long ti meout, char* callback) This function passes the timeout period in milliseconds (1000 milliseconds = 1 second) and a callback function name (not a pointer). Once you start a timer, it times out, then sends the event (the callback function) to the event handler queue, which handles all timer events in the order they are received.
Note that char* cal l back is not called with any parameters. You must declare timer callbacks as voi d functions.
C. MULTIPLE AND PERIODIC TIMERS
By default each timer is good for only one call. You can start multiple timers either by calling each one separately, or by setting up a periodic timer.
1. Starting Multiple Timers You can start as many timers as you need, each with a separate call to ti mer_start(). It is acceptable to call the same callback multiple times; the event handler will track each occurrence. For instance, ti mer_start (100, "draw_screen");
ti mer_start (200, "draw_screen");
will call draw_screen() in 0.1 and 0.2 seconds from now.
SGOS has a system limit of 60 timers at any one time. You should never need this many active timers, but the limit is in place because more than 60 timers can create a bottleneck on a typical processor for a target machine.
Rev: May 2001 g, /Shuffle Master"
= 4 = CIAMINO
=

6.D ¨ Using Timers forScreen Updates 6-2 2. Setting Up Periodic Timers Create a loop where the callback function's last step re-initiates the timer to call itself back. This manual will refer to a timer that calls itself back as a "periodic timer." Chapters 20 and 21 show tutorial examples that use periodic timers to launch several animated balls that move around the screen.
4 NOTE... Events in SGOS are not threaded together; if a particular event fails, the program will in most cases continue to run, With periodic timers (with callback functions that call themselves back) you can start animations once and not have to worry about them again.
Chapters 19, 20, and 21 show examples of how to use API timer routines.
D. USING TIMERS FOR SCREEN UPDATES
SGOS event-driven programming makes extensive use of timers. With every event on its own timer you can easily add and remove items from the screen.
Timers are not associated to numbers, so it can be a puzzle to track a particular timer through the debug. out file. Looking in the debug. out file is more useful to see how many timers are executing at one time, E. USING TIMERS FOR ANIMATION
You can create single or periodic timer events. A single timer event occurs once, after a speci-fied number of milliseconds. A periodic timer event occurs every time a specified number of milliseconds elapses. The interval between periodic events is called an event delay. Periodic timer events with an event delay of 10 milliseconds or less consume a significant portion of CPU resources.
The relationship between the resolution of a timer event and the length of the event delay is important in timer events. For example, if you specify a resolution of 5 and an event delay of 100, the timer services notify the callback function after an interval ranging from 95 to 105 milliseconds. A mix of logic and experimentation are your best tools to find the right ranges for your game design.
F. KILLING TIMERS
You can cancel an active timer event at any time by using the ti mer_ki I I
(char* cal I back) function.
i".1,1.. WARNING! Be sure to pass in the timer name. If you pass a null, the function will default , " to killing all timers, including all operating system timers. This will cause the system to crash.
Note that the multimedia timer runs in its own thread.
, Rev: May 2001410 /Shuffle Master ........õDv = . = .
GAMING

6.G¨ButtonEvents 6-3 G. BUTTON EVENTS
The SGOS API offers three button types and a "hot spot." (Refer to Appendix 3 and Chapter 19 for details and examples of button behavior). The buttons and hot spot each look different on the screen, but they all launch an event in the same fashion.They define a screen area that triggers a callback when touched on the touch screen (or with a mouse click on your develop-ment computer).
For example, makebuttonl (char* name, i nt x, i nt y, i nt w, i nt h, i nt basecol or, char*
ca I l back) defines a simple button with the text string char* name. When pressed, the button calls char*
ca l l back, and the callback function is placed in the event queue. It works the same as the timer callbacks discussed above, but without a timeout period. The button serves as another event in the event-driven SGOS scheme.
Rev: May 2001 .õ ________________ VT /Shuffle Ntaster V = =

A. A DIFFERENT APPROACH TO GRAPHICS
You will likely find the SGOS approach to graphics and animation to be different from other approaches you have used. At first the event-driven programming, timer callbacks, and graph-ics routines may seem indirect compared to typical C programming. But as you spend time with it you will probably come to see it as a very powerful, flexible, efficient, and even "for-giving" programming environment.
B. XPM GRAPHIC FORMAT
The XPM graphic format is a pixel-by-pixel array of an icon's colors. You must convert all your game graphics to XPM format to work with SGOS API routines.
You can compile the converted XPM graphics directly into your program or else have SGOS
load them from files. Compiling them into the program improves performance, especially on the embedded system. This manual refers to the graphic items you include in your program as "icons."
= Transparency images need to be set to RGB value (255,0,255).
= Save the image with transparencies in a file format such as TIFF (which does not dither the image). This way the non-transparent image will not have a halo around it.
The halo is caused when the file format such as JPG dithers the image edges. Any color other than RGB (255,0,255) will not be transparent.
= All animations need to be saved as separate frames. Later enhancements may include the ability to play AVI or MPEG files.
= To conserve memory, try and make all animations with as few frames as possible. For example, use one image to show any static picture instead of multiple images at rest.
Make all frames of animation the smallest size to show all the animation sequence. The bigger the image, the more memory it uses. In other words, why use the entire screen with transparent color background when the animation takes place in only a fraction of the total screen area, Several of the API routines support transparency, as discussed in Sections G
and H of this chapter.
C. CONVERTING ICONS TO XPM
SGOS provides a Python script tool, convgfx. py, to convert your graphic icons to XPM arrays.
The script converts your graphic image files, organizes them into named XPM
arrays in a new C file, and creates a related header file.
The basic approach to use convgfx. py is as follows:
1. Put all your graphics files in one directory (typically app. temp).
2. Each icon filename becomes its XPM array name. For example, either i conl .
ti f or i conl. j pg will convert to an XPM array named i conl (the file extension is dropped).
3. When you run convgfx. py, it will stuff all the icons into a new .cpp file and create a Rev: May 2001 "
?Shuffle Master CIl . = = AIWINC1 7.D ¨ Organizing IconXPM's 7-2 header file. For instance, typing [app. temp] # . /convgfx. py mygame_i cons at the prompt creates mygame_i cons. cpp and mygame_i cons. h.
Chapter 17 shows the use of convgfx. py in a tutorial example. Appendix G
lists the con-vgfx. py file, You may want to modify it to fit your particular needs.
D. ORGANIZING ICON XPM's After you create the .cpp file containing all your XPM icons, you can take the further step of organizing logical icon groups into arrays. You will probably want to collect the icons for each animation in your game into an array. For instance, an array named ani mati on_l might include i conl, i con2, i con3, etc.
You can spread your icons among several files, or even maintain a separate file for every icon However, it is usually simplest to include all of your graphic icons in a single file. File Listing 7-1 shows an excerpt of the first few lines from a file that lists all XPM-formatted icons for a nineline game.
Note that this file (File Listing 7-1) has been rearranged into logical arrays for housekeeping.
The example includes one array for all of the bitmap reel icons, plus other arrays and single icons as required for the game (not all are shown in the excerpt). The first array, starting on line 6, names all of the icons for the reel strips. The second array, starting on line 19, lists the icons for a very simple animation that happens to include one of the reel icons.
The file also contains named icons that are not members of arrays. The XPM
listing of the first icon, named bel I , begins on line 25. Note in lines 26 and 27 that the numbers inside the double quotes define a 120 x 120 pixel array using 255 colors given as two-character ID's.
The pixel-by-pixel array appears immediately after the colors, in this case using two-character ID's. Line 29 shows the beginning of the lengthy pixel-by-pixel color listing.
SGOS also sup-ports single character ID's for files with fewer colors. See File Listing 17-1 for an example of an XPM listing for a simple ball icon.
Rev: May 2001 jSfluffle Master = . . GAM1ISIG

7.E ¨ Three Graphics Buffers: Screen, Background and Frame 7-3 File Listing 7-1: nineline_gfx.cpp, Example of xpm Listing 1 #i ncl ude "userapi h"
2 /* XPM */
3 #i ncl ude "ni nel ne_gfx, h"

// An array containing all the icon bi tmaps 6 const char* const * con_bi tmaps0 = {
7 whambutn01, 8 cherries, 9 oranges, melon, 11 plum, 12 crui se02, 13 ri ng02, 14 car02, bi gbucks01, 16 pyl I ogo01, 17 pwham201 18 {;
19 const char* const * bi gbucks_ani = {
bi gbucks01, 21 bi gbucks02, 22 bi gbucks01, 23 bi gbucks02 24 };
const char* const bel = {
26 /* width height num_col ors chars_per_pi xel */
27 " 120 120 255 2", 28 /*col ors*/
29 ".. c #54214", ".#c #baad09", 32 ................ etc rest of the col ors See File Listing 17-2 for a more complete example of a simple XPM graphic.
E. THREE GRAPHICS BUFFERS: SCREEN, BACKGROUND AND FRAME
The following three buffers are available to manipulate graphics in SGOS:
1. GFX_SCREENBUFFER ¨ Whatever is drawn to the GFX_SCREENBUFFER will display on the screen.
2. GFX_BACKGROUNDBUFFER ¨ The GFX_BACKGROUNDBUFFER is generally for storing the com-plete original GFX_SCREENBUFFER. You can use various API routines to restore the GFX_SCREENBUFFER when you remove or relocate icons, 3. GFX_WORKBUFFER ¨ This buffer is optional. The GFX_WORKBUFFER provides more options for how you assemble icons before drawing them to the screen buffer, especially for more complex animations.
F. SETTING THE BUFFER CONTEXT FOR API FUNCTIONS
The API graphics routines can interact with any of three buffers. To use these routines you Rev: May 2001 02,70 /Shuffle Master = . =

7.G ¨ Colors Reserved for Transparency 7-4 must first set the proper buffer, or "context", with the API call gfx_setcontext(i nt context) where context is one of the three buffers: GFX_SCREENBUFFER, GFX_BACKGROUNDBUFFER, or GFX_WORKBUFFER. The SGOS library assigns integer values to control the outcome of all API
routines that need to know the context.
TIP... You do not need to reset the context if you can logically determine that the most s , ., ( i ,.. recent setting is the one you need. If quite a few lines of code have occurred since the last i context was set, you may want to set it again to protect against future inserted code.
G. COLORS RESERVED FOR TRANSPARENCY
SGOS assembles a transparency by replacing a graphic's transparent pixels with pixels from the active screen or the buffer (depending on the function used). You must use the right func-tions and buffer contexts in the right order to get appropriate transparency results.
SGOS enlists a transparency buffer whenever you use an API routine that includes transpar-ency. For color schemes that can be covered by single hexidecimal characters (i.e. 45 or less) the graphics conversion tool will assign the character 9 to transparent pixels. For larger color schemes it will assign the two characters 99. Both of these equal pure magenta.
%.1,. WARNING! Pure magenta is not a common color in most artwork. If it does appear in a le;=,: graphic that also includes transparency, you will get improper results ¨ all of the pure magenta pixels will show up as transparent since they are defined by the same characters (9 or 99). You will have to shift the pure magenta to a slightly different color in your original graphic to keep it from being treated as a transparency, H. "TRANS" AND "SPRITE" TRANSPARENCY FUNCTIONS
Both the "Trans" and "Sprite" types of API transparency routines create transparency by sub-stituting pixels from a buffer. The two types of functions can sometimes accomplish the same task, but they differ considerably in how they process data.
Key aspects of the Trans routines are as follows:
= They let you define a transparency color (can be any color).
= They get transparency pixels only from the BACKGROUNDBUFFER.
= They are drawn to a special interim buffer.*
= They are not cached; they are slower, especially on a target machine.
= They are best for static screen updates or very low level animation.
*A notable Trans exception is that by calling gfx drawpartXPRO loaded with all -1 arguments ' you can cache the entire graphic, as a sort of pseudo-buffer.
Key aspects of the Sprite routines are as follows:
= They always use a transparency color of 99 or 9.
= They can get their transparency pixels from any of the three buffers.
= They offer a fill instead of transparency with setspr i tetype (SPRI TEF
I LL) .
.r,y:?--..
Rev: May 2001 1 o /Shuffle Master . . .
= . 6AMING

7.1¨ Drawing to the Three Buffers 7-5 = They are cached and have no interim buffer; they are much faster.
= They are the tool of choice for complex animations, The discussion of animation approaches in this chapter and the tutorials in Chapters 19, 20, and 21 will help you see the applications of the various transparency functions in SGOS.
I. DRAWING TO THE THREE BUFFERS
All three graphics buffers in SGOS use an area of memory with the same number of bytes as the screen. Multiple API functions can draw strings, lines, bars or graphic items to any of the three buffers ¨ GFX_SCREENBUFFER, GFX_BACKGROUNDBUFFER or GFX_WORKBUFFER, whichever is set as the current context. Many of these functons use the syntax gfx_draw[name of action, JO.
Some of the draw functions flip or otherwise manipulate a drawn item, and/or draw it as a transparency. The API button calls (e.g. makebuttonl ()) should' only be made to the screen (context set to GFX_SCREENBUFFER), to ensure that proper functionality is available on the screen. Once a button is created, you can update the button's graphic properties (e.g. setbut-toncol or()) in either context. Make sure that you modify button properties on the background buffer if you are going to copy the background to the screen.
See the tutorial in Chapter 19 and the API calls in Appendix C for more about handling the graphics aspects of buttons.
J. UPDATING AMONG BUFFERS WITH GFX_COPYBUFFERO
The API function to copy to or from the different buffers, is = gfx_copybuffero ¨ copi es al I or part of one buffer to another You will be using this function extensively as you make animations in your game.
K. LIMITED ANIMATION USING ONLY THE SCREENBUFFER
The simplest animation to set up in SGOS is a series of rectangular icons without transparency that remain in a fixed area of the screen. In this simple case, you can draw each new icon and simply let it replace the prior one, Neither the GFX_BACKGROUNDBUFFER nor GFX_WORKBUFFER
would be needed.
However, you will need at least the GFX_BACKGROUNDBUFFER if you have any of the following very common animation criteria:
= Transparency = Change in icon size or position = Overlap with any other updated icons Without another buffer in these cases, you might get lingering fragments from prior icons, absent background areas, or unwanted transparency fills.
L. USING THE BACKGROUNDBUFFER FOR TRANSPARENCY
You can store an exact copy of your GFX_SCREENBUFFER to the GFX_BACKGROUNDBUFFER at any Rev: May 2001 4.1 /Shuffle Master =
. = C. A M 1 Pa C.

7.M¨Double-BuffereaAnnation 7-point with gfx_copybuffer(). The "Trans" functions use the current data in your GFX_BACKGROUNDBUFFER to fill in transparent pixels. (The "Sprite" functions can use any of the three buffers, whichever is set as the current context.) The tutorial examples in Chapters 17 and 18 show examples of how transparency works in SGOS.
You will generally want to create your initial screen and copy it to the GFX_BACKGROUNDBUFFER
before you begin any screen changes or animations. All buttons must be created to the , GFX_SCREENBUFFER so they can launch appropriate functions with the mouse or touch screen.
(Also refer to the discussion of buttons in Chapter 6 and the tutorial example in Chapter 19.
M. DOUBLE-BUFFERED ANIMATION
Besides being the most likely source of transparency pixels, the GFX_BACKGROUNDBUFFER is nec-essary for any screen change or animation that requires graphics data from the original screen.
For "double-buffered" animations, the GFX_BACKGROUNDBUFFER is the repository for restoring = pixels when you move any icon to expose an area that must be restored to the original screen content.
,, _ 1.1111711111111:11111:1111.1 on . .... a . =,µ -01111111111111111111111111111111111111111=11111111111111 mew iriel:cs=nommommounin mz......¨,19i 418,:anamourummunimummu 11111111Lith 11111111111111111111111111111111111111111111111111 Winit ilIBUIL11111111111.1111111111111111111111117111111111111111111riallius IMMMMIWIMMIIMMMEl 111111131:1111111111111111111111 IIILLrMIEUIliiiiiiiii 1111111111111111M111111111111111111111111111111111111111111111111=11111111111 1111111111111111111111111=1111111111111111111111111111.111111=111M111111111 11111Imummummima 111111011111=1111111111111111101111111111 I. C11131111. N %I 3 rrs 1 milli i lillnuJiut i II IIIII 1 )a. irrotead, copsr nom batkiyourid burger Atli 1 2 lek ryii.t4iSullemiiiillifirilmiallial 1 , 152211111111111 ::47 tirg,%0:.. wir.r.m.P:=E : .,:..
::-11rA11::::
ilishl =simmons am min 111111111111141 MIMI"

giliml., ipi ____ 1116iiiiµ 111111 inri.,0 ill ouridmilikaar*a 1 mon...li......7 ___ " am 1111111111 MIIIIIIIIIMILAIllu .RI
2. Ado irons with trarislxinenty ni....to screeg week ely defeteg the !eon .f. d.
nralraccurn i =iiMillint=1121111111 roz.Trai. allniria NIIIIMIll 1111nril '&7, ./. /11 larilrell110317411 Nriitil.e 6- 4._ , a ..i.r 1.....1.0i.,_ ,i Illgi., In: 1 ii......i.Nitier..-. al.
NIILN:mr.in::::-...10A :
mirjszormeanciatth ...................
n. nix es iiiN1 Hail mizigiiii lim aim hums' iu claim Ira Invew III in ii3 II Its 1111111, 1111:41.1111 Figure 7-1 - Use of GFX_BACKGROUNDBUFFER for a Screen Update Figure 7-1 shows an elementary way to use the background buffer in an animation, as follows:
1. Create a screen using API functions as needed, then create a duplicate background buffer using Rev: May 2001 Sh uf fie Master . .,,,,,,,, = = = . AMING

7.N ¨ Role of Timers and Callbacks in Animations 7-7 gfx_copybuffer(x, y, w, h, destx, desty, GFX_SCREENBUFFER, GFX_BACKGROUNDBUFFER).
2. Add one or more icons using any of the following functions which support transpar-ency:
= "Trans" functions ¨ gfx_drawtransXPM gfx_drawtransFi I e(), or gfx_rotatetransXMO
= "Sprite" functions ¨ gfx_drawspri te(), gfx_drawspri tefl i pped(), gfx_drawspri tepart(), or gfx_drawspr tepartfl i pped(). First set the graphics context to the GFX_BACKGROUNDBUFFER and the sprite type to SPR I TETRANS with gfx_setgraph cscontext() and gfx_setspri tetype . (Note that the graphics con-text has no effect on the "Trans" functions, because the context is hard-wired for these functions.) 3, Wrong way and right way: Step 3 in Figure 7-1 shows what happens if you merely re-draw the icon to a new location. The old icon remains, and the new one is placed next to it.
3a and 3b show the right way to erase the old icon and restore that area of the screen.
Use the API call gfx_copybufferpart( [source (x, y, w, h)] [desti nati on (x, y)), GFX_BACKGROUNDBUFFER, GFX_SCREENBUFFER) to retrieve the needed rectangle. Depending on how you first drew the icon, you may need to call gfx_getdi mensi onsXPM() to find w and h, 4. Now you can successfully draw your new icon to the new location (this simple exam-ple draws the same icon to a new location), using an appropriate trans or sprite API
call.
N. ROLE OF TIMERS AND CALLBACKS IN ANIMATIONS
SGOS event-driven programming relies heavily upon timers and callback functions to carry out animations. With every event on its own timer you can easily add and remove items from the screen. Also, by using functions which call themselves back via timers, you can start ani-mations and let them run. You can let another event modify the animation or kill the timers.
Refer to Chapter 6 and the tutorial examples in Chapters 20 and 21 for more about animation using timers, callbacks, and the event queue.
O. USES FOR THE GFX_WORKBUFFER
You can accomplish virtually any animation using just the two buffers.
However, having the GFX_WORKBUFFER as a third provides many more options for assembling complex graphics and animations.
For example, if you use the animation technique commonly called "dirty rectangles", you will need a third buffer. "Dirty rectangles" tracks the smallest rectangles of the screen that truly need to be restored, which can drastically reduce the need for memory resources. For instance if an icon only moves a few pixels, very little of the screen would need to be restored because it remains covered by the new icon, Rev: May 2001 4 Shuffle Master v = = =
43 ^MING

CHAPTER 8 ¨ SOUNDS IN SGOS
A. WAV FILES
SGOS offers powerful sound capabilities that are simple to use.
As you are designing your game, format all of your sounds as wav files and place them in the app.temp directory. You will manage all of your game sounds with a few API
calls. Playing Sounds You play the sound file named char* file using the API function sound_pl ay(char* file, i nt channel, i nt loop, i nt pan).
You can set whether the file loops, pick any of 32 channels, and fade left-right (2 to -2). For example, sound_pl ay(mysound, 15, 1, -2) would set the channel to 15, cause the sound to loop, and pan fully to the left speaker. The sound would not stop until you call sound_stop(15).
NOTE... Changing modules (mod_exi t, mod_l oad) does not stop the sound play.
For exam-ple, if there is a looping sound playing during the main game play and the bonus is hit, when the bonus module is loaded the recurring main play sound will need to be manually halted with the sound_stop command.
Changing modules does not stop the sound, i.e., leaving the main play screen with sound play-ing and entering the bonus module would still have the main play sound playing.
You set the master sound volume with sound_vol ume(i nt percent), as a percentage of the hardware setting.
Refer to the complete API lisings in Appendix C for a more complete description of all the sound API calls, Rev: May 20010 ?Shuffle Nlasterl = . = aANFINa CHAPTER 9 - NON-VOLATILE RAM (NVRAM).
A. NVRAM ROLE IN SGOS

NOTE... Your development computer will use a file in the app. temp directory called nvram to represent the target machine's non-volatile RAM. For simplicity, this manual refers to both the non-volatile RAM hardware and your development nvram file as "nvram".
Most references will be to the nvram file, since the manual presents game development concepts.
Chapter 24 discusses Shuffle Master's nvram hardware solution for the target machine.
With SGOS you will use flash memory or other type of non-volatile RAM (nvram) to preserve needed game data across executions. SGOS stores two basic types of data in nvram:
1. Data you set for your game. You can set up structures and variables as needed to store data needed across executions among your game modules. You cannot directly access the nvram, and must use API functions to set, get, and modify your game's nvram val-ues.
2. Data the library maintains. The nvram stores game history to provide accounting records, and tracks "game states" such as I NI TI ALI ZE, PLAY1, and EVALUATE
to tell the game engine what it is supposed to be doing and where to resume in case of a power failure.
This chapter covers only the first kind of nvram data and the API functions you will use to store data in one module and retrieve it in another. Chapter 11 will cover the crucial game state concept and how you work with it in designing a game.
B. SETUP OF NVRAM DATA WITH MYGAME.STATE
Your game application cannot directly touch nvram. The SGOS library includes a special set of routines to manage the nvram data as a text file. All game manipulations of the nvram occur through these functions. The mygame. state file defines how your game level nvram values will be stored.
You will want to give careful thought to organizing the data you want to store in nvram. The . state file makes it easy to put variables in the nvram, since the game application never needs to be concerned with the offsets of nvram variables. Structure definitions can even be nested.
You use an nvram stri ng to refer to a specific variable in nvram, for example Game. cred-i tsl eft. You can access arrays with standard pri ntf-style format characters, with values inserted as the additional arguments on each line. For instance you could write strings such as Hi stpry[%I ] . bet, Stats. i con NI ] , or even Bi I I Hi story[%I ] , date[%I ] .
More elaborate formats are also possible, such as lAyStruct . %s [% l], since the string is format-.
Rev: May 2001 CI 0 /Shuffle iVlasteri . .........,1 V 4 a =

9.0 ¨ nvramAPIFunctions 9-2 ted before being parsed.
The nvram handler partitions nvram into variables, guided by the contents of the mygame. state file. This text file looks similar to a list of C structure declarations, except that it uses # as the comment character to show lines that will not be parsed. For example, the tutorial in Chapter 20 uses the following code to set up a structure bal I that will hold icon location and velocity data for up to fifty animated balls:
# Optional comment line struct bal I {
nt x;
i nt y;
i nt x_vel ;
i nt y_vel ;
i nt handler;
} Bal I [50];
The library's nvram handler reads and parses this data at startup. The nvram structures are fro-zen for a completed and compiled game design. Your game.state file defines the variables on the target machine before your program ever runs. Even on your development computer, you cannot add new variables or change the size of an array while your program is running.
C. NVRAM API FUNCTIONS
Figure 9-1 shows schematically how the nvram API functions communicate between your gam e.so g etS tate setState Functions incState Functions Non-volatile RAM
Notes:
1. See userapi appendix for complete nv set & nv get functions, 2. A development computer simulates nvram with a file named nvram in the directory user/local/sgos/shared.shfl.
Figure 9-1 ¨ Use of nvram with game.so game and nvram.
You input or update nvram variables with the set_state, get_state, and i no_state functions.
The API includes six of each of these functions, one for each variable type:
Char, Short, Int, Long, Fl oat, and Doubl e. For example, the tutorial in Chapter 20 uses the following function Rev: May 2001=
4, /Shuffle Master = = .

9.D¨ClearingNV-RAM 9-3 calls to set and retrieve a variable named ba I I . x:
nv_seti nt("Bal I [%d] . x", bal I s ri ] x, ), and nv_geti nt ("Bal I [%d] . x", &ba I I s[i ]. x, i ) Refer to Chapter 20 to see the complete example, including the mygame. state file and example game code. Appendix C explains the arguments for each function.
D. CLEARING NV-RAM
On your development computer, you must clear the nvram to reset it whenever you add or remove variables or change the layout of the nvram. To clear the nv-ram on the development platform simply delete the nvram file. SGOS will detect the nvram clear and then reinitialize it to zeros.
E. NVRAM CALLBACKS
SGOS provides for "nvram callbacks". Each callback function is associated with an nvram variable. When that varable's value is changed, the callback is called.
***Does this just refer to the game hooks, or can callbacks be passed with the API functions?***
Elaborate.
Rev: May 2001 4 /Shuffle Master = =
P. MING

III. GAME DEVELOPMENT
Chapter 10 - File Structure Chapter 11 - Game States and Manageing the Game Engine Chapter 12 - Initialization (.oti) Filel Chapter 13 - Multigame Setup Chapter 14 - Game Development Toolsl Chapter 15 - Building a Game Rev: May 200141'4 ?Shuffle Master . .

CHAPTER 10 ¨ FILE STRUCTURE
A. FILE TREE
Figure 10-1 ¨ SGOS File Tree shows most of the SGOS files you will see and work with.]
_. . .. . _ .... ... ._ . ....... . . _ . ... . _ ..
. ..
r.rth.6.. Mee .is prelin ilaryrsom e Lb. narn es and .b ca tbns m ay change . PATH IFILES .
. . ..
¨
,___11/userac cal/sgos Ililb - .... __-__ .. .._._...
_..._. _ ..._.____ ...
- - -Pfo nts Ibntrabs --/engine shuII. start . _ .. _........ . .... ... .. ......
sdspso . .. . _ .. ___ . ...... _._ . ___.... -.. . _. ..
sdsesp so = sThei-4 02-so ogpeth so gain estate h err) ns h . ----i-y /ii c li de ' .. ¨ ... . . ._ ; - -- -= ;..
11/shamd shufl balstackerso , gam e hisnbelbe events o i .. .... ... _ ..__.
' bates tso 1 hoppertes tso :
nbelhe hbho wo .. - --co n Enure enghe so Its tgam es h ,outo fservbe so i . ...... , .
engbe h =las tgam es o ; pokerevents o . ...._ . .. ... ._ . _._ . .
engbe o las tgam es displayh .
po kerhb to ryo engbe state - -las tgam¨es-display; - --, aarn-fafrs-b- - ------. _ . . . _ -eroorcondition so Ightsw kch testso reset= .so . _ . .=

. .
gam . eh bcatCb-nlifonn ai4Onso.
,se-hipiO - - . --. - --.. ....- ..__.-....
. gam e dispbyh bckup so testso gam e dbpbyo m achbe bOoks so 't.'cTe.EiCiiiib tb-ry-s-o----gam e events o ,m abscleenh . couch tests . ..... ........ . .. .... _ . .
.... _ . .....
. . .
. 11 /oil . ' tb.esync . . . _ tokenrhg . . . ..... .
_- - .-. .._ _ Ji keys _II . e Y -m Pt¨.... .. .. . . .._ . . -. . .. ... . . .
. . . . . _ ____ -___ . . .. . . _ .._. . . . . ..
. .. ._ . - . ..
. _ . . . .. .. .. . .. . . . ..
_. .
. . . .. .
. . _ ........
Fyourpath/sgos/ 11 .PP.'imrn P app poker app nicelbe , .
.cono'ach . .confg ,is conEgh.n :
co nfb.bg .conEg status conEgure .. .
= configure is confgure_gam e so co pyrght _ .. _ . .. ..
gam e so gam e_books so generb-Oem pla.tesb¨', -.._ .. .
.. .
heb so las t,gam es so ro akenom s I
. .. . . . _ ........ _ . _ .
:menu .po}Cer...tm pbib -so-tem- ro-la-t_h'it:o rys-C -- -:.-. . . ..
.. _.. _ .. . ¨..;.-.
. ..
u/engile shrti. . '11c- OM .p3..cd i p. is c-ed ..b4.1S.er/b ca -Vigo' s /en-g-rie....; tie Eta Eo' Ve . . . . . ...._ . . ._ 0.. --II /app .teM p ti akeM..- gam e_bo o ks m ' btx65w ttf - _ . .
(tem plite) 1,i)k-D1,1.E generc_tern paste c locate . . ......_ .. . . . .. . , . .... ._ .. _ .
gam e so (runs gam e) geneec_tem p3atell .nvtam . . . _ .._ . . .. __ 6o-drEi5w ttf georgia ttf , starto (C.
. . ... .... _ . . . .. .. . _ . .. _ debug o u t he,c tem plate_hb to ryc . . . . . .
debug war' , in pactttf =
version gam estate las tgarn e_tem pbte c pits a therze.b.ted generated obct.ttls (o & .so Abs ) . . _. .. . .... .... _ .
.....
. .
_11/6. - . ilm-adM-e b,he-b,sam pbs .. - _ . ... . . . . . . ..
.. . _ _.------' -7b therdirectorbs-.bc.bde debug- , font: s,Inlm ewonc,rw:ranchfr,scripts',.sWarn.d shEl - - ----Figure 10-1 - SGOS File Tree .....4--, Rev: May 2001 ,v 0 /Shuffle Masterl .............i. . . . OAMINCli 10.B¨RequiredFiles 10-2 B. REQUIRED FILES
Table 10-1 describes the key files in your app.temp game directory.
Table 10-1. Developer Game Files in app.temp Directory rile Name uescription uetails; unapter 6, Appendix rets ! = Make utility generates file aeoug.out ueneratea text tile or debug results, i.,napter debug.warn ! Generated I ext tile ot nvram variable type debug errors, Chapter tontnames.ttr Font tiles Include all tont tiles needed tor game game.state Nvram ¨ game specitic data game_books.c Screen Game books screen "winning statistics";
developer provides data generic_template.c Game template genenc_template.h Game template help.c Help screen text, layout lastgame_template.c Game history screens Game history screens tit tunctions; scroll to last and previous games Hardware settings Optional tile - include to disable coin hop-per etc not set up with devel computer Locate Script Used by Maketile to tind engine.shutl shared.shfl directories Maketile Generates game tiles See Appdx Makes tiles to user/local/
sgos/shared.shfl nvram Generated by game Holds nvram data tor current + I9 previous games; includes certain engine.state data plus user's game.state data Readme Guidelines, updates Appendix ; see L;UKUM tor current tile start.oti Resource initialization Uhapter and Appendix template_history,c Saves history Contains tunctions to save game Mstory Version User's version no, User assigns version no. to track game code updates .o and .so tiles C;ompiled object tiles Placed in user/local/sgos/shared.stitl; reter to Filetree, Fig ____ Rev: May 2001...f.
Ve. / Sh uffle Master = = GAMIIING

CHAPTER 11 ¨ GAME STATES AND MANAGING THE
GAME ENGINE
A. How THE SGOS GAME ENGINE RUNS YOUR GAME
The SGOS game engine and library run all routine game functions and drive the gaming hard-ware. As far as possible, code that could be made common to all games resides in the precom-piled SGOS library. Creating a functional game in SGOS has two primary aspects:
1. Develop the game personality using API functions and C programming.
2. Use game engine hooks to "steer" the actions of the game engine and library.
This chapter will show you how the game engine drives a game, and how you steer where it's going. This steering of the game engine may seem a bit indirect at first. The game engine runs the entire game and only offers you a handful of hooks to guide it. The beauty of this approach is that all of your housekeeping and accounting and hardware interface is already done. You tell the engine at a few key points how it should incorporate your game personality into its grand scheme of safely and securely running the game.
B. INTERFACE BETWEEN GAME AND LIBRARY LAYERS
There are three primary mechanisms that the game and library layers use to pass instructions, executions, and results back and forth, as shown in Figure 2. These are the User API, timer = mechanism, and callback mechanism.
Tools to Create Event-Driven Game Actions:
Game Layer Game-specific code only 1.
Userapi.cpp - Embedded 0/S calls 2. Timer mechanism - User sets timer to A a callback. For instance on an animation or graphics call, when the timer expires the callback is made.
V
3. Callback mechanism - Developer 0/S codes data-driven game actions by tying calls to "data events". For Largest portion of the SGOS example, a change in game data is an Pre-approved library layers event; it generates a callback when the data is touched.
Figure 11-1 ¨ Event-Driven Game Actions =
_______________________________________________________________________________ Rev: May 2001 01' Shuffle/
Master.' y = = =
= IMAMINCS

11.C¨EventQueue 11-2 C. EVENT QUEUE
The event queue is at the center of the SGOS event-driven game approach.
Typical events are covered later in this chapter.
1. Startup and Idle Mode SGOS starts up as follows:
Boot Loader ¨ The boot loader loads everything it is instructed to load, then looks for start.cpp.
Start ¨ Start is the "main" executable. It launches the program as follows:
Initializes operating system tasks Parses the . oti file and starts Resource Manager Parses game. state file (NV RAM handler) Loads game. so (game module) Game.so ¨ Begins execution of the game engine logic.
Idle Mode ¨ Game is now ready and waiting for an "event" to move the game along.
2. Events SGOS is fully event driven. When an event occurs, such as a coin or bill being entered, a program action or series of actions are set in motion. When the event ¨ the program action or series of actions ¨ is completed, the game returns to its idle mode and awaits a new event, The callback functions and timers which drive the events are discussed below.
The game developer can react to or create events from the game side, but all events are serviced on the library side of SGOS.
3. User API
The game layer and deepest library layers of SGOS cannot directly communicate.
These two layers interact via the userapi, data callbacks, and timer callbacks. Data callbacks and timer callbacks will be discussed below.
4. Callback Functions as Game Hooks The game engine offers callback functions as "hooks" into the game. These callbacks let the game developer arrange the needed game events into a unique new game design. All graphics, animation, sounds, and rules and flow of the game can be manipulated with call-backs in the developer's game engine. For instance, Insert example from template,c Rev: May 2001 I44 /Shuffle Aftaster = . = C.AMING

11.D¨TimerCallbacks defines a base callback into the game layer. The callback function gives the game devel-oper a "placeholder" to readily add game-specific logic to the base game engine.
D. TIMER CALLBACKS
Timers are a special API function to place events in the event queue. Both animation and sound tasks are carried out with timer callbacks. The timer format is start ti mer(I ong ti meout, char* callback) The timeout period in milliseconds is the time until a callback is placed on the queue. Once on the queue it is handled on a first-come, first-served basis. Sequence of timer actions should be coordinated to ensure that a needed action is not placed too far down in the queue. Avoid tim-ers for mission critical tasks.
E. GAME STATES AND NVRAM
As noted above, SGOS stores the "state" of various game aspects after any occurrence of events. An event can be any of the following:
= an action by a player of the game, = a subsequent action if the player action causes a chain of events, or = an error.
[Further discussion figures, table, and refer to tutorials]
Rev: May 2001 4 /Shuffle Master , = =
. = CIP. M 1 NI CI

11.E ¨ Game States and nvram 11-4 Developer's Game Program game,h Engine calls to calls to .
game.hengi API
ne game CALLBACK e.g. e.g. API calls to CALLBACK
FUNCTIONS get_bet begin_play library, with FUNCTIONS
via game callbacks to no access =
game via engine NVRAM to engine SGOS Game Engine or timers e.g.
start_timer internal SGOS
SGOS Library Figure 11-2 ¨ API Calls and Callbacks to Game Table 1 shows the five key game states that drive a typical game, and lists the primary callback Table 11-1. SGOS Primary Game States and Callback Functions PRIMARY GAME ENGINE NEXT STATE
GAME STATES CALLBACK FUNCTIONS
SET BY
Game is always be in one of Hooks from the game into the Most set by these basic states. game engine. game engine Rev: May 2001 4:/Shuffle Master = . = G.PlT.11NG

11.E ¨ Game States and nvram 11 -5 Table 11-1. SGOS Primary Game States and Callback Functions Initialization init_game SGOS
Start up or reset game reset_game Engine cache_gfx draw_game_screen enable_max_bet disable_max_bet IDLE attract SGOS
Game up and ready for play animate_idle Engine BEGINPLAY begin_play SGOS
Initiate with coins or other cred- maxbet_game Engine its pick_numbers update_lights update_buttons PLAY1 play_one Game First play sequence update_lights update_buttons PLAY2 play_tvvo Game Subsequent play sequence update_lights update_buttons EVALUATE evaluate_game SGOS
Evaluate for win or bonus check_for jackpot Engine check_for_bonus 4A. BONUS bonus animate_winner 4B. JACKPOT award_sound update_lights update_buttons FINISH finish_game SGOS
Payouts and bookkeeping update_lights Engine update_buttons Note: The above callback functions are hooks into the SGOS game engine and library. The game engine performs housekeeping and hardware functions, and provides the callbacks as appropriate to move the game along. The game developer creates a new game personality by defining how the callback functions are handled.
functions that must occur for the game to run. Numerous other callback functions are available for game design, but the game engine looks for these primary callback functions to advance through a game.
The engine includes twenty-two states, many of which you will not see at the game layer. The following is a complete list of SGOS game states, as defined in gamestate. h:
Rev: May 2001 4Shuffle Master = . . 4:1A1M1r4c.

11.F ¨ Schematic of Game State rrogression 11-6 IDLE
BEGINPLAY

EVALUATE
FINISH
CREDITSIN (no game-specific aspects) COUNTDONN (no game-specific aspects) JACKPOT (no game-specific aspects) HANDPAY (no game-specific aspects) SETUP (no game-specific aspects) PAYOUT (no game-specific aspects) BETTING (no game-specific aspects) BONUS
BONUSCOUNT (no game-specific aspects) MAINMENU (no game-specific aspects) AUTHORIZE (no game-specific aspects) COUNTDOWNHOPPER (no game-specific aspects) TEST (no game-specific aspects) HOPPERTEST (no game-specific aspects) BILLTEST (no game-spec?fic aspects) ATTRACT
***update this list***
F. SCHEMATIC OF GAME STATE PROGRESSION
Add discusssion and also update Figure 11-3 Rev: May 2001 Shuffle Master = , . GA MIN.=

11.F ¨ Schematic of Game State Progression 11-7 IDLE
I ATTRACT
If award or pay T> animate winner( ) attract( ) If credits = cash limit T > PAYOUT changes game state back to IDLE
if 5 mins no cre= dits and T ATTRACT
not touched INITIALIZE
If Ram Test = clear = > reset_game( ) =
V
reset_game_history v<
init_game( ) LEGEND:
/ BOLDCAPS = game state cach_gfx( ) UNBOLDCAPS = game state ref.
lower case( ) = function callbacks/hooks to engine / plain lower case = test or comment draw_game screen( ) T = TRUE
NOTES:
animate idle( ) 1. If the provided SGOS templates are used, the game code must use the state machine and related game hooks.
2. The generic, 9 line, and poker update_lights( ) templates in SGOS V 2.0 use the states and hooks shown.
check_for bonus( ) if bonus = > bonus_complete( ) if win = > animate winner( ) Figure 11-3 ¨ State Machine and Related Game Hooks Rev: May 2001=
4 It /Shuffle Master . . I GIA.M1INIG

11.F ¨ Schematic of Game State Progression 11-I BEGIN PLAY *PLAY1 PLAY2 V
pick_numbers( ) playl ( ) play2( ) V
begin_play( ) game sets state to PLAY2 game sets state to EVALUATE
V

EVALUATE
evaluate_game( ) V
check_for_bonus( ) V
=
if no award and no bonus T > FINISH
if award _____________________________ > animate_winner( ) check_for _jackpot if jackpot T > JACKPOT
V
if bonus T > BONUS
if award > handpay > HANDPAY
COUNTDOWN
Figure 11-3. State Machine and Related Game Hooks ¨ Continued Rev: May 20010.4. 4 /Shuffle Master . = .AJWINC.

11.F ¨ Schematic of Game State Progression 11-9 JACKPOT
casino operator must reset with key IBONUS T > bonus( ) HANDPAY
FINISH
I PAYOUT
FINISH
l COUNTDOWN l if credit + award T if award T COUNTDOWN
> credit limit < cashout limit HOPPER
HANDPAY
if snap > play snap.wav FINISH
FINISH - CREDITS IN
V
save_game_history( ) play credit.wav V V
update_lights( ) update lights() V V
animate idle( ) if credits = cash limit T > PAYOUT
V
finish_game( ) IDLE
Figure 11-3. State Machine and Related,Game Hooks - Continued Rev: May 2001,1--/Sh uffie Master =,õ,y = =
GAMING

11.F ¨ Schematic of Game State Progression 11-1 0 Rev: May 2001 /Shuffle Master e.b..." = = = = GAMING

CHAPTER 12 - INITIALIZATION (.0TI) FILE
A. BASIC SETTINGS
B. DON'S NEW SECTION
C. ETC.
Rev: May 2001 49 /Shuffle Ntasterl . = = cawextran A. MULTIGAME CONSIDERATIONS
game_register game_load game_inprogress game_getcurrentstate game_setcurrentstate game_setdenomination B. NAMING OF FILES
C. .0T1 INITIALIZATION
=
Rev: May 2001?Shuffle Master"
4.
. . .
awmi CI

A. C COMPILER
Different compilers may use different instructions. To ensure consistency with SGOS and the Makefiles, stick with the popular gcc C compiler. A copy is included with SGOS.
B. MAKEFILE
The make tool and related Makefi I e will be familiar to Linux and UNIX users.
make is a very powerful way to manage and update your game projects. The Makefi I e tells make how to set up dependencies and compile your files. Once you set up the Makefi I e for a project you can quickly recompile and retest your program as you make modifications.
Appendix B explains more about how to set up your Makefi I e, and provides an example which covers the basics you need to build a game in SGOS. However, the appendix only scratches the surface of a tremendously powerful tool, and you may want to use additional features. If you do not already have one, a good Linux programming book is highly recommended.
If you are new to make and the Makefi I e, the tutorial examples will provide good practice in using them to build simple games. File Listing 16-2 in the first tutorial chapter starts you out with a makefi I e for a single file "game" that simply draws a "Hello World"
text string. In the five tutorial chapters that follow you use the makefile several more times to add graphics and other files.
C. CREATION OF REEL STRIPS TOOL
The Makestrips utility will turn a list of par-sheet (tab-delimited text) files into C source code arrays. This Python Script tool is listed and documented in Appendix H. The tile is included on the SGOS CD-ROM. Once you see how Makestrips works, you might prefer to devise your own tool to set up reel strips.
D. GRAPHICS CONVERSION TOOL
You may have numerous graphics files for your game, especially if you have complex anima-tions. Your game must include each graphic icon as an array in XPM format. The included Python Script tool convgfx. py provides a simple way convert your graphics all at once and place them into one graphic icon file. Help in using this tool and further organizing your icons can be found in the following places in this manual:
= Chapter 7 tells how to use convgfx. py and suggests ways to further arrange your icons.
= Chapter 17 includes a simple example that converts a single icon to an XPM array.
= Chapter G provides a file listing of convgfx. py.
As with the other SGOS tools, you may want to create a graphics conversion tool of your own that best suits your design approach.
Rev: May 2001 Sh u ffle Master"
= = a, A vr l N

14.E¨DebuggingTools 14-2 E. DEBUGGING TOOLS
1. gbd Linux Tool gbd is a popular and powerful Linux tool. It is highly recommended.
2. sys_debug() sys_debug() is an API call included with SGOS that allows you to put debug statements in your code, and they will be included in debug. out. ***is name changed?***
You set debug preferences in the .oti file as follows:
debug :
output : file;
options : {all; }
In this example all will yield copious results for all declared variables.
**What are other .oti options?***
You use printf-style formatting to call out each occurrence you want to see in the debug. out file with void sys_debug (char* format, ... ).
You pass a format string followed by variables, if any.
The tutorial in *** gives a helpful example that sets up debug items with extra formatting to help certain timer actions stand out in the generated debug. out file.
3. debug.warn and dbug.out On your development computer (but not on a target machine) SGOS creates debug.
out and debug. warn in the current directory. They are log files created if the game is run with a library compile with the debug option turned on.
debug. warn will let you know of any type mismatches getting or setting variables in nvram, such as passing a character to a variable set as an integer.
debug. out provides a text file of results (e.g. gets and sets from RAM, all events on queue, etc.) for the options set by the user. Programmer can set the level of debug output.
Rev: May 2001 /Shuffle Master == = .=
raie4c.

A. BUILDING A GAME ON DEVELOPMENT PLATFORM
make, Makefile, etc B. TESTING CONSIDERATIONS
maybe not C. BUILDING A GAME ON A TARGET MACHINE
Ref Ch xx hdwr sol'n Gen notes Rev: May 200'1 a'tt ?shuffle Mastell = = clavalirva = 102 IV,. API TUTORIAL
Chapter 16 - Displaying Text Chapter 17- Drawing an kon Chapter 18 - Using the Frame Buffer and Timers Chapter 19 - Adding Buttons Chapter 20 - Using Timers to Move an kon Chapter 21 - Tutorial: Using Nvram Rev: May 2001 q".
/Shuffle Master!
. =

A. OVERVIEW
This chapter creates a simple "Hello World" program using SGOS library calls.
The tutorial will include the following SGOS tools and concepts:
= Using SGOS API calls = Building an operable "game" with the Linux make utility = A few basic guidelines about managing files for an SGOS game B. ASSEMBLE NEEDED FILES TO RUN SGOS
In your installed sgos directory, create a directory named app. tutori al with the mkdi r com-mand:
[sgos]$ mkdi r app. tutori al -.4 .%, TIP... Refer to Chapter 10-A, File Tree and Figure 10-1 ¨ SGOS File Tree to see how -.. it 1 directories and files are arranged in SGOS. III. GAME DEVELOPMENT will cover icom-plete file setup requirements for a game.
To successfully run the example you will need to include several files in your new directory.
The following files must be in [your path]/sgostapp. tutori al for Example 1:
1. Makefi I e used to build the game 2. examp I el . c the Hello World file you just created 3. game. state used here only to launch SGOS
4. i mpact. ttf truetype font 5. I ocal . oti configuration file for running SGOS on your desktop computer Locate these files (again refer to the file tree) and copy them to your new app. tutori al direc-tory.
i., ... WARNING! Note that I ocal . oti replaces start. oti for your desktop development com-:,'S puter. I ocal . oti disables hardware such as the bill handler and coin hopper. If they are not ; disabled your computer may crash when the program looks for them.
C. USING GFX FUNCTIONS FROM THE USERAPI
This first example is a very simple "Hello World" screen. The code should look familiar if you are an experienced C programmer.
You will need exampl el. c as shown in File Listing 16-1. Copy it from the CD-ROM to your app. temp directory, or type it in directly using any text editor.
Line 1 includes the header file userapi . h, which defines all of basic API
functions needed for SGOS programming. Chapter 5 provides an overview of the available routines.
Appendix C
Rev: May 2001 iaShuffle Niasteii ,......õ.". .. = =
MA Ft u4.

16.D ¨ Using Make and the Makefile 16-2 File Listing,16-1: examplel.c 1 #i ncl ude "userapi . h"
2 void i ni ti al i ze(voi d){
3 gfx_cl earscr (0) ;
4 gfx_setfont ("i mpact. ttf" , 72);
gfx_drawstri ng(100, 100, "Hel I o Worl d", RGB (255, 255, 255), -1);
6 }
This file is included in the SGOS installation CD-ROM tutorial directory.
gives a complete listing with explanations.
The remaining code in exampl el. c defines i ni ti al i ze(), which is the first function the game engine will call after loading the module. The gfx functions are API routines, used as follows:
Line 3 gfx_cl earscr( ) clears the screen buffer to white. Note that 0 is equivalent to RGB(0, 0, 0) in the RGB color convention.
Line 4 gfx_setfont( ) sets the current truetype font and point size. Each font you specify must be in your program's directory. The font and point size will stay the same until you change it with another gfx_setfont( ).
Line 5 gfx_drawscreen( ) puts the string "Hello World" on the screen buffer.
100, 100 locates the lower left corner of the string at (x, y) = (100, 100) on the 800 x 600 pixel screen.
RGB(255, 255, 255) defines black as the font color. RGB(r, g, b) is a macro function in the SGOS library.
TIP... The last parameter of gfx_drawscreen() is an RGB background color. -1 is shorthand which SGOS converts to a transparency. Likewise, 0 is shorthand for RGB (0, 0, 0), which is white.
Chapter 7-G, Colors Reserved for Transparency explains how SGOS handles RGB
colors and transparency.
D. USING MAKE AND THE MAKEFILE
If you are new to Linux, you will soon find that the make utility is a powerful tool to build, compile, and manage your programs as you develop them. Chapter 14-B, Makefile provides an overview, and you can learn more about make in a Linux programming book.
1. Creating the Makefile for exampletc File Listing 16-2 shows the generic Makefi I e you will need to create projects for all the tutorial examples. You can copy this tutorial version of Makefi I e from the tutorial direc-tory of the CD-ROM app. temp diectory or type it from scratch using any text editor.
Note that lines 13 and 14 of Makefi l e refer to examp I el . o, the object file you will create for the Hello World example. For the other tutorial examples, you will change these lines to exampl e2. o, etc. and add any other needed files before you build the example game.
Refer to the Makefile listing in Appendix B for a review of syntax and dependency rules.
Rev: May 2001 IShuffle Master = = = a GAMING

16.E ¨Runningthe Program 16-3 File Listing 16-2: Makefile for example1.c 1 # Makefi I e for the exampl es 2 . SUFF I XES: . cpp .c .so 3 DEBUG=-g 4 SGOS=${shel 1 . /I ocate sgos}
INCLUDE=-1.. -l$(SGOS) 6 . c. 0:
7 gcc $(INCLUDE) -c -Wall -fPI C -o $@ $<
8 . cpp. o:
9 g++ $ (1 NCLUDE) $ (DEBUG) -c -o $@ $
. o. so:
11 gcc -shared -o $@ $<
12 all: game. so 13 game. so: examplel . o 14 gcc -shared -o game. so exampl el . o This file is included in the SGOS installation CD-ROM tutorial file.
Line 13 game. so: exampl el . o says that game. so is dependent on exampl el. O.
Line 14 gcc -shared -o game. so exampl el . o is a command to make a shared object out of exampl el. o and name it game. so.
When make looks at this klakefi I e, it will first try to make al l. It will next look at the rule for al l and see that it first needs to make game. so. Further rules tell Make that it needs exampl el. o, and to make exampl el . o out of exampl el . c. The final result is a new game. so.
2. Compiling the Hello World Program To run the program you must first compile it using make. The build process is as follows:
[app. tutori al ]# make gcc -1.. -1.. /framework -c -Wall -fPI C -o test. o test. c gcc -shared -o game. so test. o As noted above, the program will be compiled as a shared object file named game. so. If you are new to Linux, the shared object file is analogous to a Windows dl I
file. When the module loads, the first function it will execute is i niti al ize().
E. RUNNING THE PROGRAM
To run exampl e1. so, you must invoke SGOS by running start; start then loads the shared object file game. so to run the game. The game will call the function i ni ti al i ze(), which you defined in exampl e1. c.
To run start you must be the "super user" (a Linux term meaning you have access to the root directory). If you are not logged in as root, type su and the password to become root. Then run the program as follows:
[app. tutor i al ]# /usr/I oca I /sgos/engi ne. shfl /start [svgal b: al 1 ocated virtual console #8]
Starting: display modules timer Rev: May 2001S uffle Master = = GA/4114G
= '?

16.F¨Exercises 16-4 You should see the following screen displays:
1. Blank screen.
2. SGOS startup screen.
3. Background comes up transparent, from your gfx_drawstri ng parameter of -1.
4. The words "Hello World" will appear in black, as shown in Figure 16-1.
Hello World Figure 16-1 - Tutorial: Hello World Screen Press q to quit the program.
F. EXERCISES
You may want to make some changes to some of the parameters in this simple file to observe the response:
1. Change the font (you should have georgi a. ttf in your app. temp directory).
2. Change the font size and color.
3. Change the color of the screen buffer by changing 0 to an RGB() value.
4. Replace the -1 transparency with an RGB() value.
5. Move the text around.
6. Center the text on the screen buffer by replacing gfx_drawstri ng() with gfx j usti fystri ng(0, 0, 800, 600, "Hel I o Worl d", 0, JUSTI FY_CENTER, -1).
You can also add a new line character with gfx j usti fystri ng(), for instance "Hel I o\nWorl d", which gfx_drawstri ng() does not support.
Sater colar5 are changed for readathlly.
Rev: May 2001 a It Shuffle Ik/laster =
. = . GAMING

A. OVERVIEW
This chapter puts a simple graphic icon into the source file and then draws it on the screen. The tutorial will include the following SGOS tools and concepts:
= Graphics conversion tool and XPM format = SGOS transparency = Further examples of SGOS gfx functions and using the Makefile B. CONVERTING A GRAPHIC TO XPM FORMAT
You must convert all graphics to the special bitmapped XPM format to display them in SGOS.
Chapter 7 gives details about the conversion tool and how SGOS handles graphics. Copy the file bal I ti f from the CD-ROM into your app. tutori al directory, and use the Python script conversion tool convgfx. py as follows:
[app. tutori al ]# . /convgfx. py bal I _gfx Running the script creates the C++ file bal I _gfx. cpp and the header file bal I _gfx. h. File List-ing 17-1 shows how the XPM format maps out the graphic of the ball as the array const char*
const ba I I []. In this case it is easy to see the shape of the ball since the graphic has only two colors, represented by the hex characters . and 9. Although it looks egg-shaped as represented by the characters, it will be round when the actual pixels show up on the screen.
convgfx. py defines each graphic array as the name of the file it came from, except that the file suffix, in this case . ti f, is dropped. As a result this graphic array is named bal l. convgfx. py is fully listed in Appendix G. You can modify it or write your own script if you like, as long you generate the needed . c and . h files.
C. USING SGOS GFX FUNCTIONS TO DISPLAY A GRAPHIC
You can copy File Listing 17-2 from the SGOS CD-ROM app. temp directory or type it directly.
This file looks like exampl el. c, except that you must add the bal I _gfx. h header file to include the bal I graphic, and use different SGOS graphics functions as appropriate to display the icon.
Only lines 2, 5, and 6 have changed, with the following effects:
Ln 1-2 Again include userapi . h, plus the file bal l _gfx. h. created by the graphic conver-sion tool. The header file simply tells the compiler there is a graphic named ball.
Line 3 Again, i ni ti al i ze 0 will be the first function executed upon loading.
Line 4 gfx_cl earscr( ) clears the screen to black. 0 is equivalent to RGB (0, 0, 0) Line 5 gfx_drawi conX13110 puts the graphic onto the screen. SGOS calls graphics "icons,"
hence the name drawi conXPIA for the function that draws a graphic of type XPM

created by convgfx. py. The number pair are the coordinates of the upper left corner Rev: May 2001 ....4.1*0 /Shuffle Nlasteri P1 = = aamin Lt.; - Using SGOS gfic Functions to Display a Graphic 17-2 File Listing 17-1: ball_gfx.cpp #i ncl ude "bal I _gfx. h"
2 const char` const bal I = {
3 /4 width height num_col ors chars_per_pi xel 4/
4 " 50 50 2 1", /4 col ors 4/
6 ". c #00aa00, 7 "9 c #ff0Off", 8 /4 pixels */
"99999999999999999999999999999999999999999999999999", "99999999999999999999999999999999999999999999999999", "99999999999999999999999999999999999999999999999999", "99999999999999999 ...........................................
99999999999999999999", "99999999999999 ..............................................
999999999999999999", "999999999999 ................................................
99999999999999999", "99999999999 .................................................
999999999999999", "9999999999 ..................................................
99999999999999", "999999999 ................................................... 9999999999999", "99999999 .................................................... 999999999999", "9999999 ..................................................... 99999999999", "999999 ...................................................... 9999999999", "99999 ....................................................... 999999999", "99999 ....................................................... 999999999", "9999 ........................................................ 99999999", "9999 ........................................................ 99999999", "999 ......................................................... 9999999", "999 ......................................................... 9999999", "999 ......................................................... 9999999", [continued, for the bottom half of the ball...]
Code shown at reduced size to show use of 9 as transparency.
File Listing 17-2: example2.c 1 #i ncl ude "userapi . h"
2 #i ncl ude "ba I I _gfx. h"
3 void i ni ti al i ze(voi d) {
4 gfx_cl earscr(0);
5 gfx_drawi conXPM(200, 200, (char**)bal l);
6 gfx_draw3dbar (100, 100, 200, 200, -1, RGI3(0, 0, 100), RGB(100, 0, 0), 5);
7 }
This file is included in the SGOS installation CD-ROM tutorial file.
of the graphic. The SGOS function gfx_drawi conXPM() typecasts ba I I so it will be passed correctly, since it is defined as a constant. The graphic in the file ba I l_gfx. cpp will be joined with this file at link time. The graphic is simply an array of strings as you saw in File Listing 17-1.
Line 6 gfx_draw3dbar(100, 100, 200, 200, -1, RGB(0, 0, 100), RGB(100, 0, 0), 5) draws a blue and red box.
Rev: May 2001 ''.2q ?Shuffle Master . = . -mk.mer na 17.D¨ReviseMakefile 17-3 D. REVISE MAKEFILE
You also need to change the Makefile as shown in File Listing 17-3 to define the dependency of show_bal 1 o on the file bal I _gfx. o.
File Listing 17-3: Makefile for example2.c 1 # Makefile for the examples 2 . SUFF I XES: . cpp .c .so 3 DEBUG¨g 4 SGOS=Ushel I . /I ocate sgos}
INCLUDE¨ I . . -1 $ (SGOS) 6 . c. o:
7 gcc $(INCLUDE) -c -Wall -fPI C -o $@ $
8 . cpp. o:
9 g++ $(INCLUDE) $(DEBUG) -c -o $@ $<
. o. so:
11 gcc -shared -o $@ $<
12 all: game. so 13 game. so: exampl e2. o ba I I _gfx. o 14 gcc -shared -o game. so exampl e2. o bal I _gfx. o This file is included in the SGOS installation CD-ROM tutorial file.
Lines 1 though 12 are unchanged.
Ln 13-14 game. so: examp I e2. o ba I I _gfx. o tells make that the shared object, game. so, depends on these two files. Also, you add ba I I _gfx. o to the gcc compile instruc-tions.
E. RUNNING THE PROGRAM
You will see the same SGOS startup screen displays as in the previous example.
Then you should see the ball as shown in Figure 17-1, below. Press q to quit.
111:1 Figure 17-1 - Tutorial: Ball Icon Screen Display Rev: May 2001 te r-4 /Shuffle Master. ./
= . GAMING

17.F ¨ Change the gfx Function to Make Transparency Work Correctly 17-4 F. CHANGE THE GFX FUNCTION TO MAKE TRANSPARENCY WORK CORRECTLY
The ball showed up with a bright magenta icon background, because the character 9 in file ba I I _gfx. cpp denotes RGB (255, 0, 255), pure magenta. The convgfx . py conversion tool con-verted the tiff transparent pixels to this color. You can telIthe API you want a transparency by using a graphics function that supports transparency. Replace gfx_drawi conX1,110 with gfx_drawtransX1410 as follows:
gfx_drawtransX141(200, 200, (char**) bal I , "9") Make this change in your exampl e2. c code and then rebuild and run the program. The "trans-parency" created by gfx_drawtransX1,110 actually retrieves pixels as needed from SGOS's lat-est background screen, to effectively create a transparency. Generally, the background screen must be updated for this to work. In this simple example it looked transparent because the screen was still a default black. The next example in Chapter 18 will show how to update the background screen and introduce other transparency options.
G. EXERCISES
Try these or other changes to the exampl e2. c file:
1. Notice what happens if you change the screen color by passing a different RGB value to gfx_cl earscr(), e.g. RGB (255, 100, 100). A black box will appear around the ball. It did not show up before since the screen was black. The frame buffer causes this, and the next chapter will show you more about some important nuances of screen buffer-ing.
2. Try converting other graphics and showing them.
3. Include more than one graphic file, and show multiple graphics at once.
Rev: May 2001 $4,1 4,/Shuffle Master GAMING

A. OVERVIEW
This chapter uses the off-screen frame buffer and introduces timers. The tutorial will include the following SGOS tools and concepts:
= Copying the screen buffer to the frame buffer = Using timers and callback functions for animation = Role of the event queue = Example of interaction among nested timers B. USING THE OFF-SCREEN FRAME BUFFER AND TIMERS
1. Updating the Off-Screen Frame Buffer The examples so far have drawn directly to the screen buffer. This chapter will show how to use the off-screen frame buffer. The API graphic routines that update and use the frame buffer are at the heart of SGOS animations. This chapter will use gfx_copybuffer() to update the frame buffer (also called the "background"), and it will use gfx_copybufferpart() to erase things from the screen buffer.
Recall in the previous tutorial example that gfx_drawtransXPIA0 "accidentally"
made a correct transparency, only because the default all-black frame buffer happened to match the all-black screen buffer. In this chapter the background will be multicolored, so gfx_copybuffer() is needed to update the frame buffer.
Chapter 7 gives details about how SGOS uses the frame buffer for transparency and screen updates. Appendix C lists and describes the API functions.
2. Using Timers for Animation SGOS event-driven programming makes extensive use of timers. With every event on its own timer you can easily add and remove items from the screen. Also, by using functions which call themselves back via timers, you can start animations once and not have to worry about them again.
Chapter 18 explains how timers work and their key role in SGOS programming.
Basi-cally, a timer is a request to call a function at a certain time. When the timer expires, the request to execute its function is placed on the SGOS event queue. If there are already many functions on the queue or if an executing function is already running, the call to your function will be delayed. So, the actual duration of a timer is only approximate.
A timer is good for only one call. If you want a function to be called repeatedly, you can start as many timers as you need or have the function start a timer to itself before it is done executing.
A timer starts with the API call to ti mer_start(). You specify a time delay in millisec-onds and a function name (not a pointer). For example, ti mer_start(100, "draw_screen") Rev: May 2001 Shuffle Nlasteri = I = CIAMINC1 18.C¨WritingtheProgram 18-2 tells the API to execute the function draw_screen() in 0.1 seconds. Note that the name of the function is used, and not a pointer. The function is not called with any parameters, so you would declare draw_screen as voi d draw_screen(voi d).
Multiple occurrences of a timer can call the same function multiple times. For instance, ti mer_start(100, "draw_screen");
ti mer_start (200, "draw_screen");
will call draw_screen() in 0.1 and 0.2 seconds from now. SGOS has a system limit of 60 timers at any one time. This should not limit your options because calls spend little time in the event queue. The limit is in place because more than 60 timers could create a bottle-neck on a typical processor for a target machine.
C. WRITING THE PROGRAM
Copy exampl e3. c from the CD-ROM into your app. tutor i al directory. It should look like File Listing 18-1.
This example will give you a good taste of several timers going on at once.
Timers and their callback functions are a crucial part of SGOS programming. Once you get used to them, you will find they often simplify your code requirements. Rather than having to tightly control when everything happens, you can launch several different types of actions with no worry they will collide. Each timer will launch its callback function when it comes up the event queue. It does not care what the other callbacks are doing¨even if another function fails, it will keep going!
Tutorial exampl e3. c uses timers, for loops, and a clever incrementing of colors to make a lot happen on the screen. You may want to make various changes to the timers and gfx functions to see the effects.
Ln 1-2 Include userapi . h and bal I _gfx. h graphic. Leave the ball in the program, since the next program, which builds on this one, will use it.
Ln 3-8 Define several colors and dimensions.
Ln 9-13 Declare several prototypes: draw_screen() draws the checkered screen;
counter(), fl asher(), bl i nker() and bl i nker2 () are the timer callback functions.
Ln 14-15 count and fl ash are global variables used by counter() and flasher(), respec-tively.
Ln 16-22 i ni ti al i ze() first draws the screen, then continues with these steps:
Copies the screen buffer into the frame buffer with a call to gfx_copybuffer().
Initializes the global variables Starts two timers, one to call counter() in 0.1 seconds and one to call fl asher() in 0.75 seconds.
Ln 23-34 draw_screen() first clears the screen buffer to black, then fills in the entire screen buffer with a grid of boxes, using two for loops, below.
ROT_COLOR cycles through some colors by incrementing the color integers.
Ln 35-38 The counter() function performs the following:
Rev: May 2001 iShuffle Master = = =
= GP. MING

18.C¨ Writing the Program 18-3 File Listing 18-1: example3.c 1 #include "userapi.h"
2 #include "ball_gfx.h"
3 #define COUNTER_COLOR RGB(255,0,0) 4 #define FLASHER_COLOR RGB(0,0,0) #define SCREEN_WIDTH 800 6 #define SCREEN_HEIGHT 600 7 #define BASE COLOR Ox1dab 8 #define ROT_i0LOR(a) (((a 1) + (a 14)) & Ox7fff) 9 void draw_screen(void);
void counter(void);
11 void flasher(void);
12 void blinker(void);
13 void blinker2(void);
14 int count;
int flash;
16 void initialize(void) {
17 draw_screen();
18 gfx_copybuffer(GFX_SCREENBUFFER,GFX_BACKGROUNDBUFFER);
19 count = 0;
flash = 0;
21 timer_start(100,"counter");
22 timer_start(750,"flasher");
23 void draw_screen(void) {
24 int x,y;
int color;
26 gfx_clearscr(RGB(0,0,0));
27 color = BASE_COLOR;
28 for(y=0;y<=SCREEN HEIGHT-50;y+=50){
29 for(x=0;x<=SCiEEN WIDTH-50;x+=50){
gft_drawbar(x,y,50,50,color);
31 color = ROT_COLOR(color);

void counter(void) {
36 count++;
37 gfx_setfont("georgia.ttf",36);

gfx copybufferpart(100,100,200,50,100,100,GFX_BACKGROUNDBUFFER,GFX_SC
REEiBUFFER);
39 gftjustifystring(100,100,200,50,ideci(count,4),COUNTER_COLOR, JUSTIFY CENTER,-1);
41 timer_start(106,"counter");
42 ) Rev: May 2001 /Shuffle Master rly = pal iv 18.0 ¨ Writingthe Program 18-4 File Listing 18-1: example3.c (continued) 43 void fl asher(voi d) {
44 fl ash = 1 - fl ash; /* toggle fl ash */
45 f (fl ash) {
46 gfx_setfont(" i mpact. ttf", 72);
47 gfx j usti fystri ng (0, 300, 800, 300, "FLASH! ", FLASHER_COLOR, 48 JUSTI FY_CENTER, -1);
49 ti mer_start(50, "bl i nker");
50 }else{

gfx_copybufferpart(0, 300, 800, 300, 0, 300, GFX_BACKGROUNDBUFFER, GFX_SCREE
NBUFFER);

53 ti mer_start (750, "flasher");
54 ) 55 void bl i nker (voi d) {
56 i f(fl ash) {
57 gfx_drawtransXPM(525, 175, (char**)bal 1, "99");
58 ti mer_start (50, "bl i nker2");

61 void bl i nker2(voi d) {

gfx_copybufferpart (525, 175, 50, 50, 525, 175, GFX_BACKGROUNDBUFFER, GFX_SCR
EENBUFFER);
63 ti mer_start (50, "bl nker");

This file is included in the SGOS installation CD-ROM tutorial file.
Increments the global variable count.
Sets the current font to 36-point Georgia.
Enlists gfx_copybufferpart0 to copy a rectangle from the frame buffer to the screen buffer. The first four arguments define a rectangle in the frame buffer by specifying top left corner, width and height. The next two arguments locate the rectangle on the screen, based on the top left corner of the rectangle, and the last two note the source and destination buffers.
Ln 39-40 gfx j usti fystri ng() displays the count on the screen. i deci () is a utility function in userapi . h that converts an integer to a string. The 4 argument to i deci () is the number of digits from the least significant digit to display (e.g. 23456 would be displayed as 3456). It passes back a char pointer to a global buffer which is valid until the next call to i deci O. gfx j usti fystri ng() is first given a rectangle (as top left corner, width and height), the string to display (given by i deci ()), the text color, the justification of the string in the box (in this case it is centered both verti-cally and horizontally), and finally the background color, which is -1 for transpar-ent.
Line 41 Finally, counter() starts another timer to call itself back just before it exits.
Ln 43-54 The fl asher() function is similar to counter. It first toggles its global variable which tells whether fl asher() is flashing on or flashing off.
Rev: May 2001 RA' /Shuffle Master Y = = =
.=....twar.sc.

18.D ¨ Minor Changesto Makefile and Compile 18-5 If it is flashing on, it sets the font to 72-point Impact and draws its string centered in the bottom of the screen. It then starts a timer to bl i nker().
Otherwise, fl asher() erases the text from the screen buffer with a call to gfx_copybufferpart().
In either case, it then starts a timer to call itself back.
Ln 55-60 The bl i nker() function first checks to see if fl asher is on or off by checking the global variable fl ash. If fl asher() has displayed text, bl i nker() draws the ball icon and then starts a timer to call bl i nker2().
Ln 61-64 The bl i nker2() function erases the ball icon by copying the corresponding rectan-gle from the frame buffer, and if fl asher() is still displaying fl ash, starts a timer to call bl i nkerO.
D. MINOR CHANGES TO MAKEFILE AND COMPILE
Make and compile the program. Change the filename to exampl e3. c. Otherwise this will just be a simple update with no new directives. Although this program does not use the ball graph-ics, leave the ball in the program since the next example will use it.
E. RUN THE PROGRAM
Run the program the same as in the previous examples. After the startup screen you should see the screen filled with a checkered pattern, and the text animations should flash and count, as shown in Figure 18-1.
Unlike the two previous examples, which gave static screen results, exampl e3.
c will keep blinking and flashing until you quit.
Press q to quit.
F. EXERCISES
Make these adjustments and any others that look interesting. See how your program responds:
I. change fl asher 0 so that it is on the screen for .75 seconds and off for .5 seconds.
2. add a function called mover() which moves a ball across the screen. Have it cued to begin when count==300. Have it end when count==500. Continue in this way; turn on when count%300==0, turn off when count%300==200.
Rev: May 2001 /Shuffle Master . = .

18.F¨Exercises 18-6 =
4,:k44-' = itc:FiZ' -. . . ..
--12 = P" , õ...,; . ..õ.., ch2ngec 'or readabiliiy.
..=5_ = . .,õ gri7--õ1,1,,=,z - k,-,- , : _.
fr' pl,.õ,-õ..õ. =, - rt -... .., :.-,z .1 r.:',--m 11(-;,--e,:' ,,.:1".. i.i.s-Iii ''-z...'..flf.-.::: ' t...041-'7.;:::
, ii`;'.
XT::Zr'g-.. _ .:..;%,r -:"., .'.-IN!'.;".=:',.`:';.. 413=-:1=,:i, :,..1-ss.-......._, i. s.s Itt,s1ss.:,=,:_ is E. ' ., 7.'-.',1";;;:''I'l..=:: ',.,.:,,,t:''';'11 .,..,_ '1'-'-'-' ' . -., .,:i .2,...,,,, Figure 18-1 ¨ Tutorial: Frame Buffer with Counter The next tutorial example will add buttons to launch an animation arid modify its mission while it runs.
Rev: May 2001 I 4 /Shuffle Master . . = = C.^

A. OVERVIEW
This chapter adds buttons and other new features to exampl e4. c from Chapter 20, to give you practice with additional SGOS functions and design approaches. The tutorial will include the following SGOS tools and concepts:
= Add buttons for on/off and reset actions = Add sound = Add a ball direction component to show further button and timer nuances = Use the frame buffer differently to reduce flicker B. USING SGOS BurroNs In this chapter you will add several buttons to launch or modify program actions. The three SGOS button types and "hot spot" routine all work in the same way. The example will use the simplest button type, which contains a simple text string. To learn more about the role of but-tons and their API routines, refer to Chapter 6-G, Button Events and Appendix C.
If the target machine will have mechanical buttons, they can make calls to the same functions.
You define hardware lights and switches (panel layout) in the initialization file start. oti . See Appendix D for details.
WARNING! Do not put buttons in the off-screen frame buffer. As a general rule, make sure that you add buttons to the screen buffer after you use gfx_copybuffer().
If you copy a button from the background to the screen you may get a picture of a button with no func-tionality.
C. WRITING THE PROGRAM
Copy exampl e5. c into your app. tutori al directory. It should look like File Listing 19-1.
This example builds on the previous tutorial in Chapter 20. Some of the previous routines are divided into several more functions so each can be distinctly called. The three buttons you add will start, stop, or reset the balls.
First, a brief overview of what the exampl e5. c program does:
1. Builds the checkered screen with buttons.
2. When player presses "Go" button:
a. Starts timer with callback to animate the balls b. Plays a button sound c. Keeps animation routine going with a timer and callback to itself d. Due to the "gravity" function, balls gradually collect at bottom of screen 3. When player presses STOP1 button:
a. Kills all timers, which stops all balls b. Plays a button sound Rev: May 2001 10/Shuffle Master = = eSAMINCI

19.0 ¨WritingtheProgram 19-2 File Listing 19-1: example5.c 1 #i ncl ude "userapi . h"
2 #i ncl ude "bal I _gfx. h"
3 #defi ne BALL_WIDTH 50 4 #defi ne BALL_HEI GHT 50 #defi ne SCREEN_WIDTH 800 6 #defi ne SCREEN_HEIGHT 500 7 #defi ne GRAVITY 3 8 #defi ne NUM_BALLS 1 9 #defi ne BASE_COLOR Ox1dab #defi ne ROT_COLOR (a) ( ((a 1) + (a 14)) & Ox7fff) 11 typedef struct 12 i nt x, y;
13 i nt x_vel , y_vel ;
14 } bal I _struct;
voidinitialize(void) 16 void draw_screen(voi d);
17 void draw_gri d(voi d);
18 void i ni t_bal I s(voi d);
19 void ani m_bal I s(voi d);
void cal c_pos(bal I _struct * b);
21 void draw_bal I s(voi d);
22 void erase_bal I s(voi d);
23 void draw_tel emetry(voi d);
24 void go_button(voi d);
void stop_button(char * name);
26 void reset_button(voi d);
27 void refresh_screen(voi d);
28 bal I _struct bal I s[NUM_BALLS];
29 i nt step;
void i ni ti al i ze(voi d) 31 draw_screen ;
32 step = 0;
33 ni t_bal I s();
34 ti mer_start (100, "draw_tel emetry")}
void draw_screen(voi d) 36 gfx_setgraphi cscontext(GFX_BACKGROUNDBUFFER);
37 gfx_cl earscr(RGB(0, 0, 0));
38 draw_gri d();
39 gfx_setgraphi cscontext(GFX_SCREENBUFFER);
gfx_copybuffer(GFX_BACKGROUNDBUFFER, GFX_SCREENBUFFER);
This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 4 /Shuffle Master . =

19.0 -Writingthe Program 19-3 File Listing 19-1: example5.c (continued) 41 /* make the buttons */
42 makebutton1 ("GO! ", 10, 510, 100, 50, RGB (0, 255, 0), "go_button");
43 makebutton1("STOP! ", 10, 570, 100, 30, RGB (255, 0, O), "stop_button");
44 makebutton1 ("Reset", 120, 510, 50, 90, RGB(255, 255, 0) , "reset_button");
45 setbuttonfont ("GO! ", "i mpact. ttf", 30);
46 }
47 void draw_gri d (voi d){
48 i nt x, y;
49 i nt color;
50 col or = BASE_COLOR;
51 for (y=0; y<=SCREEN HE I GHT-50; y+=50){
52 for(x=0; x<=SCR-EEN_WI DTH-50; x+=50){
53 gfx_drawbar(x, y, 50, 50, color);
54 col or = ROT_COLOR(col or);

57 }
58 /** button callbacks **/
59 void go_button(voi d) ti mer_start(100, "ani m_bal Is");
61 sound_pl ay("button. wav");
62 }
63 void stop_button (char * name) {
64 sys_debug(" stop button: %s", name);
ti mer_ki I I ("ani m_bal Is");
66 sound_pl ay("button. wav");
67 }
68 void reset_button(voi d) 69 ini t_bal Is();
refresh_screen();
71 sound_pl ay("button. wav");
72 }
73 /** telemetry display **/
74 void draw tel emetry(voi d){
char b-ufT60} ;
76 text_pri ntf, (buf, "step %d", step);
77 gfx_setfont("georgi a. ttf", 12);
78 gfx copybufferpart (500, 510, 300, 30, 500, 510-, GFX_BACKGROUNDBUFFER, GFX SCREENBUFFER);
79 gfx_drawstri ng (510, 530, buf, RG-B (255, 255, 255), -1);
ti mer_start (900, "draw_tel emetry");
81 ) This file is included in the SGOS installation CD-ROM tutorial Me.
Rev: May 2001 4 /Shuffle Master = .

19.0 ¨Writing the Program 19-4 File Listing 19-1: example5.c (continued) 82 /** ball animation **/
83 void init_balls(void) {
84 int i;
85 for(i=0;i<NUM_BALLS;i++){
86 balls[i].x = rnd_get_number(SCREEN_WIDTH - BALL_WIDTH);
87 balls[i].y = rnd_get_number(SCREEN HEIGHT - BALL_HEIGHT);
88 balls[i].x_vel = rnd_get_number(205) - 100;
89 balls[i].y_vel = rnd_get_number(200) - 100;
90 }

92 void animJalls(void) {
93 int i;
94 gfx_setgraphicscontext(GFX_BACKGROUNDBUFFER);
95 erase_balls();
96 for(i=0;i<NUM BALLS;i++){
97 calc_pos(iballs[i]);

99 draw_balls();
100 step++;
101 gfx_setgraphicscontext(GFX_SCREENBUFFER); //unneeded gfx copybufferpart(0,0,SCREEN_WIDTH,SCREEN_HEIGHT,0,0,GFX_BACKGROUNDB
UFFiR,GFX_SCREENBUFFER);
103 timer_start(100,"anim_balls");

105 void draw_balls(void) {
106 int i;
107 for(i=0;i<NUM_BALLS;i++){
108 gfX_drawsprite(balls[i].x, balls[i].y,(char**)ball);

110 ) 111 void erase_balls(void) {
112 draw_grid();
113 }
114 void refresh_screen(void) {
115 gfx_setgraphicscontext(GFX_BACKGROUNDBUFFER);
116 draw_grid();
117 draw_balls();
118 gfx_setgraphicscontext(GFX_SCREENBUFFER);

gfx copybufferpart(0,0,SCREEN_WIDTH,SCREEN_HEIGHT,0,0,GFX_BACKGROUNDB
UFFiR,GFX_SCREENBUFFER);

121 void calc_pos(ball struct * b) {
122 b->x +. b->x_vel;
123 b->y += b->y_vel;
124 b->y_vel += GRAVITY;
Rev: May 2001 /Shuffle Master 7.4 . . "PM c 19.0 ¨Writing theProgram 19-5 File Listing 19-1: example5.c (continued) 125 i f(b->x <= 0){
126 b->x = 0;
127 b->x_vel = - (b->x_vel *8/10);
128 }else i f(b->x >= SCREEN_WI DTH - BALL_WI DTH){
129 b->x = SCREEN_WI DTH - BALL_WI DTH;
130 b->x_vel = - (b->x_vel *8/10);
131 }
132 i f(b->y <= O){
133 b->y = 0;
134 b->y_vel = - (b->y_vel *8/10);
135 }else i f(b->y >= SCREEN_HEI GHT - BALL_HEI GHT){
136 b->y = SCREEN_HEI GHT - BALL_HEI GHT;
137 b->y_vel = - (b->y_vel *8/10);
138 }
139 ) This file is included in the SGOS installation CD-ROM tutorial file.
4. When player presses Reset button:
a. Re-creates all balls from scratch b. Plays a button sound The following review of the code in exampl e5. c focuses on changes from the previous exam-ple in Chapter 20:
Ln 3-10 The definitions are unchanged from the last example, except that the screen height is reduced from 600 to 500, to allow room for the black bar at the bottom.
Ln 29-34 The i ni ti al i ze() routine still creates the initial ball positions and velocities. The previous example drew directly to the screen and used gfx_copybuffer() to set the frame buffer. Now you will use the frame buffer as an intermediate step, as explained below in draw_screen O.
i ni ti al i ze() has a new step to start a timer for the telemetry string on the bottom of the display.
Ln 35-46 The draw_screen() routine uses the frame buffer this time as a true buffer, as fol-lows:
gfx_setgraphi cscontext(GFX_BACKGROUNDBUFFER) lets you draw directly into the frame buffer. Nothing will display on the screen.
gfx_cl earscreen() clears the frame buffer.
draw_gri d() is now a separate function (see below). In the last example it was part of ini ti al i ze().
After drawing the grid, gfx_setgraphi cscontext(GFX_SCREENBUFFER) sets the graphics context back to the screen.
gfx_copybuffer() copies the frame buffer onto the screen buffer.
makebutton1 ("GO! ", 10, 510, 100, 50, RGB(0, 255, 0), "go_button") creates a button named GO!. This button is located at (10, 510), and has a width of 100 and a height of 50. RGB(0, 255, 0) defines its color as green. The callback function go_button is called when the button is pressed.
Rev: May 2001 /Shuffle Master = =
/..ra l 14 c 19.0 ¨WritingtheProgram 19-6 The parameters for the Stop and Reset buttons are similar.
setbuttonfont() changes the font and point size of the GO! button only. The other two buttons will use the button font default, which is Georgia 8 point.
Ln 47-57 draw_gri d() is a separate new function to draw the grid of colored boxes. The code is unchanged from the last example when it was a part of the i ni ti al i ze() func-tion.
Ln 59-62 The go_button() function is called when the GO! button is pressed. It simply starts a timer for the ball animation and plays a button sound.
.---4, (4 \ TIP...
Your development system probably does not have sound capabilities. In the / I ocal .oti initialization file, sound must be an included option for [startup].
Refer to the file listing in Appendix D.
Ln 63-67 The stop_button() function does the following:
Prints a debug statement giving the parameter passed. If a callback function passes a parameter, the parameter is the name of the button pressed. You could have set up several buttons that call the stop_button() function, but this example has only the one button named Stop. So the parameter is always Stop.
Deletes all the timers having ani m_bal l so as a callback function. This action freezes the animation.
Plays a button sound.
Ln 68-72 The reset_button() function re-runs i ni t_bal l s() and refresh_screen(). Then it plays the button sound.
Ln 74-81 The draw_tel emetry() function does the following:
Allocates a character buffer and writes into it using text_pri ntf(), which works just like the standard library function pri ntf().
Sets the current font to 12 point georgi a. ttf, erases whatever is now in the display spot and draws the string on the screen.
Starts a timer to make a callback to itself. Notice that this is the second timer loop that is drawing to the screen. (The other one is for animation of the balls.) This does not create any problems since they draw to different areas of the screen and don't interfere with each other.
ei '' TIP...
No standard C calls are permitted in game code, to preserve the integrity of --. ii i the pre-approved library and game engine. This includes file I/0 and the pri ntf iifamily. For instance, this example uses text_pri ntf() from the SGOS library instead of spri ntf().
Ln 83-91 i ni t_ba I l s() is now a separate function to set up each ball's location and velocity.
The code is unchanged from the last example when it was a part of the initial -- i ze() function.
Ln 92-104 The function ani m_bal l s() is refined from the way it worked in the previous exam-ple. The animation logic is still the same, but now you draw to the frame buffer first and then draw to the screen. The steps in ani m_ba I l s are as follows:
Set the graphics context to GFX_BACKGROUNDBUFFER.
Rev: May 2001:41 0 iSh u ffle Master =-.......ts. ... = .. cw.miina,c.

WO. 03/023647 19.D ¨ Make, Compile, and Run the Program 19-7 Erase all present balls from the frame buffer by redrawing the entire colored grid.
Update the positions of all the balls with draw_bal I s().
Draw all the balls into the frame buffer.
Set the graphics context back to GFX_SCREENBUFFER to draw to the screen.
Copy the entire checkered area with the balls from the frame buffer to the screen.
This single screen update greatly reduces flicker.
As its last step, ani m_bal l s starts a timer with a callback to itself.
Ln 105-10 draw_bal I s() has become a separate function in the current example. It switches to gfx_drawspri te() to handle transparency.
Recall from the last example that the gfx_drawtransXPN 0 transparency mechanism erased overlapping parts of ball images as new ones were added. Since gfx_drawspri te() replaces transparent pixels with the pixels from the current buffer (in this case the frame buffer), each new ball placement will put only the ball itself into the current frame buffer. All the transparency of the ball's rectangular border will be replaced with appropriate pixels from the current frame buffer.
Ln 111-13 erase_bal I s() simply redraws the entire colored grid. This complete redraw is a somewhat primitive approach, but it works well for this example. Chapter 7-M, Double-Buffered Animation, gives an example of a more advanced graphics updat-ing approach.
Ln 114-20 The refresh_screen() function has the following steps:
Sets the graphics context to the OFX_BACKGROUNDBUFFER. This approach will copy all changes to the screen at once, giving a nicer presentation.
Erases all the balls by having draw_gri do redraw the screen.
Creates new ball positions and velocities with i ni t_bal l sO.
Draws the balls on the screen.
Sets the graphics context back to the GFX_SCREENBUFFER so all the new balls can be drawn to the screen at once. Then it copies the rectangle, defined from the upper left comer of the screen and SCREEN_IIIIDTH x SCREEN_HEI GHT in size, to the screen.
Ln 121-39 cal c_pos() is unchanged from before.
D. MAKE, COMPILE, AND RUN THE PROGRAM
Make and compile the program the same as in the last example. Change the example file name Rev: May 2001 4 /Shuffle Master . = 4.= pos 1 iv 19.E ¨ Circumstance Where Callbacks Are Not Stopped by timer kill() 19-8 to exampl e5. c. Also, include the sound file button. way.
-4e4g mkh77;
Ma = It,c;I:
mair, F-..fat ¨407 41¨
Pt:. '4R. _____ lt :::1 ,==
Ftk .fig Screen colors are changed for readability ' 1=t. - =
E7g-g 11.1--"=.7 :::k; =
WO. .rtT
1ft, Figure 19-1 - Tutorial: Screen with Buttons When you run the program you will see a checkered display with a black bar along the bottom, as shown in Figure 19-1. There are three buttons: GO!, Stop, and Reset. Click on the GO! button to start the animation. Press Reset to give the balls a random new position and velocity If you press GO! more than once, it will keep spawning animation timers, and the balls will move faster up to a point. The animation loop moves all balls each time it is called. It does not care which timer loop called it, so more timers will just speed things up.
If you then press Stop, all the animation timers will be deleted and the balls will stop.
E. CIRCUMSTANCE WHERE CALLBACKS ARE NOT STOPPED BY TIMER_KILLO
1. Why the Animation May Not Stop If a lot of timers are running when you press Stop, the animation may fail to fully stop.
When many timers are running, it is likely that one or more of them will still be waiting in the event queue. Once a timer times out, only the callback function remains;
it is no longer a "timer" and is no longer affected by the ti mer_ki 11 () function.
The more animation timers there are, the greater the chances the ti mer_ki 11 () functions will not stop a timer callback. If there are as many as 30 animation timers, this phenome-non of callbacks slipping through the queue may happen to more than one timer.
SGOS
does limit the number of timers that can be running at one time (maximum is 60).
The debug. out file lists timers by the time remaining on them, in the order of increasing time left. Timers are not associated to numbers, so you cannot track a particular timer through the debug. out file. debug. out is more useful to see how many timers are executing at one time.
Rev: May 2001 /Shuffle Master = =
MING

19.F¨Exercises 19-9 2. A Sure Way to Stop the Animation There is another way you can set up the on-off switches. Use a global variable as a bool-ean telling whether the animation is running. Check this global variable in go_button(). If the animation is not running, set the flag and start the animation. In this chapter's example, stop_button 0 just sets the flag to false, whereas an i u_ba I I () checks each time to see if it should be animating by looking at the flag. If not, the timer is not renewed.
F. EXERCISES
The following exercises shoW some further nuances of how buttons and timers work in SGOS:
1. Set the constant NUILBALLS to 30. Notice how much smoother the animation is with more balls than the previous example.
2. The example program as written allows many animation timers by repeatedly pressing GO! Try pressing GO! about 30 times. Press Stop, then quit the program and look in debug. out for >> , the characters at the front of the stop button string.
Just above the you will see a listing of most of the 30 timers. After the there should be a short listing of timers that did not stop before you quit the program. One of these timers is the telemetry timer which you did not kill. All the others are for the animation loop.
How many slipped through the ki I I _ti mer 0 call on the event queue?
Rev: May 2001 /Shuffle Master . .

A. OVERVIEW
The icon in the previous example flashed and blinked but stayed in one position. This chapter makes the ball icon move. The tutorial will include the following SGOS tools and concepts:
= Using a structure to give the ball position and velocity = Getting a random number from the SGOS library = Using the SGOS debug statement = Using the SGOS "sprite" graphics function to avoid clipping in animations B. GETTING A RANDOM NUMBER FROM THE SGOS LIBRARY
This chapter will use random numbers to move balls around the screen at varying velocity.
SGOS includes its own random number generator. Use the API function rnd_get_number (range) to return a random number between zero and range. Refer to Appendix C for more about this function.
C. DEBUG SETTINGS
The API call sys_debug(char* format, . ) prints the named formats to the file debug. out.
This chapter will use it to find the ball's current position. Refer to Chapter 14-E, Debugging Tools for more about SGOS debugging options.
D. WRITING A PROGRAM THAT MOVES AN ICON
Copy exampl e4. c, as listed in File Listing 20-1, to your app. tutori al directory. This example will move a ball around the screen and demonstrate a few important points about transparency.
It will again use the ball icon from Chapter 17, and will add code to provide and display ball position and velocity. Following is a review of the code in exampl e3. c:
Ln 1-2 Include userapi . h and bal I _gfx. h as in the previous examples.
Ln 3-10 Define several constants:
BALL_WI DTH and BALL_HE I GHT are the width and height of the ball graphic in pixels.
SCREEN_WI DTH, SCREEN_HEI GHT are set, also in pixels.
GRAVITY is the acceleration of the balls to the bottom of the screen, in no particular units.
NUM_BALLS is the number of balls handled in the program.
Lines 9 and 10 defme the BASE_COLOR and ROT_COLOR, which steps through several colors by incrementing the color character value.
Ln 11-14 Declare a ball structure. The structure contains the ball's position on the screen and its velocity.
Ln 15-20 Create global variables to keep information between timer callbacks:
Rev: May 2001 /shuffle Nlasteri = = = akAminia 20.D ¨ Writing a Program That Moves an Icon 20-2 File Listing 20-1: example4.c 1 #i ncl ude "userapi . h"
2 #i ncl ude "ba I I _gfx. h"
3 #defi ne BALL_WI DTH 50 4 #defi ne BALL_HEI GHT 50 #defi ne SCREEN_WI DTH 800 6 #defi ne SCREEN_HE I GHT 600 7 #defi ne GRAVITY 3 8 #defi ne NUM_BALLS 1 9 #defi ne BASE_COLOR Ox1dab #defi ne ROT_COLOR (a) (((a 1) + (a 14)) & Ox7fff) 11 typedef struct f 12 i nt x, y;
13 i nt x_vel , y_vel ;
14 } bal I _struct;
void ni tiaH ze(void);
16 void draw_screen(voi d);
17 void ani m_bal I s(voi d);
18 void cal c_pos(bal I _struct * b);
19 ba I I _struct ba I I s[NUM_BALLS];
i nt step;
21 void i ni ti al i ze(voi d) {
22 i nt i ;
23 draw_screen();
24 gfx_copybuffer(GFX_SCREENBUFFER, GFX_BACKGROUNDBUFFER);
step = 0;
26 for(i =0; i <NUM_BALLS; i ++){
27 bal I sfi 1. x = rnd_get_number(SCREEN_WI DTH - BALL_WI
DTH);
28 bal I s[i ]. y = rnd_get_number (SCREEN HEI GHT
BALL_HEIGHT);
29 bal I s[i ]. x_vel = rnd_get_number(20-0) - 100;
bal I s [i ]. y_vel = rnd_get_number(200) - 100;

32 ti mer_start(100, "ani m_bal I s");
33 }
34 void draw_screen(voi d) f i nt x, y;
36 i nt col or;
37 gfx_cl earscr (RGB (0, 0, 0));
38 col or = BASE_COLOR;
39 for (y=0; y<=SCREEN_HE I GHT-50; y+=50){
for (x=0; x<=SCREEN_WI DTH-50; x+=50){
41 gfx_drawbar(x, y, 50, 50, col or);
This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 /Shuffle Master . = = c,".7.1114 20.D ¨ Writing a Program That Moves an Icon 20-3 File Listing 20-1: example4.c (continued) 42 col or = ROT_COLOR(col or);

45 }
46 void ani m_bal I s(voi d) {
47 i nt i ;
48 for (i =0; i <NUM_BALLS; ++) 49 gfx_copybufferpart (bal I s[i ] x, bal I sfi ] . y, 50 BALL_WI DTH, BALL_HEIGHT, bal I sti J. x, bal I s[i 1. y, GFX_BACKGROUNDBUFFER, GFX_SCREENBUFFER);
52 cal c_pos(&bal I s[i ]);
53 sys_debug ("> step=56thtbal I Ad \tv^2=%d", step, i , 54 bal I s[i ]. x_vel *balls[i 1. x_vel 55 +bal I s[i 1.y_vel *bal I s[i].y_vel );

57 for (i =0; i <NUM_BALLS; i ++) 58 gfx_dravrtransXPM(bal I s[i ]. x, bal I s[i ].y, 59 (char**)bal I , "99");
60 step++;
61 ti mer_start (100, "ani m_bal I s");
62 }
63 void cal c_pos(bal I struct * b) 64 b->x += b->x_ve¨I ;
65 b->y += b->y_vel ;
66 b->y_vel += GRAVITY;
67 f(b->x <=
68 b->x = 0;
69 b->x_vel = - (b->x vel *8/10);
70 }else i f(b->x >. SCRE¨EN_WI DTH - BALL_WI DTH) ( 71 b->x = SCREEN_WI DTH - BALL_WI DTH;
72 b->x_vel = - (b->x_vel *8/10);

74 i f(b->y <= 0)( 75 b->y = 0;
76 b->y_vel = - (b->y_vel *8/10);
77 }else i f(b->y >= SCREEN HEIGHT - BALL_HEIGHT){
78 b->y = SCREEN _HEIGHT - BALL_HEI GHT;
79 b->y_vel = -(¨b->y_vel *8/10);
This file is included in the SGOS installation CD-ROM tutorial file.
bal I s is the array holding all of the ball structures.
step is a counter of times through the animation loop.
Ln 21-33 The function i ni ti al i ze() will be called by SGOS on startup.
Call draw_screen() to draw the checkered pattern, then use gfx_copybuffer() to copy the entire screen buffer into the frame buffer for use to refresh the display when the ball(s) moves.
Rev: May 2001 ,4,41 4 iShuffle Master = . "

20.E¨ Runningthe Program 20-4 Initialize the global variable step and each of the bal I s[i] in the balls array. This routine uses random numbers to initialize the ball array. The code uses rnd_get_number(200) - 100 to generate velocities in the range -100<=x<100.
Now that everything is set up, start a timer to begin the animation.
Ln 34-45 draw_screen() does the following:
Clears the screen buffer to black using gfx_cl ea rscr (RGB (0, 0, 0).
Draws the boxes, using a for loop to rotate through colors using the variable c.
Ln 46-62 ani m_bal I s() does the following:
For each ball in the array: Uses gfx_copybufferpart to erase it from the screen by copying the relevant part from the specified source, the frame buffer (the back-ground), to the destination buffer, the screen buffer; then calculates the ball's new position and print a debug statement.
Alfter all balls are erased and updated, gfx_drawtransX1410 enlists the for loop to draw each ball to the screen.
To keep things going, start a timer to call ani m_ba I I s() back in .1 second.
Ln 63-80 cal c_pos() contains nothing related to SGOS. It calculates a ball's new position and velocity, including factors for inelastic collisions with the sides of the screen and gravity.
E. RUNNING THE PROGRAM
Run the program the same as in the previous examples. After the startup screen you should again see the screen filled with a checkered pattern. A single ball icon will move around the screen, because you inially set NUM...BALLS to 1. Figure 20-1 shows how the screen should look.
exampl e3. c will slowly run down because the balls have "gravity." Press q to quit..
Mk1 Eqz t 4i ; FIM
nr;=;---;
p-R1.
r¨ --_. k."1µ1" - ft=
=NEILSEN-Screen colors are ochanged for readability. RI
C Kg imu L,,,,27p,x.1. '41 Z=247-Aikft fry.`
trA M =
dor-.11 = ...
Figure 20-1 - Tutorial: Timers and a Moving Icon F. USING SPRITE TO FIX ANIMATION CLIPPING
If you have not tried it already, increase NUM_BALLS and run the program again.
Rev: May 2001 4/Shuffle Master = P. M 1 CS

20.6¨Exercises 20-5 Notice that the ball icons' rectangles clip each other and hide portions of the balls that should be displayed. This happens because gfx_drawtransP110 replaces the transparent pixels in a graphic with the appropriate pixels from the frame buffer. In effect, the gfx_drawtransXPII
transparency mechanism erases overlapping parts of any ball images already drawn to the screen.
Using a spri te animation function will resolve the clipping because it handles transparency differently. The function gfx_drawspri te() will replace the transparent pixels with the appro-priate pixels from the current buffer, which in this case is the screen.
The next tutorial example will use spri te functions.
G. EXERCISES
Try the following:
1. Experiment with gfx_drawspri te() if you want to see its effect. Refer to Appendix C.
2. When you increase the number of halls you will see them flicker as they collect near the bottom of the screen. The next examples will show refined ways to update screens to minimize flicker.
Rev: May 2001 4Shuffle Master . = GAMING

CHAPTER 21 - TUTORIAL: USING NVRAM
A. OVERVIEW
This chapter shows how to use the non-volatile RAM (nvram) to preserve data among multiple program modules. The tutorial will include the following SGOS tools and concepts:
= How SGOS lets you interact with nvram = Using the nvram file in place of nvram hardware on your development computer = An improved graphics technique = More buttons to show more interactions among multiple game functions B. ADDING NVRAM TO PRESERVE DATA
To satisfy security and accounting requirements, all computer-based games of chance must be able to preserve data across executions. This chapter introduces SGOS nvram storage with an example that remembers two structures to store ball positions. Chapter 9 explains more about how SGOS uses the game. state file to handle nvram data. Appendix C describes the API
nvram routines.
Since your desktop computer will not have nvram hardware, you must use a tile called nvram in its place. The file I ocal . oti disables nvram hardware for development (it also disables the touch screen and other game hardware). Refer to Appendix D and Chapter 2-2, Installing and Configuring SGOS. While you are developing a game, SGOS will use your nvram file as a proxy for the nvram hardware.
C. USE OF MULTIPLE GAME MODULES
Spreading code among different modules can help keep it cleaner. Whenever you load a new module, SGOS first unloads everything from memory in the current module and calls mod_exi t(), then it loads the new module into memory and calls i ni ti al i ze(). nvram is the only way you can pass parameters between modules.
Yor must name your game's main module game. so for it to work correctly. Other modules can have any name. This chapter creates a separate module for the ball's "gravity"
function. The file called gravi ty. c becomes gravi ty. so when compiled.
D. GRAPHICS HANDLING ALTERNATIVES
The example in the preceding chapter used a primitive animation scheme that redrew the entire background image with all the balls each time through the loop. It then copied the entire background image to the screen each time.
You really only need to redraw enough of the background to erase each ball and copy all changes from the background to the screen. However, this example with the multiple balls will stay with the primitive approach. The rectangle tracking scheme for multiple updates would get unwieldy.
Rev: May 2001 oi 4 )Shuffle Niasterl M O.
= = &AIN

21.E ¨ Create a game.state File 21-2 Chapter 7-m, Double-Buffered Animation explains how to use a more sophisticated approach for localized screen updates.
Though still elementary, the dravv_tel emetry() function does use a more localized approach for its screen update, which would reduce flicker. It first updates the frame buffer with the original background ¨ solid black ¨ and then draws its new string in the frame buffer.
Finally, it copies the rectangle with the changed part of the frame buffer to the screen. In this case the string never moves, the background is very simple, and there are no other overlapping images.
E. CREATE A GAME.STATE FILE
SGOS uses the game. state file to store variables and structures during and between games.
You will store two structures in game. state in this example. File Listing 21-1 shows the code File Listing 21-1: game.state file for example6.c 1 struct bal I nfo{
2 char initialized;
3 i nt num_bal I s;
4 i nt step;
i nt moving;
6 i nt gravi ty_x CALLBACK(update_gravi ty);
7 i nt gravi ty_y CALLBACK(update_gravi ty);
8 } Info;
9 struct ball{
i nt x;
11 i nt y;
12 i nt x_vel ;
13 i nt y_vel ;
14 i nt handler;
} Bal I [50];
This file is included in the SGOS installation CD-ROM tutorial file.
to store struct bal I nfo and struct bal l. These two structures store all the ball data that will be needed between modules, so the game can continue as the modules are loaded and unloaded.
F. CREATE MODULE FOR EXAMPLE6.0 As a game gets more complex it is helpful to break it up into several working modules. For the current example you will create two program files that will act as two distinct modules:
= exampl e6. c will start, stop, and run most of the ball actions = gravi ty. c will provide buttons to adjust a directional "gravity"
property The following is a review of the code in exampl e6. c (refer to File Listing 21-2).
Ln 1-3 These included files should look familiar from the other examples. For exampl e6. c you are also adding a second ball, ball_red_gfx. h. ***blue?***
Ln 4-11 Most of the defined ball properties also look familiar, but there are two changes.
Now you define MAX_BALLS instead of NUM_BALLS because the new program has but-Rev: May 2001/ Shuffle Master . = . ."1\11ISIG

21.F ¨ Create Moduleforexample6.c 21-3 File Listing 21-2: example6.c (sheet 1 of 7) 1 #i ncl ude "userapi . h"
2 #i ncl ude "bal I _gfx. h"
3 #i ncl ude "bal I _red_gfx. h"
4 #defi ne BALL_WI DTH 50 #defi ne BALL_HEI GHT 50 6 #defi ne SCREEN_WI DTH 800 7 #defi ne SCREEN_HEI GHT 500 8 #defi ne MAX_BALLS 50 9 #defi ne NUM_HANDLERS 2 #defi ne BASE_COLOR0x1dab 11 #defi ne ROT_COLOR(a) (((a 1) + (a 14)) & Ox7fff) 12 /** the ball structure **/
13 typedef struct {
14 i nt x, y;
i nt x_vel , y_vel ;
16 i nt handler;
17 } bal I _struct;
18 /** prototypes **/
19 void i ni ti al i ze(voi d);
void draw_screen(voi d);
21 void draw_gri d(voi d);
22 void go_button(voi d);
23 void stop_button(char * name);
24 void reset button (voi d);
void rememier_button(voi d);
26 void recal I _button (voi d);
27 void more_button(voi d);
28 void I ess_button(voi d);
29 void gravi ty_button(voi d);
void draw_tel emetry (voi d);
31 void ni t_bal I (i nt number);
32 void ni t_bal I s(voi d);
33 void ani m_bal I s(voi d);
34 void draw_bal I s(voi d);
void refresh_screen(voi d);
36 void add_rectangl e(i nt x, i nt y, i nt w, i nt h);
37 void copy_rects(voi d);
38 voi d redraw_framebuffer(voi d);
39 void cal c_pos(bal I _struct * b);
void cal c_pos_rnd(bal I _struct * b);
This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 41 iShuffle Master . = . caNsinac.

21.F- Create Moduleforexample6.c 21-4 File Listing 21-2: example6.c (sheet 2 of 7) 41 /** gl obal s **/
42 bal I _struct ba I I s[MAX_BALLS];
43 i nt step;
44 i nt num_bal I s;
45 i nt s_movi ng;
46 i nt gravi ty_x;
47 i nt gravi ty_y;
48 /** main function **/
49 void i ni ti al i ze(voi d) 50 draw_screen ;
51 step = 0;
52 num_bal I s = 1;
53 s_movi ng = 0;
54 nv_geti nt(" I nfo. gravi ty_x", &gravi ty_x);
55 nv_geti nt(" I nfo. gravi ty_y", &gravi ty_y);
56 ni t_bal I s();
57 refresh_screen();
58 ti mer_start(100, "draw_tel emetry");

60 void draw_screen(voi d) 61 gfx_setgraphi cscontext(GFX_BACKGROUNDBUFFER);
=
62 gfx_cl earscr(RGB(0, 0, 0));
63 draw_gri d();
64 gfx_setgraphi cscontext(GFX_SCREENBUFFER);
65 gfx_copybackground();
66 /* make the buttons */
67 makebutton1 ("GO! ", 10, 510, 100, 50, RGB(0, 255, 0), "go_button");
68 setbuttonfont ("GO! ", "i mpact. ttf", 30);
69 makebutton1 ("STOP! ", 10, 570, 100, 30, RGB(255, 0, 0), "stop_button");
70 makebutton1 ("Reset", 120, 510, 50, 90, RGB(255, 255, 0), "reset_button");
71 makebutton1 ("Remember", 180, 510, 100, 40, RGB(100, 0, 255), "remember_button");
72 makebutton1 ("Reca I I ", 180, 560, 100, 40, RGB(255, 0, 255), "recal I _button");
73 makebutton1 ("More Bal I s", 290, 510, 100, 40, RGB(255, 200, 200), "more_button");
74 makebutton1 ("Less Bal I s", 290, 560, 100, 40, RGB(200, 200, 255), "1 ess_button");
75 makebutton1("Gravi ty", 400, 510, 100, 40, RGB(200, 255, 200), "gravi ty_button");
76 ) This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 al 4 ',Shuffle AAaster =
= . .. et.

21.F ¨ Create Moduleforexample6.c 21-5 File Listing 21-2: example6.c (sheet 3 of 7) 77 void draw_gri d (voi d){
78 i nt x, y;
79 i nt col or;
80 col or = BASE_COLOR;
81 for (y=0; y<=SCREEN_HEI GHT-50; y+=50){
82 for (x=0; x<=SCREEN_WI DTI-1-50; x+=50){
83 gfx_drawbar(x, y, 50, 50, col or);
84 col or = ROT_COLOR(col or);

88 /** button callbacks **/
89 void go_button(voi d){
sound_pl ay("button. wav");
91 f (I s_movi ng) 92 ti mer_start(100, "ani m_bal I s");
93 s_movi ng = 1;
94 }
void stop_button(char * name){
96 sys_debug(">> stop button: %s", name);
97 ti mer_ki I I ("ani m_bal s");
98 i s_movi ng = 0;
99 sound_pl ay ("button. wav");

101 void reset_button(voi d){
102 ini t_bal I s();
103 refresh_screen();
104 sound_pl ay("button. wav");

106 void remember_button(voi d){
107 i nt i ;
108 nv_setchar(" I nfo. initial i zed", 1);
109 nv_seti nt(" I nfo. num_ba I I s", num_bal I s);
110 nv_seti nt(" I nfo. step", step);
111 nv_seti nt (" I nfo. movi ng", s_movi ng);
112 for(i =0; i <num_bal I s; ++){
113 nv_seti nt("Bal I [%d] x", bal I s[i x, );
114 nv_seti nt("Bal I [%d]. y", bal I sfi 1. y, ) ;
115 nv_seti nt("Bal I (%d] x_vel ", bal I s[i ). x_vel , i );
116 nv_seti nt("Bal I [%d] y vel ", bal I s[i 1. y_vel , );
117 nv_seti nt ("Bal I (%d]. handl er", ba I I s[i . handl er, i );
118 ) This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001Ni o Shuffle a.ster /
= = GA. ra 1 21.F ¨ Create Module for example6.c 21-6 File Listing 21-2: example6.c (sheet 4 of 7) 119 sound_pl ay("button. way");
120 }
121 void reca I I _button(voi d){
122 char i ni t;
123 i nt i;
124 i nt was_movi ng;
125 nv_getchar("I nfo. i ni ti al i zed", &i ni t);
126 if(init){
127 was_movi ng = s_movi ng; /*remember moving state for I
ater*/
128 nv_geti nt ("I nfo. num_bal Is", &num_ba I Is);
129 nv_geti nt("I nfo. step", &step);
130 nv_geti nt ("I nfo. movi ng", &i s_movi ng);
131 for(i =0; i <num_bal I s; i ++) 132 nv_geti nt("Bal I [%d]. x", &bal I s[i ].x, );
133 nv_geti nt("Bal I [%d]. y", &bal I s [i ] .y, );
134 nv_geti nt("Bal I [%d]. x_vel ", &bal I s[i ]. x_vel , i);
135 nv_geti nt("Bal I Oka y_vel ", &bal I s[i ]. y_vel , i );
136 nv_geti nt("Bal I [%d] . handl er", &bal I s[i ]. handl er, i );

138 refresh_screen();
139 f(i s_movi ng && !was_movi ng) 140 /* this will start a timer only if one is not al ready V
141 /* going. if one Ýs al ready going and Ýt needs to be */
142 /* turned off, it will turn itself off after looking at */
143 /* s_movi ng */
144 ti mer_start(100, "ani m_bal Is");
145 }
146 sound_pl ay("button. wav");
147 }
148 void more_button(voi d){
149 i f(num_bal I s < MAX_BALLS){
150 num_bal I s++;
151 i ni t_bal I (num_bal I s);
152 i f(I i s_movi ng) 153 refresh_screen();
154 }
155 sound_pl ay("button. wav");
156 }
157 void I ess_button(voi d) 158 i f(num_bal I s>1){
159 num_bal I s--;
160 i f(! i s_movi ng) 161 refresh_screen();
162 }
This file is included in the SGOS installation CD-ROM tutorial file.
=====7",-Rev: May 2001 4:11 'A /Shuffle Master = =Igow 1 INA G

21.F¨ Create Module for example6.c 21-7 File Listing 21-2: example6.c (sheet 5 of 7) 163 sound_play("button.wav");

165 void gravity_button(void){
166 mod_load("gravity");
167 }
168 /** telemetry display **/
169 void draw_telemetry(void){
170 char buf[60];
171 text_printf(buf,"step %d, num. balls %d",step,num_balls);
172 gfx_setfont("georgia.ttf",12);
173 gfx_setgraphicscontext(GFX_BACKGROUNDBUFFER);
174 gft_drawbar(500,510,300,30, RGB(0,0,0));
175 gfx_drawstring(510,530,buf,RGB(255,255,255),-1);
176 gfx_setgraphicscontext(GFX_SCREENBUFFER);

gfx copybufferpart(500,510,300,30,500,510,GFX_BACKGROUNDBUFFER,GFX_SC
REEiBUFFER);
178 timer_start(900,"draw_telemetry");
179 ) 180 /** ball animation **/
181 void init_ball(int number){
182 balls[number].x = rnd_get_number(SCREEN_WIDTH - BALL_WIDTH);
183 balls[numberLy = rnd_get_number(SCREEN_HEIGHT - BALL_HE1GHT);
184 balls[numberlx_vel = rnd_get_number(100) - 50;
185 balls[number].y_vel = rnd_get_number(100) - 50;
186 balls[number].handler = rnd_get_number(NUM_HANDLERS);

188 void init_balls(void) {
189 int i;
190 for(i=0;i<num_balls;i++){
191 init_ball(i);

194 /** animation loop **/
195 void anim_balls(void) {
196 int i;
197 if(Iis_moving) 198 return;
199 for(i=0;knum balls;i++){
200 swi tch (ball s[ i . handl er){
201 case 1:
202 calc_pos_rnd(&balls[i]);
Rev: May 2001iShuffle Master . . .manmirac 21.F ¨ Create Module for example6.c 21-8 File Listing 21-2: example6.c (sheet 6 of 7) 203 break;
204 default:
205 calc_pos(&balls[i]);

207 }
208 step++;
209 refresh_screen();
210 timer_start(100,nanim_balls");
211 ) 212 /** screen handling functions **/
213 void draw_balls(void) {
214 int i;
215 char ** icon;
216 for(i=0;i<num_balls;i++){
217 if(balls[ilhandler == 1) 218 icon = (char**)ball_red;
219 else 220 icon = (char**)ball; ***NOTE-FIXING -- balls get stuck 221 gft_drawsprite(balls[i].x, balls[i].y, icon);
222 ) 223 ) 224 void refresh_screen(void) {
225 gfx_setgraphicscontext(GFX_BACKGROUNDBUFFER);
226 draw_grid();
227 draw_balls();
228 gfx_setgraphicscontext(GFX_SCREENBUFFER);

gfx copybufferpart(0,0,SCREEN_WIDTH,SCREEN_HEIGHT,0,0,GFX_BACKGROUNDB
UFFiR,GFX_SCREENBUFFER);
230 ) 231 /** ball movement routines **/
232 void calc_pos(ball struct * b) {
233 b->x += b->x_vei;
234 b->y += b->y_vel;
235 b->x_vel += gravity_x;
236 b->y_vel += gravity_y;
237 if(b->x < 5){
238 b->x = 5;
239 b->x_vel = -(b->x vel*8/10);
240 }else if(b->x > SCREEN_WIDTH - BALL_WIDTH - 5 ){
241 b->x = SCREEN_WIDTH - BALL_WIDTH - 5;
242 b->x_vel -(b->x_vel*8/10);
243 }
244 if(b->y < 5)( 245 b->y = 5;
246 b->y_vel = -(b->y_vel*8/10);
Rev: May 2001 /Shuffle Master =

21.F ¨ Create Moduleforexample6.c 219 File Listing 21-2: example6.c (sheet 7 of 7) 247 )else i f(b->y > SCREEN_HEI GHT - BALL_HEI GHT - 5){
248 b->y = SCREEN_HEI GHT - BALL_HEI GHT - 5;
249 b->y_vel = -(b->y_vel *8/10);
250 }
251 ) 252 void cal c_pos_rnd(bal 1 _struct * b) 253 b->x += b->x_vel ;
254 b->y += b->y_vel ;
255 b->x_vel += rnd_get_number(3) - 1;
256 b->y_vel += rnd_get_number(3) - 1;
257 i f(b->x < 5){
258 b->x = 5;
259 b->x_vel = -(b->x_vel *8/10);
260 }else i f(b->x > SCREEN_WI DTH - BALL_WI DTH - 5 )1 261 b->x = SCREEN_WI DTH - BALL_WI DTH - 5;
262 b->x_vel = - (b->x_vel *8/10);
263 }
264 i f(b->y < 5) {
265 b->y = 5;
266 b->y_vel = -(b->y_vel *8/10);
267 }else i f(b->y > SCREEN_HEI GHT - BALL_HEI GHT - 5) 268 b->y = SCREEN_HEI GHT - BALL_HEI GHT - 5;
269 b->y_vel = -(b->y_vel *8/10);
270 }
271 }
This Me is included in the SGOS installation CD-ROM tutorial file.
tons to increase and decrease the number of balls.
You also have a new property called NUM_HANDLERS with a default value of 2.
"Han-dlers" refers to the functions that update a ball's position on the screen.
This integer value is used in line 186 in rnd_get_number(NUILHANDLERS). The program ran-domly chooses one of the handlers and applies it in several routines using bal I s[number]. handl er.
Ln 19-40 The list of prototypes has grown to cover new buttons and routines.
Ln 42-47 The global variables include the array bal I _struct bal I
s[MAX_BALLS] to hold all of the ball information, plus step to count the animation steps, num_bal I s to track the total number of balls on the screen, and the flag i s_movi ng to tell whether ani-mation is active.
Ln 49-59 The i ni ti al i ze() function is mostly familiar. There are now more global variables to initialize. The call to i ni t_ba1 I s() initializes the ball array. Then the call to refresh_screen() draws the balls to the screen, and the last line starts a timer for the telemetry display.
Ln 60-76 draw_screen() sets the graphics context to the frame buffer, draws the main screen, and copies the frame buffer to the main screen. You then make all seven buttons.
Ln 77-100 The draw_gri d(), go_button(), and stop_button() functions are straightforward.
Rev: May 2001 4' /Shuffle Master. .
= .

21.F ¨ Create Moduleforexample6.c 21-10 Note that go_button checks the animation flag and stop_button resets it to O.
Lni 101-05 reset_button() is simpler since all the drawing of the balls now resides in the sub-routine refresh_screen(). Now it simply resets all the balls, then redraws the screen.
Ln 106-20 remember_button 0 is a new routine:
The nv_setchar 0 and nv_seti nt() API functions save all the relevant ball infor-mation to nvram. Note that if you use a wrong character type, file debug. warn will print a warning.
Using nv_seti nt ("Info. num_balls", num_balls) as an example, the first argument is the name of the variable you are writing to, as a string. The second argument is the value you are saving.
Additional values are substituted into the initial string according to pri ntf() style formatting. Any pri ntf() formatting characters are allowed, since SGOS makes the substitution using a call to vspri ntf(). This parameter substitution does not care about syntactic meanings; the string is only interpreted after the substitution.
Strings such as Bal 1 [%cl] .%s[%d] or even %s[%d] are allowed, as long as they expand into a meaningful string.
Ln 121-47 recal I _button() now fetches what remember_button0 stored in nvram.
First you confirm that the nvram contains a valid saved position with Info. lni ti al i zed. If there is a valid state, you use the nv_geti nt() API function to retrieve the number of balls, the step, and whether the balls were moving.
You then load in all the ball data. If the balls were moving you start a timer to ani-mate the balls, if an animate timer is not already running.
Ln 148-56 more_button0 adds another ball by incrementing num_bal Is, if the total is still within MAX_BALLS. The new ball is initialized the same as the other balls. If the balls are not currently animated, you redraw the screen. Otherwise the screen will be redrawn in the next animation loop.
Ln 157-62 1 ess_button () removes a ball by decreasing num_bal Is, to a value as low as 1.
Again, if the balls are not moving you redraw the screen.
Ln 165-67 gravi ty_button() loads the library gravi ty. After compiling, the full name of the file loaded is gravi ty. so. You pass the name with the extension . so. As noted at the beginning of this chapter, SGOS changes modules by unloading everything in the current module, calling mod_exi tO, loading the new module into memory, and calling ini ti al ize().
Ln 169-79 draw_tel emetry() makes a local screen update as discussed in Graphics Handling Alternatives at the beginning of this chapter. The routine formats the telemetry string and loads the font you specify, switches to the frame buffer, redraws the background (solid black in this case) with a call to gfx_drawbar O. draws the telemetry string with gfx_drawstri ng 0, and then copies the boxed area to the screen.
Ln 181-87 i ni t_bal 1 0 initializes a new ball record. This new function is called by more_button, to initialize each added ball. It also randomly assigns a handler to each ball with ball s [number] . handl er = rnd_get_number (NUILHANDLERS).
Ln 188-93 i ni t_balls() re-initializes all the active balls.
L 195-211 ani m_bal Is() updates all the ball positions if the flag i s_movi ng confirms the pro-Rev: May 2001 /Shuffle Master . = = A AR 1 INI

21.G ¨ Create Separate Module for gravity.c 21-11 gram is currently animating. Note that each ball is "handled" according to its assigned handler, so balls can have different behaviors.
ani m_bal I s() then redraws the entire screen (in the frame buffer) with a call to refresh_screen(). As noted earlier, you simply redraw the entire screen because it has a simple background that redraws quickly.
The last step starts a timer with a callback to ani m_bal I s to keep the animation going.
Ln 213-23 draw_bal I s() is familiar except that it now determines which graphic to draw based on the handler for each ball.
Ln 224-30 refresh_screen() updates the ball area of the screen by setting the current buffer to the frame buffer, redrawing the colored grid, redrawing the balls and then copy-ing the frame buffer directly to the screen.
Ln 232-51 cal c_pos() is familiar except that you now tie gravity to a vector.
Ln 252-71 cal c_pos_rnd() acts as the new ball "handler." It works like cal c_pos() except that the acceleration on the ball is random.
G. CREATE SEPARATE MODULE FOR GRAVITY.0 File Listing 21-3 shows the code for gravi ty. c, which will be a separate module when the pro-gram is compiled. Everything in gravi ty. c should look familiar to or consistent with the rest of the tutorial. The four gravity buttons drive this module and the back button exits back to the main module. A few additional notes:
Note that the screen is updated after a button press. Rather than the button redrawing the screen after it changed a value, this tutorial uses an nvram callback to do the update. Looking back in the game. state file (File Listing 21-1) you will see that both gravi ty_x and gravi ty_y include a callback to update_gravi ty().
When the main module changes the value of gravi ty_x or gravi ty_y in nvram, it still requests the function update_gravi ty, but will not find it since update_gravi ty is in a different module.
The call is harmlessly ignored and the program proceeds without it.
H. MAKE AND COMPILE
By now the Makefile should look quite familiar. (See File Listing 21-4). Note that you include the new gravi ty. c file with the instruction in line 12:
all: game. so gravi ty. so j. RUN THE PROGRAM
Make and run the program.
After the splash screen, you will see a display similar to the previous example, as shown in Figure 21-1. There are four new buttons, Remember, Recal l, More Bal I s, Less Bal I s, and Gray-ty. They respond as follows:
= Pressing More Bal I s adds more balls to the animation loop.
Rev: May 2001 /Shuffle Master . = .

21.1- Run the Program 21-12 File Listing 21-3: gravity.c (sheet 1 of 3) 1 #i ncl ude "userapi . h"
2 #defi ne SCREEN_WI DTH800 3 #defi ne SCREEN_HEIGHT500 4 #defi ne GRAVI TY_X350 #defi ne GRAVITY_Y250 6 #defi ne GRAVI TY_HW100 7 #defi ne IAAX_GRAVI TY5 8 #defi ne SCALE_FACTORUGRAVI TY_HW-1)/(21AAX_GRAVI TY)) 9 #defi ne CENTER_X(GRAVI TY_X + GRAVI TY HW/2) #defi ne CENTER_Y(GRAVI TY_Y + GRAVI TY:HIV/2) 11 void niti al ze(voi d);
12 void draw_screen(voi d);
13 void up_button(voi d);
14 void down_button(voi d);
void I eft_button(voi d);
16 void ri ght_button(voi d);
17 void update_gravi ty (voi d);
18 void draw_gravi ty (voi d);
19 void draw_vector(voi d);
double my_sqrt(doubl e a);
21 void niti al i ze(voi d){
22 draw_screen();

24 void draw_screen(voi d) gfx_cl earscr (0);
26 gfx_setfont("georgi a. ttf", 48);
27 gfxj usti fystri ng (0, 0, SCREEN_WI DTH, 100, "Change Gravi ty", 28 RGB(200, 100, 100), JUSTI FY_CENTER, -1);
29 draw gravi ty();
draw vector ();
31 makebutton1 ("A", CENTER_X-20, GRAVI TY_Y-50, 40, 40, 32 RGB (100, 200, 100), "up_button");
33 makebutton1("v", CENTER_X-20, GRAVI TY_Y+GRAVI TY_HW+10, 40, 40, 34 RGB (100, 200, 100), "down button");
makebutton1("<", GRAVITY_X-50, CENTER_Y-20, 40, 40, 36 RGB (100, 200, 100), "left button");
37 makebutton1(">", GRAVI TY_X+GRAV-I TY_HW+10, CENTER_Y-20, 40, 40, 38 RGB (100, 200, 100), "ri ght_button");
39 makebutton1 ("BACK", 350, 500, 100, 50, RGB (200, 200, 200), "back_button");
}
41 void up_button(voi d){
42 i nt y;
43 nv_geti nt(" I nfo. gravi ty_y", &y);
44 y--;
This Re is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 /Shuffle Master rfd . = . P. nv 21.1¨ Run the Program 21-13 File Listing 21-3: gravity.c (sheet 2 of 3) 45 i f(y<-MAX_GRAVI TY) 46 y = -IAAX_GRAVI TY;
47 nv_seti nt(" I nfo. gravi ty_y", y);
48 /* update_gravi ty(); */
49 }
50 void down_button(voi d) {
51 = i nt y;
52 nv_geti nt(" I nfo. gravi ty_y", &y);
53 y++;
54 i f(y>MAX_GRAVI TY) 55 y = WtX_GRAVI TY;
56 nv_seti nt(" I nfo. gravi ty_y'', y);
57 /* update_gravi ty(); */
58 ) 59 void I eft_button (voi d) 60 i nt x;
61 nv_geti nt(" I nfo. gravi ty_x", &x);
62 x--;
63 f(x<-MAX_GRAVI TY) 64 x = -MAX_GRAVI TY;
65 nv_seti nt(" I nfo. gravi ty_x", x);
66 /* update_gravi ty(); */
67 ) 68 void ri ght_button(voi d) {
69 i nt x;
70 nv_geti nt(" I nfo. gravi ty_x", &x);
71 x++;
72 i f(x>MAX GRAVI TY) 73 x = MA¨ X_GRAVI TY;
74 nv_seti nt(" I nfo. gravi ty_x", x);
75 /* update_gravi ty(); */
76 ) 77 void back_button(voi d){
78 mod_exi t();
79 }
80 /* graphic routines */
81 void update_gravi ty (voi d) {
82 draw_gravi ty();
83 draw_vector();
= 84 }
85 void draw_vector(voi d){
86 i nt g_x, g_y;
87 char buf[60);
This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 4 /Shuffle Master . . A m,..

21.1¨Run the Program 21:14 File Listing 21-3: gravity.c (sheet 3 of 3) 88 nv_getint("Info.gravity_x",&g_x);
89 nv_getint("Info.gravity_y",4_Y);
90 text_printf(buf,"vec = (%d,%d), Ivecl = %g",g_x,g_y, 91 my_sqrt(g_x*g_x+g_y*g_y));
92 gft_setfont("georgia.ttf",12);
93 gfx_drawbar(0,100,SCREEN_WIDTH,20,RGB(0,0,0));
94 gftjustifystring(0,100,SCREEN_WIDTH,20,buf,RGB(255,0,0), 95 JUSTIFY_CENTER,-1);
96 ) 97 factors ***** what is this? ******
98 void draw_gravity(void){
99 int center_x,center_y;
100 int g_x,g_y;
101 center_x = CENTER_X;
102 center_y = CENTER_Y;
103 nv_getint("Info.gravity_x",&g_x);
104 nv_getint("Info.gravity_y",&g y);
105 g_x = center_x + SCALE_FACTOR*g_x;
106 g_y = center_y + SCALE_FACTOR*g_y;
107 gfx_draw3dbar(GRAVITY_X,GRAVITY_Y,GRAVITY_HW,GRAVITY_HW, 108 0,RGB(200,200,255),R0(200,200,255),2);
109 gfx_drawbar(center_x-5,center y-5,10,10,RGB(255,0,0));
110 gft_drawline(center_x,center_y,g_x,g_y,RGB(255,0,0));

112 /* utility function */
113 double my_sqrt(double a){
114 /* uses newtons method to find the root of the equation xA2 -a.
The roots of this equation are +sqrt(a) and -sqrt(a).
f(s[n]) s[n+1] = s[n] f'(s[n]) 115 */
116 double s;
117 int n;
118 if(a<=0) 119 /* square root of a negative number? */
120 /* also, the square root of zero is zero... */
121 return 0;
122 s = 1;
123 for(n=0;n<10;n++){/* 10 loops should be enough */
124 s = s - (s*s-a)/(2*s);
125 ) 126 if(s<O) 127 S = -S;
128 return s;

This file is included in the SGOS installation CD-ROM tutorial file.
Rev: May 2001 =4 4 /Shuffle Master = .

21.l -RuntheProgram 21-15 File Listing 21-4: Makefile file for example6.c 1 # Makefi le for the examples 2 . SUFF I XES: . cpp .c .so 3 DEBUG¨g 4 SGOS-4(shel I . /I ocate sgos}
I NCLUDE=- I .. - I $ (SGOS) 6 . c. o:
7 gcc $(INCLUDE) -c -Wall -fPIC -o $@ $<
8 . cpp. o:
9 g++ $(INCLUDE) $ (DEBUG) -c -o $@ $
. o. so:
11 gcc -shared -o $@ $
12 all: game. so gravi ty. so 13 game. so: example6. o bal I _gfx. o 14 gcc -shared -o game. so exampl e6. o bal I _gfx. o This file is included in the SGOS installation CD-ROM tutorial file.
= Pressing Less Bal l s removes balls.
= Pressing Remember will store the location, velocity and "personality" of each ball at that moment.
= Pressing Recal I will restore all the balls to their positions and velocities at the time Remember was last pressed. This uses nvram to store the data.
Try pressing Remember, then quit, restart, and then press Reca I l. Everything should look as it did before you quit. Gravity will load the other module (See Figure 21-2), allowing you to change the gravity vector.
----,,--1.---0.-:,:
..c-F.74 r a ?I Eli =,õ,.,..,õ_.
V1: M7,7-7 = -, .:,,,i4T. r re.,, rà , = Mi.: , ,-, L',,,=,-'::, , a Fr" ., _ = - 1-41-= - - ' rf-7141 -ta- - ';'`''Ale ._, il-- = 11-,,,...,:...,,:p rel õ14.-rr---7 -Writ t',7 ZA_ 3 mad __ mo i.-.' - =::Te.Lel _ *.. F4:1 Screen colors are changed farreadability. 7.-1,751 ...":-1;= %V E..-771-M. .,,,. , , ... .. ...=
, cof L
Figure 21-1 ¨ Tutorial: nvram and More Buttons .:.17--..
Rev: May 2001 010 /Shuffle Master . = . ...AMIN,.

21.J¨Exercises 21-16 Chanue Gravity vec.==(4,1),Ivet;1=4.12311 =
Screen colors are changed for readability.
Figure 21-2 - Tutorial: Screen for Second Module J. EXERCISES
Try the following exercises:
1. Check out the additional tutorial file named exampl e6b. c that implements double buff-ering. The animation loop in this example is extremely flexible. You can probably already see ways to change it. To see how this example would run without double buff-ering, comment out the 1st, 4th, and 5th lines of refresh_screen() so that you draw directly to the screen all the time. Notice the flashing.
2. Also try these adjustments:
= Make the saved ball position appear when the game is started.
= Make nvram continually store the ball positions.
= Create other ball "handlers."
3. Make another module to modify some other parameter, e.g. background pattern or the randomness of the cal l _pos_rnd 0. You will need to add some nvram variables to do this. After you change the game. state file, delete the nvram file to force SGOS to rein-itialize the nvram. You then need to trap on this and initialize the nvram yourself.
Rev: May 2001 iShuffle Master . =

V. GAME ENGINE TUTORIAL
Chapter 22 ¨ Build a Simple Game22-1 Chapter 23 ¨ Build a 9-Line Game =
Rev: May 2001 fg) M, ?.?;,?!1 CHAPTER 22 ¨ BUILD A SIMPLE GAME
[Put example using generic template here ..
Rev: May 2001 "4 iShuffle Mazteìl = ciAmeniti:

WO 03/023647 , A. USE THE 9-LINE GAME TEMPLATE
When available Rev: May 2001 /Shuffle Master"
= . = OAMINCIL

VL HARDWARE SOLUTIONS
Chapter 24 - Hardware Solutions24-1 Chapter 25- Online Gaming Architecture (olga) Rev: May 2001 .4'0/Shuff1e Master' = <SAMINtI

A. GAME MAIN MODULE
The tutorials in IV API TUTORIAL include several examples of using the userapi calls.
In some cases the Linux and SGOS software may be preinstalled on hardware provided by Shuffle Master. You may be using PC/104 or other hardware specified by Shuffle Master for a single install to a target machine.
A hardware solution currently available from Shuffle Master is as follows:
[add details .. ]
1. URGENT Platform 2. CHIMP ¨ main module 3. HABIT ¨interface between hardware (lamps, switches, etc.) and computer;
includes four serial ports 4.PC/104 Electronics Stack, includes:
2 a. HIC PC/104 Module ¨ (if faulty, lights and buttons will not work, or game may not come up) b. Static RAM PC/104 Module ¨ (if faulty, get static RAM error on screen) c. Operating System PC/104 Module, includes:
M1 ¨ M4 are operating system ¨ (if faulty get no operation) M6 is the game personality module ¨ if bad get no game or security violation Newer systems will have a different PC/104 stack, with just two consolidated components.
The new HIC module will add SRAM functionality, eliminating the second module.
Shuffle Master will provide configuration and installation instructions.
Contact Shuffle Master for currently available and recommended main module hardware.
B. OTHER SUPPORTED HARDWARE
SGOS includes drivers for the following commonly used hardware. Refer to vendor documen-tation for configuration and installation.
1. Touch Screen Driver Microtouch 2. Bill Validator Driver JCM serial and pulse types (or other manufacturers with same protocols) 3. Coin Head Driver Asai Seiko CC46 Rev: May 20010/Shuffle Masterl .
0.AMINCI

24.C-MechanicalReels 24-2 4. Coin Hopper Driver Asai Seiko Hopper Driver 5. Serial Protocols a. IGT SAS 402 a. Bally SDS
6. Additional Drivers Contact Shuffle Master for drivers for other hardware solutions.
C. MECHANICAL REELS
retrofits or new Rev: May 2001 WA
/Shuffle Master :At =
= =
=A rd.. Pc, (OLGA) A. NETWORKING PROTOCOLS
Refer to Appendix Rev: May 2001 /Shuffle Master"
= 4. = =
di AWING\

APPENDIXES
Appendix A - Linux Setup Considerations Appendix B - make and the Makefile Appendix C - Embedded userapi Calls Appendix D - .oti Configuration File Appendix E - lyourgamelstate File Appendix F- Generic Game Template File Appendix G - Graphics Conversion Tool Listing Appendix H - Makestrips Utility (9 Line Games) Appendix l - Nine Line Game Template Appendix J - Poker Game Template Appendix K- Other Templates Appendix L - Online Protocol Exception Codes Appendix M - Screens for Setup and Recordkeeping Appendix N - Advantec Hardware Solution Information Appendix 0 - Further Help and Troubleshooting Rev: May 2001 .4.0 /Shuffle Masted . = = ciAvropact APPENDIX A - LINUX SETUP CONSIDERATIONS
1. GENERAL NOTES
Although C programming can be done in Windows and then copied to Linux, it will be sim-plest to work directly with SGOS in Linux. You can install Linux most easily on a desktop PC, but a laptop is also an option. Laptops often use specialized hardware, so finding proper Linux drivers can be more difficult.
The steps to set up SGOS on the development computer depend on your exact situation:
2. IF LINUX IS ALREADY LOADED
If you already have Red Hat Linux 6.x loaded on your computer, you can go ahead and install SGOS from the provided CD-ROM.
3. INSTALLING LINUX ON A DEDICATED COMPUTER
Linux can function well on an older Pentium computer with 32MB of RAM (64 is better). A
dedicated computer will simplify the installation.
4. SHARING WITH A WINDOWS COMPUTER
To install Red Hat Linux alongside Windows on an existing computer requires a dedicated hard drive or a dedicated drive partition.
Once again Linux requirements are economical. To keep things simple, install a separate drive if possible. An outgrown 2 or 3 GB drive from a Windows computer will be quite sufficient for game development with SGOS.
5. USING THE SHUFFLE MASTER DEVELOPMENT SYSTEM
Shuffle Master offers a turnkey hardware and software unit for development with SGOS.
These units ship with the appropriate software loaded.
6. ADDITIONAL HELP
If you are a novice with Linux ¨ and especially if you will have a dual boot system with both Windows and Linux ¨ pick up one of the many Red Hat Linux books available. For example, Red Hat Linux for Dummies gives a good explanation of dual-boot systems and how to resolve common problems. You will also find abundant help on the interne. Three helpful sites are linuxcare.com, support.com, and questionsexchange.com.
Rev: May 2001/Shuffle Master!
= = CIA.M104.2 APPENDIX B - MAKE AND THE MAKEFILE
1. OVERVIEW
make is a Linux tool to organize, update, compile and link the files that make up your program.
When you run make it looks first for a file called makefi le to tell it about the dependencies in your program files. If it does not find makefi 1 e, it next looks for a Makefi 1 e. SGOS is set up to use the one with an upper case "M", so it stands out in the listings. The Makefi 1 e is basically a set of rules to tell make precisely how it should construct non-source files from other files so it can build and install the entire program.
Each time you run make (by typing make at the command line), it will check which source files have changed and update every affected file in your project. Once it is set up correctly, the Makefi 1 e fully maintains your files. Any time you change source code, invoking make will immediately rebuild your project.
SGOS includes a Makefi le for each game template and for each tutorial. The tutorial Make-files are more simple than the example which follows, but every Makefile includes the same basic steps. If you are new to Linux (Makefi 1 e is originally a Unix tool, adapted to Linux), it is worth spending some time getting to know the Makefile structure and rules.
This manual can get you started with the make tool as it is used to build games with SGOS
templates. The make tool and the Makefi I e offer many very complex and powerful options. Picking up a good Linux manual is highly recommended.
2. A MAKEFILE EXAMPLE
A breakdown of the Makefile for the Press Your Luck 9-line game (File Listing C-1) is as fol-lows:
Line 2: . SUFFI
XES: . cpp . c . so tells make the list of known suffixes for files in the direc-tory that it needs to use in this makefile.
Line 3: DEBUG.-g is used as a compiler flag. It tells the compiler to generate debugging symbols. See Chapter XXX for more on debugging your game in the SGOS.
Ln 4-8: The following lines define some variables SHARED, ENGI NE, SGOS, LI BS and I NCLUDE, find the path to userapi . h and all of its associated SGOS
libraries and include the path as a string command line option to the compiler.
SHARED=${shel I . /I ocate shared}
ENG I NE=$fshel I . /I ocate engine}
SGOS=S{shel I . /I ocate sgos}
LI BS=-L$(SHARED) NCLUDE, I . . -1 $(SGOS) - I $ (SHARED) -1 $ (ENG I NE) Line 9:
SRCS=$(shel I I s *. c) finds all the . c files n the directory and assigns them to the variable SRCS.
Line 10:
TARGETS=$(SRCS: . c=. so) changes the suffix of all the . c files in SRCS to .
so. and assigns them to the variable TARGETS.
Rev: May 2001 9 /Shuffle Maste = a P. Pa I

B.2¨AMakefile Example B-2 File Listing B-1: sample Makefile listing 1 # PAakefi I e for ni nel ne 2 . SUFF I XES: . cpp .c .so 3 DEBUG.-g 4 SHARED=S{shel I . /locate shared}
ENGI NE=${shel I . /I ocate engine}
6 SGOS=S{shel 1 . /I ocate sgos}
7 LI BS=-L$(SHARED) 8 1NCLUDE=-1 .. -1$ (SGOS) -1$ (SHARED) -1 $ (ENGI NE) 9 SRCS4(shel I I s *c) TARGETS4(SRCS: . c=. so) 11 GAMEOBJECTS=ni nel i ne. o pyl _gfx. o 12 . c. o:
13 gcc $(INCLUDE) -c -Wall -fPI C -o $<
14 . cpp. o:
g++ $(1NCLUDE) $(DEBUG) -c -o $@ $<
16 . o. so:
17 gcc -shared -o $<
18 all: game. so $(TARGETS) cleanup 19 game. so: $(GAMEOBJECTS) gcc -shared -o game. so $ (GAIAEOBJECTS) $ (LI BS) -I engi ne -I ni nel ne 21 I ast_games. so: last_games. o I astgame_gfx. o 22 gcc -shared -o last_games. so last_games. o I astgame_gfx. o $
(LI BS) -I I ast-games -II astni ne 23 bonus. so: bonus. o bonus_gfx. o 24 gcc -shared -o bonus. so bonus. o bonus_gfx. o paytabl e. so: paytabl e. o pay_gfx. o 26 gcc -shared -o paytabl e. so paytab I e. o pay_gfx. o 27 cleanup:
28 rm -f ni nel ne. so debug*
29 clean:
rm -f *. o *. so nvram debug. * core 31 sos:
32 @echo "Enter ROOT password to bui Id app i mage... "
33 @su -c . /makesos 34 # Game Dependencies bonus. o: bonus. c bonus_gfx. h 36 game_books. o: game_books. c 37 hel p. o: hel p. c 38 last_games. o: I ast_games. c I astgame_gfx. h ni nel i ne. h 39 ni nel i ne. o: ni nel ne. c pyl _gfx. h ni nel i ne. h paytabl e. o: paytabl e. c pay_gfx. h ni nel i ne. h This sample listing is from the Press Your Luck nine-line game.
Rev: May 2001 all /Shuffle Master = = GAMING

B.2 -A Makefile Example B-3 Line 11: GAMEOBJECTS=ni nel ne. o pyl _gfx. o associates the files ni nel ne. o and pyl _gfx. o to the variable GAMEOBJECTS.
Line 12: . c. o: is a generic rule for creating .o files from .c files.
Line 13: gcc $(INCLUDE) -c -Wall -fPl C -o $e) $< defines the generic rule, as follows:
This line must begin with a tab to be recognized by make as a command by the gcc C compiler.
$ (INCL(JDE) provides the path to userapi.h found above.
-c compiles each source file to an object file, but does not link.
-Wal 1 warns about all questionable constructs.
-fPI C turns on position independent code. This option is necessary.
-o $Ã) places the output in the file $@ (shorthand for the name of the target, expands to fi 1 e. o).
$< is shorthand for the name of the input file (expands to fi 1 e. c).
Ln 14-17: . cpp. o:
g++$(INCLUDE) $(DEBUG) -c -o $e) $<
. o. so:
gcc -shared -o $@ $<
. cpp. o and . o. so give general rules for turning C++ files into object files, and for turning object files in shared object files.
Line 18: al l: game. so $(TARGETS) cl eanup states that to make everything, make must cre-ate game. so from all the . so's in TARGETS and execute the cl eanup.
Line 19: game. so: $ (GAMEOBJECTS) states that game. so is dependent on GAMEOBJECTS, which expands into a list of files.
Line 20: gcc -shared -o game. so $(GAMEOBJECTS) $(L1 BS) -1 engi ne -1 ni nel ne makes a shared object out of GAMEOBJECTS, LI BS, links in the engi ne and ni nel i ne libraries, and names it game. so.
Ln 21-22: The next two lines state that 1 ast_games. so is dependent on I
ast_games. o and I astgame_gfx. o. It makes the shared object 1 ast_games. so.
1 ast_games. so: I ast_games. o 1 astgame_gfx. o gcc -shared -o I ast_games. so I ast_games. o I astgame_gfx. o $(L1 BS) -1 I
ast-games -1 I astni ne Ln 23-24: The following lines state that bonus. so is dependent on bonus. o and bonus_gfx. o.
They make the shared object bonus. so.
bonus. so: bonus. o bonus_gfx. o gcc -shared -o bonus. so bonus. o bonus_gfx. o The following lines state that paytabl e. so is dependent on paytabl e. o and pay_gfx. o. It makes the shared object paytabl e. so.
Ln 25-26: paytabl e. so: paytabl e. o pay_gfx. o gcc -shared -o paytabl e. so paytabl e. o pay_gfx. o The next two lines remove the ni nel i ne. so file and all debug files. The rm remove command has the -f forced option, so there will be no asking for confirmation.
Rev: May 2001 /Shuffle Master = . GA1PAING

B.3¨RunningMake B-4 Ln 27-28: cleanup:
rm -f ni nel i ne. so debug*
Ln 29-30: The following lines act the same as those above but they remove all objects, shared objects, nvram, debug files and any core dump files that may exist.
clean:
ra -f *.o *. so nvram debug.* core Ln 31-33: The following lines will start the script that makes the shared objects for the disk on chip. You must be super user, and will be prompted for the password.
sos:
@echo "Enter ROOT password to bui l d app "
@su -c /makesos Ln 35-40: The following lines show the associated dependencies for the object files on the . c source and . h header files.
bonus. o: bonus. c bonus_gfx. h game_books. o: game_books. c hel p. o: hel p. c I ast_games. o: I ast_games. c I astgame_gfx. h ni nel i ne. h ni nel i ne. o: ni nel i ne. c pyl _gfx. h ni nel i ne. h paytab I e. o: paytab I e. c pay_gfx. h ni nel i ne. h 3. RUNNING MAKE
To create the game. so file, type make To use this makefile to delete the executable and object files from the directory, type make clean To rebuild the entire program (recompile and link all objects, not just the time stamped ones) type make all To create so's for use in making the Disk On Chips, (as root) type make sos Rev: May 2001 'A
/Shuffle Master = = GAMING

APPENDIX C - EMBEDDED USERAPI CALLS
1. GENERAL NOTES ABOUT USERAPI CALLS
userapi . h declares functions for graphics, sound, timers, and several other game operations.
They are a versatile set of functions for graphics, widgets, module handling, timers, nvram access, sound, hardware interface, text formatting, system calls, multigarne manamgment and miscellaneous routines.
The tutorials in /V API TUTORIAL include several examples of using the userapi calls.
2. GRAPHICS ROUTINES
The graphic routines have a few conventions for describing rectangles and colors. Rectan-gles are defined by the 4-tuple (x, y, w, h), where (x, y) is the location of the upper left cor-ner and (w, h) is the width and height of the rectangle. Colors are specified using integers, which represent an RGB triple. The macro RGB(r, g, b) in userapi h converts RGB values to their corresponding integer. R,G,B are in the range 0 and 255.
The API graphics functions can interact with one of the three SGOS
buffers.This context gets set by gfx_setcontext. Discussion in Chapter 7 reviews the relevant contexts for each function. They are:
= GFX_SCREENBUFFER
= GFX_BACKGROUNDBUFFER
= GFX_WORKBUFFER.
The transform flags are:
= GFX_FL I P_HORI Z
= GFX_FL I P_VERT
= GFX_ROTATE_90 = GFX_ROTATE_180 = GFX_ROTATE_270 The transforms are applied in the following (arbitrary) order:
image c> flip horizontat>flip vertical r> rotates i2> result The text justification flags are:
= GFX_JUSTI FY_HORI Z_CENTER
= GFX_JUSTI FY_HORI Z_LEFT
= GFX_JUSTI FY_HORI Z_RI GHT
= GFX_JUSTI FY_VERT_CENTER
= GFX_JUSTI FY_VERT_TOP
= GFX_JUSTI FY_VERT_BOTION
= GFX_JUST I FY_CENTER
Rev: May 2001 (.1 /Shuffle 'Maste == r' = = = N
CI AMIO

C.2¨GraphicsRoutines C-2 gfx_cl earbuffer(i nt col or) Clears the entire buffer with color.
gfx_copybuffer(i nt x, i nt y, i nt w, i nt h, i nt destx, i nt desty, i nt srcbuffer, i nt destbuffer) Copies the box specified by x, y, w, h from the source buffer to the destination buffer at destx, desty.
gfx_draw3dbar(i nt x, i nt y, i nt w, i nt h, i nt fi I I , i nt ul _fi I I , i nt I r_fi 1 I , i nt bdwi dth) The rectangle is at x, y, w, h. fi I l, ul _fi I l, and I r_fi I I are colors.
The color of the cen-ter of the rectangle is fi I l. Passing a -1 for fi I I indicates a transparent center, allowing you to draw a framed rectangle. ul _fi I I is the color of the upper and left sides of the rect-angle; I r_fi I I is the color of the bottom and right sides.
gfx_drawbar(i nt x, i nt y, i nt w, i nt h, i nt c) Draws a solid rectangle at x, y with width w, height h, and color c.
gfx_drawi con(i nt type, i nt x, i nt y, void *bi tmap, i nt trans_col or, i nt xoff, i nt yoff, i nt w, i nt h, i nt transform) *** add type info etc. when done Draws the bi tmap on the active buffer with the upper left corner at x, y.
xoff and yoff are the offsets in the image of the cropped rectangle. w, h are the width and height of the rect-angle and transform is the orientation ( 0, 90, 180, 270)..
.4Ths. TIP... Passing -1 for both the x and y loads the entire bitmap but suppresses the drawing. This provides a way to cache an image in memory.
gfx_drawl ne(i nt x1, i nt y1, i nt x2, i nt y2, i nt c) Draws a line 1 pixel wide from the point x1, y1 to the point x2, y2 with color c.
???gfx_drawpi xel (i nt x, i nt y, i nt c) is this still here do we use draw-line call Draws a pixel at x, y the color c.
s this drawspri te or drawbi tmap since we are passing in the type, what are the valid types al so ...
gfx_drawspri te(i nt type, i nt x, i nt y, void *bitmap, i nt xoff, i nt yoff, i nt w, i nt h, i nt transform) Similar to gfx_drawi con(), except bitmap must use color 99 as the transparent color.
i nt gfx_drawstri ng(i nt x, i nt y, i nt w, i nt h, i nt transform, char*
str, i nt color, i nt j usti fi cati on, i nt bgcol or) Writes a zero-terminated string str to the buffer. x, y is the lower left corner of the string, transform is 0, 90, 180, or 270, col or is the text color, j usti fi cai ton desired, and Rev: May 2001 a iShuffle Master . = . a we ltd.=

C.3¨WidgetRoutines C-3 bgcol or is the background color. Passing -1 for bgcol or makes the background to be transparent. Note that gfx_drawstri ng 0 can handle new line characters (\n).
gfx_geticondimensions(void *icon, int *w, int *h) Returns the w and h of he specified bitmap.
??? is this supposed to be in here???
gfx_getrect(int x, int y, int w, int h, void *buf) This routine copies the entire rectangle x, y, w, h, of the specified buffer.
gfx_setcachesize(int size) Sets the current cache size in megabytes used for graphics.
gfk_setcaching(int onoff) Sets the use of the cache on or off for graphics.
gfx_setclipping(int onoff) Sets automatic graphics clipping on or off gfx_setclippingrect(int x, int y, int w, int h) Sets the current location and size used for clipping.
gfx_setcontext(int context) Sets the current graphics context. context is one of the following values:
= GFX_SCREENBUFFER
= GFX_BACKGROUNDBUFFER
= GFX_WORKBUFFER
All commands, unless specifically stated, work the same whether drawing to the screen (GFX_SCREENBUFFER) or drawing to memory (GFX_BACKGROUNDBUFFER, GFX_WORKBUFFER).
There is video clipping provided for each buffer.
gfx_setfont(char* fontfile, int size) Loads the font in the file fontfi I e, and makes it the current font. Sets the current font size to size.
3. WIDGET ROUTINES
*** This entire section is changing. We will speicify default atrtributes and then use MAC-ROS to modify those.
SGOS buttons respond to finger presses on a touchscreen. For the development system on your desktop computer you can activate a button with a mouse. Each button calls a call-back function when pressed. These callback functions may have one argument which is the name of the button pressed. This allows many buttons to have the same callback func-tion, which is useful when putting keypads, or other similar controls on the screen.
* While there is only really one kind of button, there are three ways to make it. The sim-Rev: May 2001 /Shuffle Master , == = =GAMING

C.4¨ Modulehandling routines C-4 plest way to make a button is to give it a color and a name. The name is then displayed on the screen. The second way to make a button is to associate an icon (or graphic) with it;
the icon is then displayed on the screen instead of the button name. The third way is to pass two icons, one for the button as it normally is and one for when the button is pressed.
* You can change the parameters of a button by referring to it by name.
widget_action( ..... 997) widget_draw(char *name) widget_getattribute(char *name, char * attribute, int *value) widget_make(int type, char *name, int x, int yr, int w, int h) widget_setattribute(char *name, char *attribute, int value) 4. MODULE HANDLING ROUTINES
mod_exit(void) Fetches the library name most recently saved by mod_l oad(), and does a mod_ump() to it.
mod_exi t() also removes the library name from the saved list.
modjump(char *mod_name) Just like mod_l oad(), except the current library name is not remembered.
mod_load(char *mod_name) Loads the library mod_name, and puts a request for the function i ni ti al i ze() in the event queue. mod_l oad() also saves the current library name for retrieval by mod_exi t().
5. TIMER ROUTINES
timer_start(long timeout, char* callback) Starts a timer of duration ti meout in milliseconds. When the timer expires, a request for the function cal I back is put in the event queue. cal I back is a string giving the function name. The callback function must be passed without arguments.
timer_kill(char* callback) Deletes all the timers having the callback function cal I back. The function named cal I back is not called.
6. NON-VOLATILE RAM ROUTINES
The nvram is managed by a set of special routines. The game application never directly touches anything in the nvram; all game manipulations of the nvram occur through these func-Rev: May 2001 4 /Shuffle Master .
.a.r41I=1G

C.6¨ Non-volatileRAM routines C:5 tions. The nvram is partitioned into variables by the nvram manager according to the contents of the mygame. state file. This text file looks similar to a list of C
structure declarations, except the comment character is a # and this line never passes through a parser. The nvram parser reads this file at startup.
The mygame. state file makes it easy to put variables in the nvram, since the game application never needs to be concerned with the offsets of variables in the nvram.
Structure definitions can even be nested.
An nvram stri ng refers to a specific variable in nvram. A typical one looks like Game. cred-i tsl eft. To allow access to arrays, standard pri ntf-style format characters can be put in the string, and the values to insert are supplied as the additional arguments on each line. This fea-ture allows strings like Hi story [%I ]. bet, Stats. con[%I ], or even Bi I
!Hi s-tory [XI ] . datef% I 1. More elaborate formats are also possible, such as MyStruct. [XI ], since the string is formatted before being parsed.
The following set of procedures sets an nvram variable to the passed value.
Use the variant that matches the data type of the nvram variable. The additional arguments are the nvramstr formatting values, if needed.
nv_setchar(char* nvramstr, char, ...) nv_setdouble(char* nvramstr, double, ...) nv_setfloat(char* nvramstr, float, ...) nv_setint(char* nvramstr, int, ...) nv_setIong(char* nvramstr, long, ...) nv_setshort(char* nvramstr, short, ...) The following functions retrieve a value from an nvram variable. The value is returned through the pointer val. The function itself returns nothing. Use the variant matching the data type of the nvram variable. The additional arguments are the nvramstr formatting values, if needed.
nv_getchar(char* nvramstr, char* val, ...) nv_getdouble(char* nvramstr, double* val, ...) nv_getfloat(char* nvramstr, float* val, ...) nv_getint(char* nvramstr, int* val, ...) nv_getIong(char* nvramstr, long* val, ...) , .
Rev: May 2001 4":1:1.4 iShuffle Master = GAMING

C.7¨Soundroutines C-6 nv_getshort(char* nvramstr, short* val, ...) The following routines increment an nvram by amt. char* may be negative. No values are returned. Use the variant matching the data type of the nvram variable. The additional argu-ments are the nvramstr formatting values, if needed.
nv_incchar(char* nvramstr, char amt, ...) nv_incdouble(char* nvramstr, double amt, ...) nv_incfloat(char* nvramstr, float amt, ...) nv_incint(char* nvramstr, int amt, ...) nv_inclong(char* nvramstr, long amt, ...) nv_incshort(char* nvramstr, short amt, ...) 7. SOUND ROUTINES
sound_play(char* file, int channel, int loop, int pan) Plays the sound file named char* fi l e.
= i nt loop is either 0 or 1. 0 plays once; 1 starts a loop which ends with a call to sound_stop().
= i nt channel sets the sound to one of the 32 available channels.
= i nt pan ranges from -2 to 2, where -2 is left, 2 is right speaker.
sound_stop(int channel) Stops the sound currently playing in the specified channel, 1 through 32.
sound_volume(int percent) Sets the sound volume to percent percent of maximum volume.
8. MECHANICAL REEL ROUTINES
reel_spin(unsigned char* reelstop, int numstops) Initiates the spin of the mechanical reels, and stops those reels at array reel stop, values 0-21, for the number of reels numstops, default value 3.
reels_stop(unsigned char reel mask) Stops all spinning reels from reel mask. Can be used for a skill stop.
Rev: May 2001 cd0 /Shuffle Master - = . GAMING

C.9 ¨Extemal Display Routines C,7 9. EXTERNAL DISPLAY ROUTINES
extdisp_award(char* AwardChar) Displays the award to the external display.
extdisp_bet(char* BetChar) Displays the bet to the external display.
extdisp_credits(char* CreditsChar) Displays the credits to the external display.
extdisp_get(int type, char* DispString) Reads the currently displayed text string from the external display of type into Di spStri ng.
extdisp_set(int type, char* DispString) Sends the string Di spStri ng to the external display of type. Supported external display types defined in userapi . h are:
= LED_D I SPLAY
1 O. TEXT FORMATTING ROUTINES
int text_printf(char* str, const char* format, ...) Prints format, with any additional variables, into the buffer pointed to by str. This function does not allocate any memory for the string.
int text_strcat(char* dest, const char* src) Concatenates a copy of src to dest. src is untouched by this operation.
int text_strcmp(const char* strl, const char* str2) Alphabetically compares strl and str2 and returns an integer based on the outcome:
Value Meaning Less than zero strl is less that str2 Zero strl is equal to str2 Greater than zero strl is greater than str 11. RESOURCE ROUTINES
These resource functions ...
resource_get(char *what, ...) resource_set_file_opt(char *base_name, int must_exist) Rev: May 2001 /Shuffle Master . = . ==p..r.svisa=

C.12¨Miscellaneousroutines C-8 This is usually used through the #defmed funtion resource-set file(base_name).
Notes: Strings returned are sopied into the buffer given, THe strings are guarenteed not to be longer that RESOURCE_MAXSTRLEN bytes long.
12. MISCELLANEOUS ROUTINES
These miscellaneous functions do not fit in any of the above categories.
sys_breakpoint(int tag, void* param) Since the debugger will not allow breakpoints to be set in the game code (because the game is technically a "library"), calling this function in your game code cleverly allows you to trap breakpoints in the debugger. Passing a pointer in the argument param allows you view and alter a game variable in the debugger. The function sys_breakpoi nt is listed below for reference:
void sys_breakpoi nt(i nt tag, void* param){
char char_setva I = -1;
short short_setval = -1;
i nt nt_setval = -1;
if (char_setva I != -1) {
char* p = (char*)param;
*p = char_setval ;
if (short_setva I != -1) {
short* p = (short*)param;
*p = short_setval ;
Ýf (i nt_setval != -1) {
i nt* p = (i nt*)param;
*p = i nt_setval ;
sys_debug(char* format, ...) Prints format, which may contain pri ntf-style formatting characters, to the file debug. out.
sys_exec(char* func) Executes the function func and returns NULL if the function does not exist.
func is a string giv-ing the function name.
unsigned long rnd_get_number(unsigned long range) Returns a random number "r" such that 0 z= r < range.
sys_setlamp(char *light, int state) Sets light I i ght to state. 1 i ght is a string defined in the . oti file.
unsigned long sys_clock() Returns the system clock time.
Rev: May 2001 /Shuffle Master . = . Pa 1 am C.

C.13¨EngineAPICalls C-9 char* sys_getreleasedate(void) Returns a string stating the release date of the running version of SGOS.
char* sys_getversion(void) Returns a string stating the running version of SGOS.
char* sys_getversion(void) Returns a string stating the running version of SGOS.
13. ENGINE API CALLS
The following API calls become available by including engi ne_api . h in the Makefile:
#define TYPE_SOLO 0 #define TYPE_MULTI 1 A. Credit Engine Data engine_changebet(int change) Change is in (+/-) units of beti nc long engine_getaward(void) Returns the current total amount won.
int engine_getbet(void) Returns the amount of the current bet.
int engine_getbetinc(void) Returns the value of the bet incrementor.
long engine_getcredits(void) Returns the current number of credits on the machine.
char engine_getdoorclosedflag(void) Returns the status of the door closed flag, 1 closed, 0 open long engine_gethandpay(void) Returns the handpay amount.
long engine_getpaid(void) Returns the current amount won.
long engine_getpaidout(void) Returns the amount collected from hopper.
Rev: May 2001 4) 'Shuffle Master = . . .

C.13¨EngineAPICalls C-10 char engine_getpowerresetflag(void) Returns the status of the power reset flag: 1 power reset, 0 not.
char engine_getrebet(void) Returns the rebet flag value.
engine_setbetinc(int new_betinc) Set the new bet incrementor, in credits.
engine_setsnap(void) Sets a snap for the credit countdown.
B. Managing a Multigame char game_getcurrentstate(void) Returns the current game state.
int game_getdenomination(void) Returns the amount of the current denomination.
int game_getmaxbet(void) Returns the current maxbet amount of the machine int game_inprogress(void) Returns status 1 if a game is in progress, or 0 on false.
game_l oad (char *name) Sets currentgame to active instance of name and loads the I i b game_regi ster(char *name, int denom, int maxbet, int percent, char type) game_setcurrentstate(char state) Sets the game state to state.
game_setdenomination(int denom) Sets currentgame to currentgame name with denom C. Miscellaneous char * text_iconvert(int num, int pad) char * text_lconvert(long num, int pad) char reel_isstopped(int reelnum) Returns the state of reel (1...5) Rev: May 2001 a7/Shuffle Master :41 =====..b., = = ra 1 na C.14¨ Game SpecificAPI Calls C-11 1 4. GAME SPECIFIC API CALLS
A. Nineline Games The following API calls become available by including ni nel i ne_api . h in the Makefile:
char getbetperl i ne (voi d) Returns the current bet per line.
char getLi nesBet(voi d) Returns the number of lines that have bets placed B. Poker Games The following API calls become available by including poker_api . h in the Makefile (empty for now) Rev: May 2001 /Shuffle Master C.14¨ Game Specific API Calls C-12 Rev: May 2001 #14 iShuffle Master . . . IN 1 1.1G

APPENDIX D - .OTI CONFIGURATION FILE
Naming of . oti and . state files is derived from the base name given in the API call Regi s-terGame(). If your application has multiple games, each game will have its own . oti file. Mul-tiple denominations for the same game will share the same . oti file.
1. MYGAME.OTI FILE LISTING
You will modify the default . oti file for your game's hardware, if different.
For instance, an extra button on the target machine will require a related mapping.
Refer to parts B and C of this chapter for more about . oti syntax and file addresses.
The following is an example of a typical . oti file. Make changes as needed for your game configuration.
1 # Shuffle Master Template OTI fi I e 3 #
4 # Begin OTI Data #
#
6 runtime : {
7 load : game;
8 }
9 startup : {
= 10 display;
11 sound;
12 touchscreen;
13 chimp;
14 bi I I acceptor;
protocol;
16 }
17 serial :
18 1, touchscreen;
19 2, bi I I acceptor;
3, protocol;
21 4, watchdog;
22 }
23 debug : {
24 output : file;
options : {al ; }
26 }
27 nvram : {
28 media : file;
29 }
kernel :
31 "snd-card-es1688. o snd_i rq=9";
32 }
33 output : f 34 <3,2>, LOCKOUT;
<3,5>, HOPPERMTRL;
Rev: May 2001 4 4 /Shuffle Master"
= =
Clo AMEN CI

D.1 - mygame.oti File Listing D-2 36 <3,6>. HOPPERMTRH;
37 <3.7>, MUTESWITCH;
38 <2,6>, DI VERTERA;
39 <3,0>, DI VERTERB;
40 }
41 portmap :
42 <P, 4, 0>, z, mai n_open;
43 <R, 4, 0>, a, mai n_cl osed;
44 <P, 4, 1>, c, I ogi c_open;
45 <R, 4, 1>, d, ogi c_cl osed;
46 <P, 4, 2>, A, hopper_cl osed;
47 <R, 4, 2>, Z, hopper_open:
48 <P, 4, 3>, S, pri nter_cl osed;
49 <R, 4, 3>, X, pri nter_open;
50 <P, 4, 4>, s, cash_cl osed;
51 <R, 4, 4>, x, cash_open;
52 <P, 4, 5>, D, drop_cl osed;
53 <R, 4, 5>, C, drop_open;
54 <P, 3, 0>, , ' , coi ndn_swi tch;
55 <R, 3, 0>, k, coi nup_swi tch;
56 <P, 2, 2>, ' #' , coi nrev_swi tch;
57 <P, 3, 2>, 1, hopperup_swi tch;
58 <R, 3, 2>, ' . ' , hopperdn_swi tch;
59 <P, 3, 6>, o, hopperful I up_swi tch;
60 <R, 3, 6>, p, hopperful I dn_swi tch;
61 # The, following are synthesized events!
62 <S, 0, 0>, f, bill _cl ear;
63 <S, 0, 1>, v, bi Il_error;
64 <S, 0, 3>, b, pri nter_cl ear;
65 <S, 0, 4>, j, bi I I up_swi tch;
66 <S, 0, 5>, m, bi I I dn_swi tch;
67 <S, 0, 6>, w, bi I I 1_swi tch;
68 <S, 0, 7>, e, bi I I 2_swi tch;
69 <S, 1, 0>, r, bill5_swi tch;
70 <S, 1, 1>, t, bi 1 I 10_swi tch;
71 <S, 1, 2>, y, bi I I 20_swi tch;
72 <S, 1, 3>, u, bi 1150_swi tch;
73 <S, 1, 4>, i, bi I 1100_swi tch;
74 }
75 panel :
76 <P, 2, 7>, 1, servi ce_swi tch, swi tch_1;
77 <P, 3, 1>, 2, col I ect_swi tch, swi tch_2;
78 <P, 0, 3>, 3, betonel i ne_swi tch, swi tch_3;
79 <P, 0, 5>, 4, betthreel ne_swi tch, swi tch_4;
80 <P, 0, 7>, 5, betfi vel i ne_swi tch, swi tch_5;
81 <P, 1, 1>, 6, betsevenl i ne_swi tch, swi tch_6;
82 <P, 1, 3>, 7, betni nel ne_swi tch, swi tch_7;
83 <P, 1, 5>, 8, bet1perl ne_swi tch, swi tch_8;
84 <P, 1, 7>, 9, bet2perl i ne_swi tch, swi tch_9;
85 <P, 2, 1>, 0, bet3perl i ne_swi tch, swi tch_10;
86 <P, 2, 3>, , bet4perl i ne_swi tch, swi tch_11;
87 <P, 2, 5>, '=', bet5perl ne_swi tch, swi tch_12;
88 <P, 0, 1>, ' 1' , spi n_swi tch, swi tch_13;
89 <P, 0, 2>, ; ' , setup_swi tch, swi tch_14;
Rev: May 2001 ,s:at /Shuffle Master = r4 I ina D.1 - mygame.otiFileListing D-3 90 <P, 0, 0>, , j ackpot_swi tch, swi tch_15;

92 lights :
93 #These light strings are used by the engine 94 <0,0>, toweral ght;
95 <0,2>, towerbl i ght;
96 <0,4>, towercl i ght;
97 <2,7>, servi cel ght;
98 #These light strings are user defined 99 <0,1>, spi ni ght;
100 <0,3>, pl ay1I i ght;
101 <0,5>. pl ay31 i ght;
102 <0,7>, pl ay51 ght;
103 <1,1>, pl ay71 ght;
104 <1,3>, pl ay91 i ght;
105 <1,5>, bet1I ght;
106 <1,7>, bet2I i ght;
107 <2,1>, bet3I i ght;
108 <2,3>, bet4I ght;
109 <2,5>, bet5I ght;
110 <3,1>, collect! i ght;
111 }
112 coordinates : {
113 # These are 'shared' widgets used by the engine 114 credi tbox : 5, 500, 70, 30;
115 i nfobox : 400, 475, 400, 20;
116 pai dbox : 270, 500, 70, 30;
117 betbox : 620, 500, 50, 30;
118 payoutbox : 110, 500, 125, 30;
119 powerreset : 10, 70, 100, 10;
120 doorcl osed : 700, 70, 100, 10;
121 wi n-a : 200, 60, 400, 20;
122 wi n-b : 180, 470, 100, 20;
123 # Any 'custom' widgets should go here...
124 I i nesbox : 460, 500, 50, 30;
125 betperl i nebox : 540, 500, 50, 30;
126 }
127 i nfostri ngs : {
128 GOOD LUCK;
129 GAME OVER;
130 BET 5 CREDITS;
131 PUSH SPIN;
132 INSERT BILL;
133 }
134 ##
135 # Critical Event Function Pointers 136#
137 # Bel ow is a reference list of the currently supported #
138 # functions calls in the engine keyhandl er...
139#
140 # THIS SECTION SHOULD NOT BE CHANGED! #
141 ##
142 keyhandl er :
143 mai n_cl osed;
Rev: May 2001 4 #
/Shuffle Master .
cawrit4G

D.2 ¨ .oti Syntax forthe Core System D-4 144 mai n_open;
145 cash_cl osed;
146 cash_open;
147 I ogi c_cl osed;
148 I ogi c_open;
149 hopper_cl osed;
150 hopper_open;
151 pri nter_cl osed;
152 pri nter_open;
153 drop_cl osed;
154 drop_open;
155 bi 1 I _cl ear;
156 bi I I _error;
157 pri nter_error;
158 pri nter_cl ear;
159 bi I I up_swi tch;
160 bi I I dn_swi tch;
161 coi nup_swi tch;
162 coi ndn_swi tch;
163 coi nrev_swi tch;
164 hopperup_swi tch;
165 hopperdn_swi tch;
166 hopperful I up_swi tch;
167 hopperful I dn_swi tch;
168 bi I 11_swi tch;
169 bi I I 2_swi tch;
170 bi 1 I 5_swi tch;
171 bi 1 I 10_swi tch;
172 bi I I 20_swi tch;
173 bi I I 50_swi tch;
174 bill100_swi tch;
175 }
176 meters :
177 <4,3>; # Total I n 178 <4,6>; # Total Out 179 <4,0>; # Drop 180 <4,5>; # Credits Paid 181 <4,4>; # Jackpot 182 <4,1 >; # Progressive 183 }

2. .0TI SYNTAX FOR THE CORE SYSTEM
The following are the syntax rules for . oti .
1 syntax : group {
2 # the resource manager expects the following definitions 3 seri al : array of i =port, s=what / port >. 1 and port <= 4, 4 what = watchdog or what = touchscreen 6 or what = bi I lacceptor Rev: May 2001 ,g1 a /Shuffle A/taster . = P.
1,4114G

D.2 ¨ .oti Syntax for the Core System D-5 7 or what = protocol;
8 kernel : array of S;
9 output : array of <i=port,i=bit>, s=what /
port >= 0 and port <= 7, 11 bit >= 0 and bit <= 7, 12 what = lockout or what = hoppermtrl or what = hoppermtrh 13 or what = muteswitch or what = divertera or what = diverterb;
14 portmap : array of <s=porttype,i=port,i.bit>, S=letter, S.function /
porttype = p or porttype = r or porttype = s, 16 port >= 0 and port <= 7, 17 bit >= 0 and bit <= 7, 18 len(letter) = 1;
19 panel : array of <s=porttype,i.port,i=bit>, S=letter, s=cb,s=cb2 /
porttype = p or porttype = r or porttype = s, 21 port >= 0 and port <= 4, 22 bit >= 0 and bit <= 7, 23 len(letter) = 1;
24 lights : array of <i=port,i=bit>, s / port >= 0 and port <= 7, bit >= 0 and bit <=7;
26 meters : array of <i=port, i=bit> / port >= 0 and port <= 7, 27 bit >. 0 and bit <= 7;
28 keyhandler : array of S;

# the other parts of the system use the following 31 runtime : group {
' 32 load : S;
33 ? preload : array of S;
34 }
startup : array of s=what /
36 what = display 37 or what = sound 38 or what = touchscreen 39 or what = chimp or what = billacceptor 41 or what = protocol;
42 debug : group {
43 output : s=what / what = file or what = console or what = serial;
44 options : array of s;
46 # does anyone use this?
47 nvram : group {
48 media : s=what / what = file or what = sram or what = dram;
49 }
# these things are used by the engine 51 coordinates : group {
52 % : i=x,i=y,i=w,i=h / x+w <= 800, y+h <= 600;

54 infostrings : array of S;
# define a default item 56 % : free group ; # a group type with no syntax group, but which can define 57 # its own syntax group inside itself.

Rev: May 2001 a,' /Shuffle Master . . ni 1 am a.

D.3¨ New.otiFileSyntax D-6 3. NEW .0TI FILE SYNTAX
The first part deals with the syntax of the . oti file itself. The second part covers how to retrieve data from the . oti file in C.
A. Very Abstract, Broad Overview The . oti file provides a way to structure configuration data. The data is then easy to retrieve at run time using simple function calls. The file can also specify syntax, allowing dynamic type checking of data in the file.
B. Basic Structure Elements Three structure elements are provided: "groups," "arrays," and "rows." "Rows"
hold the actual data, consisting of integers, strings and real numbers (internal: real numbers even needed? Are other basic data types needed instead?). Arrays and groups just provide orga-nization for the rows. An array is simply a homogeneous list of items, (rows, groups, or other arrays). Groups allow for a heterogenous collection of items, each one bound to a name.
C. Basic Typing For each of these basic elements, a "subtype" of that element can be defined.
After the resource manager loads a file, the groups, arrays, and rows, it then checks to see if each structure element matches its subtype.
The subtypes are defined either in file or in an auxiliary file. (internal: in fact, the specifics of this need to be worked out.) Rows can define how many data items they have and each of their types, i.e. string, integer, real. Rows can also specify formatting characters <>O, and restrictions on the values of the data in the row. Arrays types specify the subtype of their elements and restrictions on their size. Groups can give a list of names to be in the group and their subtype.
D. File Syntax A row is a list of items separated by commas. The items are either numbers, strings or for-matting characters. A row is ended with a semicolon. An example row:
5, seafood platter;
An array is enclosed in braces O. The items in an array are not separated if they are rows, since the semicolon on the end of every row separates them well enough.
Otherwise, the items are separated with commas, just for aesthetic reasons. An array of rows:

{ 5, seafood platter;
458, light bulbs;
An array of arrays:
{ 1; 2; 3; }, Rev: May 2001/Shuffle Master , .
= = GAMING

D.3¨New.otiFileSyntax D-7 { 4; 5; 6; 1, { 123; 456; 789; }
Groups are also enclosed in braces {}. Groups are distinguished from arrays by the pres-ence of bindings. A bindings is represented by a colon and it serves to unify a name with a value. A binding looks like:
<name> : <i tem>
The item is either a row, an array or another group. An example group:
name : papa smurf;
age : 150;
parents : {
mother : Betty;
father : Barney;
The file itself is treated as one group so that everything in a file is bound to a name.
E. Defining Subtypes A row subtype is given as a list of format specifiers. The format specifiers are i <- integer s. <- string S <- case sensi ti ve stri ng f <- real numbers First a few notes. All strings specified as s are converted to lowercase. The f format char-acter really stores its data as the C datatype doubl e (and not as fl oat).
These format specifiers are separated by commas. In addition, formating angle brackets and parenthesis can also be given, in pairs. An example row type:
S, (i , i ), <i , i > ;
The type is ended with a semicolon. In addition, restrictions on the data values can be given. The first step is to give each data value of interest a name. This name is local only to this tow type. Not every element needs a name. The name is assigned by following a format specifier with an equals sign and then the name of the variable. An example:
S, (i=x, =y), <1,1>:
Now that we have variables we can use them in expressions. The available operators for expressions (from lowest to highest precedence):
Rev: May 2001 4 /Shuffle Master . . ros 1 no D.3 ¨New.oti File Syntax D-8 Bool x Bool -> Bool and or Bool -> Bool not NUMBER x NUMBER -> Bool String x String -> Bool = != < <= >
NUMBER x NUMBER -> NUMBER
+ -*
String -> lnteger I en() The comma operator (under Bool x Bool -> Bool) is simply a very low-precedence and operator. This allows the writing of expressions such as x>0, y>0 which allows one's eye to group the terms better. NUMBER is either Integer or Real. 'len' gives the length of a string. Parenthesis can be used to group sub-expressions. A restriction expression should evaluate to the boolean 'TRUE' if the data is okay. Any other value gen-erates an error. Thus, the expression would cause an error since it is the integer 1. The expression 1 = 1 evaluates to Boolean TRUE, and doesn't cause an error. The restriction expression is offset from the row definition by a forward slash. An example:
S, (i =x, i =y), <i =w, i =h> / x>0, y>0, w>0, h>0, x+w <= 800, y+h <= 600;
Two examples of valid rows based on this subtype:
What, (200,200), <100, 100>;
Are, (300, 500), <"100", 100>;
The second row is valid, even though the first 100 is in quotes because of how files are read in. Initially everything is read in as a string. When the subtype is applied to this row it tries to convert the strings which should be integers to integers. If it can't, an error is Rev: May 2001 /Shuffle Master . = . G/41111 D.3 ¨ New.oti File Syntax 0-9 raised. Now, three examples of an invalid rows based on this type;
You, (45, 67, 56);
Doing, 1, 1, 1, 1;
"Here?", (500, 500), <200, 200>;
The first row is invalid because it doesn't have enough elements. The second row doesn't have the right formatting. The third row has the correct format, but the data doesn't fit the restriction, since 500 + 200 > 600.
Array subtypes begin with the keyword array of followed by another subtype definition which gives the type of the elements in the array. An example:
array of i , s;
This gives an array of rows, each row consisting of an integer and a string.
Any'type defi-nition is permitted, even array of array of array of i , i ;
Which defines an array of arrays of arrays of pairs of integers. To make it easier to see the grouping of arrays, braces can be used:
array of array of array of fi, OD;
Notice that the semicolon moved to the outside of the braces. Arrays can also have restric-tions. The restrictions are defmed the same as they are for rows, except that arrays only have one variable: I ength. This is an integer giving the number of elements in the array. In addition, if an array has a restriction attached to it, the braces must be used. This prevents the restriction for the array from being confused with the restrictions for the row or other arrays. An example:
array of ( array of i , i ) / length > 5, length <= 10;
Group subtypes are identified with the keyword group. This is followed by an opening brace. Inside the brace is a list of bindings. These bindings associate a name with a type.
An example:
group {
ci ty : s;
Associates the row subtype of a single string to the name ci ty. The data would look like:
ci ty : New York;
The element bound to ci ty in the data has the type bound to ci ty in the definition. In addi-tion, the name ci ty is a mandatory binding and something must be bound to it in the data.
An invalid group to the previous subtype is:
Rev: May 2001/Shuffle Master . GAMING

D.3 ¨ New.oti File Syntax D-10 town : New York;
Because there is no binding to ci ty. Also invalid:
city : New York;
state : New York;
Because the subtype was not expecting a binding to state. This limitation motivates hav-ing optional bindings and default bindings. An optional binding may or may not appear in the data, a default binding is used for every name which the group subtype does not know how to deal with. An optional binding is indicated by putting a question mark before the binding name. Example:
group {
? city : s;
A default binding is indicated by binding to %. (internal: perhaps another keyword, e.g.
"default"?). Example:
group {
% : s;
Since the group type uses different name spaces for its mandatory bindings table and its optional bindings table it is possible to define group {
city : s;
city : i ;
In all cases, the group type first searches its mandatory binding table and then its optional binding table, and then finally it uses the default type, if there is a default type.
There is one more special kind of binding. A group type object allows you to define a type once and then use this type over and over. These are called "pure" types since no data can ever bind directly to them. Pure types are indicated by the keyword type before their name. Example:
group {
type guess : =I ow, i =hi gh, i =guess / low <= guess, guess <= high;
No data objects can have this subtype of a group since it doesn't define any data bindings, it only has one pure binding. The definition can use this pure binding anywhere a subtype Rev: May 2001 Shuffle Master . .

D.3 ¨New.otiFileSyntax D-11 is needed. Example:
group {
type guess : i =I ow, i =hi gh, i =guess / low <= guess, guess <= high;
a : 'guess;
b : array of 'guess;
c : group {
c : guess;
The back-quote makes a reference to the pure type. Then, when this reference is needed, the pure type is found and used. The references are not resolved at load time, only when they are needed. This means that the following passes without error since the optional binding to dog is not evaluated because there is no binding to dog:
subtype:
group {
? dog : ' dog_name;
cat : s;
data:
cat : whiskers;
subtype definitions are identified by being bound to the name syntax. This means that the definitions must be the member of some group (any group may have a syntax binding, in fact). When a binding to syntax exists it is either deleted or it is used as the local syntax rules for parsing the group it is found in. The choice is up to the original subtype for the group with the syntax bindings. By default a group may not define its own syntax. To allow a group this freedom, the keyword free is placed before group in the subtype defini-tion. The group definition for a free group is just the default subtype to use, in case the group does not have a syntax binding. An example:
subtype:
free group {
greeting : S;
data:
syntax : group {
% : i , i ;
Rev: May 2001' Shuffle Master . = .

0.3¨New.otiFile Syntax D-12 a : 1, 2;
b : 3, 4;
This is valid. The group subtype is declared free. The data has a binding to syntax giving alternate rules for this group. These rules are used to check the data.
An interesting point is that pure types are scoped and are available to all the subtypes in the group. The scoping should take into account the lazy evaluation of the references.
subtype:
group {
type city : group {
name : S;
where : 'state;
type state : S;
% : free group {
dest : ' ci ty;
data:
first : {
dest : {
name : New York;
where : New York;
second :
syntax : group {
type 'state : S, =zip;
dest : ' ci ty;
dest:
name : Denver;
where : Colorado, 80950;
Rev: May 2001 0Po iShuffle Master . =
GA.P=111r4c.

D.3 ¨ New.oti File Syntax DA 3 This is a contrived example, but it shows many things with type references.
First, they are scoped. In the subtype definition of ci ty, the reference to state is resolved in the parent.
In the data, the group bound to second redefmes the type state and uses a reference-to ci ty. The reference to ci ty uses a reference to state, however the state type which is used is not the new redefined state, the type used for state is the one defined in the scope of the original definition of ci ty. This behavior is similar to closures in Scheme.
Since subtype rules are identified by a binding to the name syntax, the element bound to syntax is a group subtype.
F. .oti File The . oti file is treatedas one large group. Thus, every element in the . oti file is bound to a name, and an .oti file may specify a syntax group to give new rules for it (but only if it is allowed).
Comments are started with a pound sign (#), and continue to the end of the line. To use the pound sign in a string, enclose the string in quotes.
G. Lexal Issues All elements are read in from the file as a string. Only during the second step, rule check-ing, are the strings converted to integers or real numbers. This allows one to have strings of digits, and it also allows a number to be represented in many ways. Numbers can be written in decimal, hex (with a Ox prefix), and octal (with a leading zero).
Real numbers can be written in scientific notation (e.g. -4.63e-28). Strings can be written in quotes, either single or double. Quotes inside can be escaped with a back-slash.
Examples:
"He said, ' Hel I o' "
'He said, "Hello'"
"He said, \"Hel I o\""
If you want something with the same name as a keyword, put it in quotes. Items in quotes are always identified as strings. In the following example the word "syntax"
in quotes is not identified as the keyword syntax.
"syntax" : Something not giving rules;
H. Arcane Torture and File Grammar The full grammar of the oti file is simple and boring. Here is the grammar of the restriction expressions, mildly more exciting. Notice that there is no provision for numbers. Strings are automatically coerced into integers and reals as needed. This allows both the string equality s=stri ng / string = "1";
and the integer equality i =Integer / integer = 1;
to be written as .õ
Rev: May 2001 =
aste s Ni r 4,4 /Shuffle .. .

D.4 ¨.oti FileAddresses D-s=stri ng / string = 1;
=i nteger / integer = "1";
although the second form is not very useful, and even a little misleading. The grammar of restrictions in the subtype definition:
= restri cti onl st := restri cti on I i st ' , ' restri cti On I restriction restriction := restriction AND r_term I restriction OR r_term I r_term r_term := idop I NOT i dop i dop := i dterm ' = i dterm i dterm ' !=' i dterm i dterm ' <' i dterm i dterm ' <=' i dterm i dterm ' >' i dterm i dterm ' >=. i dterm i dterm := i dterm '+ i dfactor I i dterm ' i dfactor I i dfactor i dfactor := i dfactor ' *' i dexp I idfactor /' i dexp I i dexp i dexp := STRING
I LEN ' (' STRING ' ' (' restriction ' )' 4. .0TI FILE ADDRESSES
The data in an . oti file is organized hierarchically. This allows us to define an address string to retrieve data. Elements in a group are identified by the name that they are bound to. Ele-ments in an array are indexed by a 0 based non-negative integer in brackets.
The addressing is very similar to the addressing of C structures and arrays. Consider the data:
boxes :
=====-=
Rev: May 2001 'Shuffle Master =
. = . TA

D.4 ¨.oti FileAddresses 0-15 1, 1, 50,50;
100, 100, 50, 50;
arrayofgroups :

name : Papa Smurf;
age : 150;
J, f name : Furby;
age : 1;
j ob : {
type : busboy;
wage : 8.00;
row : 1,2,3,4, "time to go";
The last line has the address row The boxes are addressed as boxes[0]
boxes [1]
In addition, arrays define an implicit element I ength which returns a single integer telling the number of elements in the array. This element would be addressed as boxes. l ength And we would get back 2. The groups are addressed as arrayofgroups [0]
arrayofgroups [1]
The elements in the array of groups are addressed as arrayofgroups [0] . name arrayofgroups[0]. age The items in job are addressed as j ob. type j ob. wage Ultimately what is returned is a list of data ¨ the list of data in the row.
Rev: May 2001 a.
/Shuffle Master :µ,/ = .
. .

D.4¨.otiFileAddresses 0-16 Rev: May 2001 /Shuffle Master s=-=õ, = . .TN

APPENDIX E - MYGAME.STATE FILE
game.state file listing:
# GameState structure definition # REQUIRED BY COMMON GAME ENGINE LAYER*******
# Common game configuration elements used by the engine -# visible from the game layer... (Additional game specific # elements should be created in a game specific configuration # structure.) struct configuration char maxbet;
char denomination;
char bitmapped;
char touchscreen;
char credit_display;
char bonus;
char progressive;
char network;
int betinc;
int red;
int green;
int blue;
int cash_limit;
int credit_limit;
int handpay_limit;
int cashout_limit;
int volume; =
int payoutpercentage;
int paytable;
int hopper_fill;
Config;
# Local Game NVram # All game specific components should reside here...
struct ball int x;
int y;
int x_vel;
int y_vel;
int start_x_vel;
Rev: May 2001 4'0 /Shuffle Nlasteri . = = CI
AMIN GI

int start_y_yel;
int start_x;
int start_y;
char rectangle;
int count;
int current rect;
) BBall;
struct bonus int bonustrigger;
Bonus;
struct template int working_example;
} Template;
= struct history int example;
) GameHistory170];
struct winners long rect_0;
=
long rect_1;
long rect_2;
long rect_3;
long rect_4;
long rect_5;
long rect_6;
long rect_7;
= long rect_8;
long rect_9;
long rect_10;
long rect_11;
long rect_12;
long rect_13;
long rect_14;
) Winner[4];
Rev: May 2001 '/Shuffle Master :41 =

APPENDIX F - GENERIC GAME TEMPLATE FILE
1. GENERIC_TEMPLATE.0 FILE LISTING
#include <userapi.h>
#include "game.h"
II include local game & graphics headers #include"generic_template.h"
/******************/
/* Engine Hooks */
/******************/
void init_game(void) // Local data initialization void reset_game(void) int volume;
// Initialize all local game nvram nv_setchar("Config.denomination",(char)100/DENOMINATION); ' nv_setchar("Config.maxbet",(char)MAXBET);
nv_setint("Config.betinc",(int)BETINC);
nv_setchar("Config.bonus",(char)DOBONUS);
nv_setint("Config.payoutpercentage",9201);
nv_getint("Config.volume",&volume);
sound_volume(volume);
void begin_play(void) II Local housekeeping and display cleanup nv_setint("Template.working_example",0);
void play_one(void) Rev: May 2001 'Shuffle Master"
= = MAIWINC=

F.1¨Generic_template.cFileListing F-2 // First stage game animation and logic SetCurrentGameState((char)PLAY2);
void play_two(void) //Second stage game animation and logic SetCurrentGameState((char)EVALUATE);
long evaluate_game(void) // Compute payline award amount and return value return 0;
void finish_game(void) // Local housekeeping void bonus(void) II Local pre-bonus logic & animation mod_load("bonus");
void attract(void) SetCurrentGameState((char)IDLE);
char check_for jackpot(void) =
char jackpotlevel;
jackpotlevel=0;
return jackpotlevel;
char check_for_bonus(void) char bonusflag;
bonusflag=0;
return bonusflag;
long bonus_complete(void) return OL;
Rev: May 2001 d /Shuffle Master :
= = = = y .
= GA IN 1 Pi C.

F.2¨generic template.hFileListing F-3 void animate_winner(void) // Winner animations (ie - paylines...) }
void animate_idle(void) // Idle mode animations void maxbet_game(void) // Local maxbet logic and display routines...
void cache_gfx(void) // Load graphics into cache }
void pick_numbers(void) int number;
number=md_get_num ber( 52);
}
void draw_game_screen(void) makebutton I ("PLAY",510,530,60,60,GREEN,"spin_switch");
makebuttonl("BET" ,400,530,60,60,LTBLUE,"bet_switch");
makebutton1("MAX",710,510,60,60,LTGREEN,"maxbet_switch");
makebuttonI("COLLECT",12,545,60,50,LTRED,"collect_switch");
makebutton I ("HELP", l I 5,545,60,50,YELLOW,"help_switch");
}
void update_lights(void) 2. GENERIC_TEMPLATE.H FILE LISTING
Rev: May 2001 p /Shuffle Master = . G.A./WING

APPENDIX G - GRAPHICS CONVERSION TOOL
1. LOCATION AND USE OF CONVGFX.PY FILE
You will find the convgfx. py graphics conversion tool on the SGOS CD-ROM.
***Specify directory when known***
Refer to Chapter 14 for an overview of how to store and organize your graphic icons and use the convgfx. py tool to covert them to XPM format.
2. FILE LISTING
File Listing G-1 provides a listing of File Listing G-1: convgfx.py 1 Place the final version of convgfx. py here This file is included in the SGOS installation CD-ROM.
Rev: May 2001 0 /Shuffle Master"
= = CI A IN I

APPENDIX H - MAKESTRIPS UTILITY (9 LINE GAMES) 1. THE MAKESTRIPS UTILITY
Makestrips will turn a list of par-sheet files into C source code arrays.
Since every par-sheet file has a different format, the task is complicated, but is still conceptually very simple:
= Read in the strip data from the par-sheet files.
= Format the data into a C header file.
Makestrips not only has many options governing how its default procedures do both steps, it will also let you replace either step with your own code.
To allow all this customization, Makestrips requires an auxiliary file to hold the settings of the various options. This file may have any name, but the default name Makestrips looks for is "makestrips.opt". If your file has another name you will need to specify it on the command line with the "-o <filename>" or "--optionfile <filename>" options. If you do not have an option file at all, you can either make one with a text editor, or run Makestrips with the "-n" or "¨new" options. If you do the latter, you will still need to edit the resulting file to fill in impor-tant options, such as the par-sheet filenames.
Makestrips, by default, is lazy and checks the modification times of the option file and the = input files against the modification time of the output file to see if the reel strips are already up-to-date. The check can be overridden by using the "-f' or "--force"
options, or by setting the option [check mod times] in the option file to a blank line.
The header file generated by Makestrips has the format as shown in Figure [refrence to F:headfile]. The elements in angle brackets <> are user specified options. The options in the repeated block are represented in the option file as a list of values in the order they are to be used.
/* [output file]
* file automati cal I y generated by makestri ps. py * creation date and ti me */
#i fndef _[output fi I e]
#defi ne _[output fi I e]
<head>
I #i fdef [current percentage]
I itdefi ne PAYOUTPERC [current payout]
l [array name] = {
Rev: May 2001 /Shuffle Masted = . = = ISAMINCI

H.2¨UsingMakestrips H-2 first reel strip.
1 second reel stri p, I = = = , 1 last reel strip 11;
1#endi f repeated for every [input file]
<tail>
#endi f [fi gure F: headfi I e]
2. USING MAKESTRIPS
The command line syntax for Makestrips is:
. /makestri ps. py [-f I --force] [(-o I --opti onfi I e) <fi I ename>] [(-n I
--new) kfilename>]]
3. CUSTOMIZING MAKESTRIPS
Makestrips has many options which can be set, but options can only be set from an options file. Every option has a name which may include spaces and a corresponding value or list of values. Some options have defaults and do not need to be given specifically, although they can be assigned new values by specifying them. Other options do not have default values and must be included in the option file.
The list of options to be presented are organized according to what conceptual step they apply to: reading a par-sheet file, writing the C header file, or general options.
An option description beginning with a '+' marks options which do not have default values and are required, other-wise the default values are given.
A. General Options * [input files] '+' A list of par-sheet files. The order the files are listed is important, since the files are processed in the order listed. Their order should correspond with the order of the [percentages] and [payouts] options.
* [output file[ '+' The name of the C header file to be created (with extension).
* [check mod times] Set to either 0 or 1. 0 forces the reel strip file to always be recom-puted. This is the same as the "-f' or "¨force" command line options. If set to 1, Makestrips will only remake the reel strip file if the file modification times indicate that the reel strip file is out of date. The default value is 1.
Rev: May 2001 /Shuffle Master , N....b....y.1 = - = = G 111W

H.3¨CustomizingMakestrips H-3 B. Par-sheet Parsing Options There are two reel strip parsers built into Makestrips: the default parser and the extended parser. Between the two of them just about any kind of paytable file can be read, but if these options are not enough, you can even write your own parser (see section [refrence to S:reelparser]).
The simple parser should be enough for most situations. It expects a tab delimited file and reads in the reel strips, one per column. The option [start column] adjusts the column the reel strips begin at. The extended parser, by contrast, uses regular expressions to interpret each line, and has the ability to go through a list of expressions until it finds one that matches.
Common Parser Options. The two parsers share a few options. These options have the same meaning with both parsers.
* [start line] A regular expression describing a line before the reel strips. The lines of each input file are read and discarded until a line matching [start line] is found. Reel strip parsing begins with the next line. If nothing is given, the parsing begins with the first line of the file.
* [stop line] A regular expression describing the line to stop on. Once parsing has begun, every line is checked against [stop line]. When a line matches the line is dis-carded and reel strip parsing of the file stops. If nothing is given, the parsing goes through every line of the file.
* [num reels] The total number of reels. The default value is 5.
* [extended parser] If set to I, the extended parser will be used. The default value is 0---use the simple parser.
Simple Parser. The simple parser assigns each reel to a column of the input file. It is important to specify [start line] and [stop line] so that the parser won't put whatever extra-neous garbage that is also in that column into the reel strip.
* [start column] An integer giving the column the first reel strip is in.
The other strips are assumed to be in the next [num reels] columns. This option is zero based, making the first column 'column 0'. The default value is O.
Extended Parser.The extended parser uses regular expressions. It starts with the pattern given in [line pattern l]. If the current line matches the pattern, the reel values are pulled from the line by grouping marks in the pattern. The groups are mapped into the reel strip arrays by the option [line map], with the first group going to the first reel strip index in [line map], the second group to the second index in [line map], etc. The pattern matching continues until a line doesn't match the current line pattern. If the option [line pattern 2] is given, [line pattern 2] become the new pattern and the current line is re-parsed with it, oth-erwise the current line is skipped, the pattern is not changed and the next line is read.
Repeat this process for each line pattern in the option file. Whenever a new line pattern is loaded, the next [line map <n>] is searched for. If no line mapping is given, the previous one is used.
* [line pattern <n>] '+' A list of regular expression patterns. There should be grouping elements '()' in the expression, one for each value to be extracted. The extracted val-Rev: May 2001 4 /Shuffle Nlaster =
. = .A PA 1 Pri H.4 ¨ The Format of the options file H-4 ues are put in left to right order into the strips for each reel. If there are more groups than reels, an error occurs. If [line pattern] is a list of expressions, the expressions are joined together with the regular expression =+=, which will match anything that is not alphanumeric or such as spaces, tabs and commas. Only required if [extended parser] is set to "1".
* [reel map <n>] '+' A list mapping the grouping elements in [line pattern <n>] to reel strips. Only required if [extended parser] is set to " 1".
C. C Header File Options * [head] A list of text to insert at the beginning of the header file.
Since Makestrips already inserts its own header, [head] would follow.
* [tail] A list of text to be included at the end of the header file.
[tail] appears before Makestrips's tail.
* [percentages] The list of percentages. "payouts" - the list of percentages and payouts.
4. THE FORMAT OF THE OPTIONS FILE
The most important item in an option file is a tag, which names a specific option. A tag begins with a left bracket, '[', in the first column, and ends with the first right bracket ']' on the line.
All the text between the brackets is the option tag; all text remaining on the line is ignored.
After a tag line, the lines after the tag are read in, even blank lines, and stored associated with the option given by the tag. An exception is the blank lines between the end of a tag's items and the next tag: these blank lines are ignored. However, the blank lines occurring between a tag's items are stored. The text before the first tag in the file is also ignored, allowing a nice lit-tle area for comments. The only other space for comments in the file are on a tag line after the tag.
A special exception is given to the text following the the tags [start line], [line pattern], and [stop line]. These tags require regular expressions, and need to use the left bracket, ' [', charac-ter. A single space placed at the start of a line will be striped out, allowing regular expressions to begin with a left bracket [1. If your regular expression needs to begin with a blank space, start the line with two blank spaces since only the first one is removed.
The order the options are given in the file are unimportant.
5. WRITING A PAR-SHEET PARSER
In case the two parsers built into Makestrips are not adaptable to read your par-sheet file, it is possible to write your own file parser. The parser should be a code snippet (not a function def-inition), and be included in the option file under the option [user parser].
The code snippet is expected to read in the option file and make assignments to the variable "reels", which is a list containing as many lists as reels. (As given by the option [num reels].) The first reel has index 0, the second reel index 1, etc. This variable will then be written to [output file] by Makestrips.
Your code snippet can use the following implicit variables: "reels", "filein", "stop_pat", and "get_option()", as well as using any builtin variables and importing as many modules as it likes. No restrictions are placed on the execution environment. The variable "reels" is the vari-able you should assign strings to, this is the variable printed into the header file. "filein" is an Rev: May 2001 -= /Shuffle Master = "VAIN C, H.5 ¨ Writing a Par-sheet Parser H-5 already open file object. The file position pointer has already been advanced to the first line after the line described by [start line]. "stop_pat" is a regular expression describing the line to end on. Your code does not need to make use of it. "get_option("(option name>")" is a fimc-tion which will return the value of the option <option name>, which is passed as a string. The option will be returned as a list of strings, with each string being a separate line in the option file. Although your parser will be invoked once for every par sheet file, there are no provisions for the script to pass variables between invocations.
As an example, here is the simple default parser as it would look in the option file if it were written as a code snippet.
[user parser]
import re import string start_col = i nt(get_opti on(' start col umn' ) [0]) num_reel s = i nt(get_opti on(' num reel s' )[O]) end_col = start_col + num_reel s for 1 in fi lei n. readl nes():
if stop_pat and re. match(stop_pat, 1 ) :
break tok = stri ng. spl i t(1[: -1], " ) i =O
for sym in tok[start_col : end_co I 1:
if sym 1= " :
reel s [ ]. append (sym) i =i +1 Rev: May 2001/ Shuffle Master = = ...MING

APPENDIX I ¨ NINE LINE GAME TEMPLATE
1. NINELINE_TEMPLATE.0 FILE LISTING
add when available 2. NINELINE_TEMPLATE.H FILE LISTING
add when available Rev: May 2001 2Shuffle Master .by = . = =
CIAMINCII

APPENDIX J ¨ POKER GAME TEMPLATE
POKER_TEMPLATE.0 FILE LISTING
add file Using when available -- this is font =
Rev: May 2001 0 /Shuffle Nlasterl . = ciamoraa APPENDIX K - OTHER TEMPLATES
these templates are under construction 1. HELP TEMPLATE
2. LAST GAME TEMPLATE
3. PAY TABLE TEMPLATE
4. BONUS TEMPLATE
Rev: May 2001 it 0 %Shuffle Master ,,tety = . = OAMI
11a APPENDIX L - ONLINE PROTOCOL EXCEPTION CODES
Exceptions.h is a complete list of olga (Shuffle Master's Online Gaming Architecture) excep-tion codes. With the relevant exception codes below olga will handle exceptions for sas, sds, and ogp protocols.
exceptions.h listing:
/' Shuffle Master Game Library Copyright (c) 1999-2000 Shuffle Master, Inc.
All Rights Reserved.
$Revision: 1.5 $
$Author: mqj $
$Date: 2000/07/31 22:00:23 $
./
#ifndef __EXCEPTIONSJI
#define EXCEPTIONS_H
// these defines are for all possible exceptions // door events #define MAINDOOROPENED0x01 #define MAINDOORCLOSED0x02 #define DROP000ROPENED0x03 #define DROPDOORCLOSED0x04 #define LOGICDOOROPENED0x05 #define LOGICDOORCLOSED0x06 #define CASHDOOROPENED0x07 #define CASHDOORCLOSED0x08 #define BELLYDOOROPENED0x09 #define BELLY000RCLOSED0x0A
#define NOTEDOOROPENED0x0B
#define NOTEDOORCLOSED0x0C
#define 000R7OPENED0x0D
#define DOOR7CLOSED0x0E
#define DOOR8OPENED0x0F
#define 000R8CLOSED0x10 // hopper & coin events #define HOPPERFULL0x12 #define HOPPERLOW0x13 #define HOPPEREMPTY0x14 #define OVERRUN0x15 #define COINOUTERROR0x16 #define COININERROR0x17 #define DIVERTERERROR0x18 #define REVERSECOIN0x19 #define COINLOCKOUTFAIL0x1A
Rev: May 2001 Shuffle Master #defi ne COI NOUTJAM0x113 #defi ne COI NDROP0x1C
#defi ne TOKENDROP0x1D
#defi ne CASHOUTCOINS0x1E
#defi ne CASHOUTTOKENS0x1F
#defi ne WI NCOINS0x20 #defi ne WI NTOKENS0x21 #defi ne WI NCRED I TS0x22 #defi ne CRED I TSFROIACOI N0x23 #defi ne CREDI TSFROIATOKEN0x24 // reel events #defi ne REELTI LT0x27 #defi ne REEL1TI LT0x28 *fief' ne REEL2TI LT0x29 #defi ne REEL3TI LT0x2A
#defi ne REEL4TI LT0x2B
#defi ne REEL5TI LT0x2C
#defi ne REEL6TI LT0x2D
#defi ne REELDI SCONNECT0x2E
#defi ne REELSTOPPED0x2F
// bill and stacker events #defi ne ACCEPTORFAI LROIA0x32 #defi ne ACCEPTORFAI LCS0x33 #defi ne ACCEPTORFAI L0x34 #defi ne ACCEPTORJA110x35 #defi ne STACKERJAM0x36 #defi ne REVERSEBI LL0x37 #defi ne 81 LLREJECTED0x38 #defi ne B I LLCOUNTERFEI T0x39 #defi ne STACKERFULL0x3A
#defi ne CASHBOXREMOVED0x3B
#defi ne CASHBOX I NSTALLED0x3C
#defi ne BI LLI N10x3D
#defi ne 81 LLI N20x3E
#defi ne BI LL I N50x3F
#defi ne BI LLI N100x40 #defi ne 81 LLI N200x41 #defi ne 81 111 N500x42 #defi ne BILL! N1000x43 #defi ne BI LLI N2000x44 #defi ne 81 LLI N5000x45 #defi ne BILLIN1CHANGE0x46 #defi ne 81 LLI N2CHANGE0x47 #defi ne 81 LLI N5CHANGE0x48 #defi ne 81 111 N1OCHANGE0x49 #defi ne B I LLI N2OCHANGE0x4A
#defi ne BILL! N5OCHANGE0x4B
#defi ne 81 LLI N100CHANGE0x4C
#defi ne B! LLI N200CHANGE0x4D
#defi ne 131 LLI N500CHANGE0x4E
#defi ne 81 LLI N$480x4F
Rev: May 2001 /Shuffle Master = = .

// printer events #define PRINTEROFF0x52 *define PRINTERON0x53 #define NEEDRIBBON0x54 #define CARRIAGEJAM0x55 #define PRINTERCOMM0x56 #define PAPERLOW0x57 #define PAPEROUT0x58 // user generated events #define WAITINGFORUSER0x5B
#define CANCELHANDPAY0x5C
#define CASHOUTBUTTON0x5D
#define BUFFERFULL0x5E
#define CHANGEREQUESTED0x5F
#define GAMESTOP0x60 #define DRAWCARDS0x61 #define BET0x62 #define CARDHELD0x63 #define GAMESELECTED0x64 #define GAMESTART0x65 #define GAMESTARTCOIN0x66 #define GAMESTARTCREDIT0x67 #define GAMESTARTTOKEN0x68 // attendant generated events #define CHANGECANCELED0x6B
#define BILLTOTALSRESET0x6C
#define OPTIONCHANGE0x6D
#define JACKPOTRESET0x6E
#define DISPLAYMETERS0x6F
#define DISPLAYMETERSEXIT0x70 #define SELFTESTSTART0x71 #define SELFTESTEND0x72 #define RECALL0x73 #define SOFTMETERSRESET0x74 // memory events #define RAMRECOVERED0x77 #define RAMCLEARED0x78 #define RAMBAD0x79 #define ROMERROR0x7A
#define ROMBAD0x7B
#define ROMCHECKSUMCHANGE0x7C =
#define ROMCHECKSUMERROR0x7D
#define PROMCHECKSUMCHANGE0x7E
#define PROMCHECKSUMERROR0x7F
#define MEMORYRESET0x80 #define BATTERYLOW0x81 11 progressive #define PROGRESSIVELINKFAIL0x84 #define PROGRESSIVEJACKPOT10x85 Rev: May 2001 0 ZShuffie Master ===== . = .
ror 1 1.4,0.

L, L-4 #define PROGRESSIVEJACKPOT20x86 #define PROGRESSIVEJACKPOT30x87 #define PROGRESSIVEJACKPOT40x88 #define PROGRESSIVEJACKPOT50x89 #define PROGRESSIVEJACKPOT60x8A
#define PROGRESSIVEJACKPOT70x8B
#define PROGRESSIVEJACKPOT80x8C
#define SASPROGRESSIVE0x8D
// other events #define POWERUP0x90 #define POWERDOWN0x91 #define GENERALTILT0x92 #define CASNOUTTICKET0x93 #define HANDPAYJACKPOT0x94 #define HANDPAYCREDITS0x95 #define CASHOUT0x96 #define RESETDURINGPAYOUT0x97 #define BONUSPAY0x98 #define OUTOFSERVICE0x99 #define TOUCHERROR0x9A
#define SIGNERROR0x9B
#define PROCESSORRESET0x9C
#endif Rev: May 2001 /Shuffle Master .

APPENDIX M ¨ SCREENS FOR SETUP AND
RECORDKEEPING
1. MAIN SCREEN
SGOS provides default screens for several setup, recordkeeping and diagnostics features. The following screen offers eight further options:
= Machine Statistics = Ticket-Bill History = Last Games = Location Information = Exit = Test = Configuration Guide = Out of Service 11-21WW=tilV,:tr.
*31-.4":41W*74t9 FAMilfrX4VS:
FigureM-1¨

µ4 --Setup, Recordkeep ing and Diagnos-tics Main PRESS 'SERVICE' TO MOVE BUTTON
Screen PRESS 'COLLECT 1%) SELECT
2. MACHINE STATISTICS
The "Machine Statistics" button on the main screen leads to the two screens shown in Figure 7 and Figure 8. The items tracked in Figure 7 are as follows:
"Soft Meter" ItemExplanation Coins InNumber of credits from coins Rev: May 2001 01. 4 /Shuffle /Vlasteri = ailidt11440 M.3¨ErrorCounts M-2 -Bills In Number of credits from bills Drop Number of credits in the drop (coins only) Total In Simple count of total credits in Total.OutSimple count of total credits out Credits PlayedTotal of all credits played Credits Won Total credits won by playing, excluding jackpots and hand pay Credits Paid Credits paid from hopper, excluding hand pays .
or jackpots Games PlayedSimple count of games played Games WonSimple count of games won Hand PayTotal hand pays in credits, including errors paid by attendant Jackpot Total jackpots in credits, all attendant paid Hit frequency% of played games that win Awarded %Payback percentage 3. ERROR COUNTS
The error counts in the following screen are all simple counters as noted.
(Each door opening counts as an error.) Games played are also simple counts since the last power up or door closed events. Counters max out at 1000 and remain there until the next reset/clearing event occurs.
= MACHINE STATISTICS
1 1..Tiq 1F2-11 01:f. 14 -AA-1-11-111 l'.11 IH
'fficAl'Al -If f. 14 -AATII¨Al -II r 111 -CA-CAl'al 11 1- 1111 s 11 11 1 l! L.
i 11 t 11 i it i JIM_ II -UU-11.1--UJ _11.M. IM AU-LUAUJ
-11}1- A .UU-Llt.-UJ JIM. ill .LIALOJ.U1 LPFIT7 '1A-F11 'AAYA--A, 4EVIT: 14-Fn 1-A-Cal'Al EPrIT: ON WIA--111 cnr-17: 1.114 -CA-Cal-fil ttin I t: ..:l 1111 I 11 II 1 1:111 1 1: -%1 I II 1 II 1 II 1 l.411:j r-ta- -VIALU--0.1 - L41:.
MM.. .A.I.LVJA) tlifei Ait -UU-11A-Vi 0.4.: Alt .11.1.1.U.I.U.) -4H: -41 :0:C0::1:0 -4H: '4Y :CO:C07:0 1111-1-11--111 14',E1- "CA-Cal-Al IT -.In fler IT -:n1 FIV.. -= Pil.4.11L. .5 _ P/1411- A
F;41?7. FERrt%
-MT. P.7;17 " "lerF RFNT7 -1=.1'. "Yr " i,4.t -Tr -E; 111 it t:; : NI I!
I.:4'; -Ø _ 1:4'; ..1J, ..
-JP LE JUR-JP ER U,JE
-tlqi; DO; :
- . 'ER7E; DJ; :
-hl: 'Il; - -It-: 'Il; :
'II .µ"is -vrri: = 11 .,"( "PM: --MI, . -EIAL. .
-JI. LE ,.11:.:vP -:-JP ER ..?1.T11 -:
-)P'EPOEFAH :
-DP-0: a!EPAH
Figure M-2¨ HFSPF1.7- CI
-f.11: .11-1(fall W.) "
Machine .34ES P..7E: Sh:E: .
5 lttli.51.14Vei:
. - 5.==
Statistics D^ O; CLOND :
..
Screen #1 SPIN = EXITS i SERVICE = NE .:=
XT
El Pressing the "Next" button above leads to the following screen which shows the number of wins for each possible payline.
Rev: May 2001 ---1 4 /Shuffle Nlaster '....õ,,, õ . = . =AIN.

M.4-Ticket-Bill History M-3 WINNING STATISTICS
/CCN TAO 'THREE FOUR F:VE
W:LO V.-IAMNY 0 0 0 0 ?RES YOUR LUCK 0 0 0 0 313 WM' 0 0 0 0 CRU/SE 0 u 0 u :+1ATERMELOPI 0 0 0 0 nr= ANC.P. 0 0 0 0 TRIGGER 1,11-1Ari.n:Y o o o 0 TOTAL HD'S 0 0 0 0 , Figure M-3¨

Machine Statistics Screen #2 SPIN EXITS
III
4. TICKET-BILL HISTORY
The "Ticket-Bill" button on the main screen leads to the following two screens. The Bill His-tory Screen gives the date and time of the last twenty bills accepted, for machines with bill acceptors, and a history of tickets printed where applicable.
BILL HISTORY TICKET HISTORY
"7:7 -.F F4.1--17...r.T.7 ^T.T.:F"
- "....TF T-Mr. AM .1:771.
....- ....... ( 0 -( 0 .........

========= C U =:
( 0 ====== ==========
........ .t rt .f:
( 0 =

.. ========= " === ....... ='==
======= ... ::
C U
=
( 0 == r. n :.
. ( 0 =
..- C 0 ---=.: ;
Figure M-4¨ ....... c 0 Ticket Bill History Screen #1 SETUP EXITS
Rev: May 2001.::-17---/Shuffle Master -....,.õ,õg. . = = ....mi.=

M.5¨LocationInfonnation M-4 The Stacker/Hopper Inventory Screen gives a count of bills and coins in the machine (as appli-cable). The screen items are as follows:
Screen Item Explanation Stacker Hopper Inventory Accumulates amounts in increments shown Stacker Value Gives total value of bills, amount as credits, and actual number of bills instacker Hopper Value Shows credits in hopper (actual coins); fill amount must match bag amount ButtonsAttendant can adjust the fill amount with the "increase/decrease"
buttons.
Standard fill amount is set in the Configuration Screen (Figure 18).
Attendant selects current fill amount with the "add/remove" buttons.
STACKER/IIOPPER INVENTORY SfACKE.R. VALUE
I ",/.1 I -21111: 33: E.7.:%C.11.: 3 WPM:

CFEE.I7: It.: HOPPE:
711 MN :Tr F ?= Or r*.
C. 250 Z
arpy*:45iV;Z ?0,-SW41P34 ^ 200'3 Figure M-5¨ r, .-e57,m,w4774TA, ;1:*-T4',"j Stacker/
^ 2.103C
Hopper Inventory (Ticket Bill History Screen #2) S.ETUP EATTS
The Game History Screen in Figure 11 provides a 70-step game history for resolving player disputes. The example below is from a 9-line game. (How/where code in graphics for devel-oper's game?) 5. LOCATION INFORMATION
The Location Information screen accepts basic user data.
Rev: May 2001f a/Shuffle Master =

M.6¨DiagnosticTestScreens M-5 0 t2,..azicimpiEt..:
e ___________ /÷-----.....-.... , , -'. =
, ....xl...., :...., 411.
7 ..,..,/, ¨
¨
¨ 'tr) . ' . ='" 4":". o=
,3":" II =1": "? L
= . L..." L... -..or ..".. ' . , FigureM-6---- 1 _cli __:: -li _Li 1 ill ....L0 I
Game His- NEDITS PAID LINED BET
11..T.I.L EMT
tory Screen _ ----F:="77 REEMOMON

[.-.;;-.- MMMIMIMIIII
1 -- 11111111111111 ,-F-T,:: moo 1--;;;;;.: gi.
DE-"7- MEN
F-. 1.30. CUS.11 Iji.F-':it:410- R:7E7 ' KI.:: :LIM Er ! - ...+'-'4' 1:0-`: 'A _LL
!CR LL
'Ll NG_ IVA': :,L_LL la: ;Al Flail', . EXIT 'CASA 1AT
SELEC7 -EtT
Figure M-7- _ F _ r; _ F. [.. r, Fi r; .
I.. [.- ..
Information r FM F F Tc-: 17 F r. r- 17 r; F 1.- I
Screen 6. DIAGNOSTIC TEST SCREENS
The Diagnostic Tests screen runs five tests as shown in the following screens:
1. Lights/Switches 2. Touchscreen 3. Bill Validator 4. Hopper 5. Sound (set volume) Rev: May 2001 if;`
'Ill /Shuffle Master ',...,,,,,õy = . = . ..,.. 1 N C.

M.6 ¨ Diag nostic Test Screens M-6 At the start of the Light/Switch Test all switches show "unknown." To test, the attendant or I T.XCHSC.REEN
PER
mutmumma EMT
Figure M-8-Diagnostic PRESS 'SERVICE TO MOVE BUTTON
Tests Menu PRESS 'COLLECT' TO SELECT
Screen slot tech must press each switch to show "good." Note that the setup switch is unknown because it is used to exit this menu.
The touch screen test displays instructions on the screen.
Figure M-9 -Touch-screen Test 70 TOUCH G REEN BUTTONS TO TEST
The bill test screen verifies the bill acceptor operation. The bill is returned after the bill Rev: May 2001,41'o iShuffie Master . =
. = = GP, 1.4 1 M.6¨Diagnostic Test Screens M-7 denomination is identified. No soft or hard meters are affected by the insertion of bills.
The Hopper Test confirms with pressing the "Start" button that the hopper dispenses coins cor-INSERT BILL TO TEST =
=
4) -f-1 1 FigureM-10-Bill Test Screen SETUP EXITS
rectly. Test is for 20 coins; the screen below shows the count in progress. No soft or hard meters are affected by the dispensing of coins.
HO PI) El-Z 'I' ES' 1 ' PRESS STAR:1"1:0 TEST HOPPER
_______________________________________________________ 1 [ .

FigureM-11 ------Hopper Test MIT
Screen SETUP EXITS
...1:-....
Rev: May 2001 1=4 /Shuffle Master ======õ," . . = . C.
AM inac M.7¨ConfigurationGuide M-8 7. CONFIGURATION GUIDE
The Configuration screen sets the following:
Configuration Setting Explanation Progressive Whether jackpots are progressive Network Should be "on" when applicable Cash in Limit Sets max credit player can accumulate before they must play Credit Limit Automatically pays any amount above setting Hand Pay Any credits won beyond this setting must be paid during cashout Hopper Fill Standard hopper bag amount Volume Speaker volume Network Address Ref number for this machine (for network, where relevant) r-. =
cmc: Loa:
-- "
'BET' tiVES ACTIVE BUTTON
FigureM-12 =SPIN INCREASES NUMBER
'CHANGE' DECREASES NUMER
Game Con- =PRINT ' tVES CURSOR
'SETUP' EXITS
figuration =
Screen Rev: May 20011 Shuffle AAaster = GP. TA

APPENDIX N - ADVANTEC HARDWARE SOLUTION
INFORMATION
1. CHIMP ¨ PCM-5864 EMBEDDED CONTROLLER
A. Flow/Block Diagram Not available from Shuffle Master, please contact Advantec.
B. Schematic Diagram Attached C. Layout Diagram Please refer to page 7 (Acrobat page 18) of the PCM-5864/L Users Manual, available from Advantec. (PCM5864-1¨pdf) D. Parts List Not available from Shuffle Master, please contact Advantec.
E. Jumper Settings Please refer to pages 9-37 (Acrobat pages 20-48) of the PCM-5864/L Users Manual, avail-able from Advantec. (PCM5864-1¨pdf) Jumper Name Settings Selection JPI ATX power switch All pins open Not used JP2 Watchdog Action Short 1-2, Open 3 System Reset J3 CPU voltage Open 1-2, Short 3-4, Open 5-6, Open 7-8 2.20V
J5 CPU frequency ratio Short 1-2, Short 3-4, Short 5-6 4.5 J6 Reserved All pins open J7 CMOS Clear Short 1-2, Open 3 Battery On J8 LCD Backlight Short 1-2, Open 3 Positive . J9 System/PCI clock Short 1-2, Open 3-4, Short 5-6 66MHz/33.3MHz J10 PCl/Clock Open 1, Short 2-3 33MHz J11 COM4 RI Open 1-2, Open 3-4, Short 5-6 RI
J12 COM3 RI Open 1-2, Open 3-4, Short 5-6 RI
J13 Compact Flash Installed Enabled (don't care) J14 COM1 RI Open 1-2, Open 3-4, Short 5-6 RI
Rev: May 2001 4 0 /Shuffle Nlasteri . = a A P.v I im N.1¨ CHIMP¨PCM-5864Embedded Controller N-2 J15 COM2 RI Open 1-2, Open 3-4, Short 5-6 RI
J16 LCD Power Short 1-2, Open 3 +5V
J17 Reserved All pins open J18 Buzzer Installed Enabled J19 COM2 Mode Short 1-2, Open 3-4, Open 5-6 RS-232 J20 COM2 Mode Short 1-3, Short 2-4, Open 5-6 RS-232 J21 COM2 Mode Short 1-3, Short 2-4, Open 5-6 RS-232 J22 LCD Shift Clock Short 1-2, Open 3 SHFCLK
J23 Audio Power , Open 1, Short 2-3 +12V
J25 TV-Out Open 1, Short 2-3 NTSC
F. Removable Components BT1 ¨ Battery for CMOS configuration settings.
U18 ¨ BIOS ROM
U529 ¨ CPU
DIM1 ¨ Dynamic RAM memory module.
G. Connections Label Function Status CN1 CPU Fan Not Installed CN2 Motherboard Fan Not Installed CN3 Ethernet Not used ¨ May be cabled to HABIT
CN4 Audio Cabled to HABIT
CN5 PCI Not used CN6 CD Audio IN Not used CN7 AUX Line In Not used CN8 Main Power Cabled to HABIT
CN9 Keyboard & Mouse Not used ¨ May be cabled to HABIT
CN I 0 Floppy Drive Not used CN11 PC/104 ISA bus Expansion CARD STACK
CNI2 IDE Hard Drive Not used CN13 Reserved Not used CN14 Parallel Port Cabled to HABIT
CN15 Front Panel Not used Rev: May 2001 It /Shuffle Master N.2¨PCM-3810RAMConfiguration N-3 CN16 USB Not used ¨May be cabled to HABIT
CN17 IR Not used CN18 CRT Display Cabled to HABIT
CN19 Video Out Not used CN20 Flat Panel Not used CN21 Ext. Flat Panel Not used CN22 Peripheral Power Not used CN23 COM Ports Cabled to HABIT
CN30 Video In Not used CN501 Compact Flash Not used CN502 Speaker Out Not used DIM1 DIMM Dynamic Ram J1 ATX Feature Not used JP3 LVDS Not used 2. PCM-3810 RAM CONFIGURATION
A. Flow/Block Diagram Not available from Shuffle Master, please contact Advantec.
B. Schematic Diagram Attached C. Layout Diagram Please refer to page 1 of the PCM-3810A PC/104 Solid-State Disk Module manual, avail-able from Advantec.
D. Parts List Not available from Shuffle Master, please contact Advantec.
E. Jumper Settings Strapping for the "PCM-3810A PC/104 Solid State Disk Module." Battery backed Static RAM configuration.

Rev: May 2001 /Shuffle Master.
= = ca.rmins,=

N.3¨PCM-38100S/DOCConfiguration N-4 J2 2 2 Module Address D800 J4 2 2 2 B2S3 ¨ Disk On Chip Disabled J5 2 2 2 B2S3 ¨ Battery Enabled J6 2 2 2 B1 ¨ Battery Disabled J7 2 2 2 B2 ¨ Battery Enabled Bank 1 Static RAM
Socket 3 Bank 1 Static RAM
Socket 2 Bank 1 Static RAM
Socket 1 Internal Batteries Connected F. Removable Components M1 - Bank 1, Socket 1 ¨ not currently used.
M2 - Bank 1, Socket 2 ¨ not currently used.
M3 - Bank 1, Socket 3 ¨ not currently used.
M4 - Bank 2, Socket 1 ¨ Static RAM
M5 - Bank 2, Socket 2 ¨ Static RAM
M6 - Bank 2, Socket 3 ¨ Static RAM
BT1 - Battery - Installed BT2 - Battery - Installed G. Connections PC/104 Connector ¨ PC bus CN1 ¨ Reserved by Advantec.
3. PCM-3810 OS/DOC CONFIGURATION
A. Flow/Block Diagram Not available from Shuffle Master, please contact Advantec.
B. Schematic Diagram Not available from Shuffle Master, please contact Advantec.
Rev: May 2001rit z4r4 '/Shuffle Master = G"TellIMG

N.3¨PCM-38100S/DOC Configuratiori N-5 C. Layout Diagram Please refer to page 1 of the PCM-3810A PC/104 Solid-State Disk Module manual, avail-able from Advantec.
D. Parts List Not available from Shuffle Master, please contact Advantec.
E. Jumper Settings Strapping for the "PCM-3810A PC/104 Solid State Disk Module." Operating System and Disk on Chip configuration.
11 2 2 Module Address DC00 J4 2 2 2 B2S3 ¨ Disk On Chip Enabled J5 2 2 2 B2S3 ¨ Battery Disabled J6 2 2 2 B1 ¨ Battery Disabled J7 2 2 2 B2 ¨ Battery Disabled Shuffle Master Gaming Disk On Chip Operating System ROM 3 Shuffle Master Gaming Bank 2 Operating System ROM 2 Socket 2 Shuffle Master Gaming Shuffle Master Gaming Operating System ROM 1 Operating System ROM 4 Batteries Disconnected (Remove batteries from module) F. Removable Components Bank 1, Socket 1 ¨ SGOS ROM # 1 Bank 1, Socket 2 ¨ SGOS ROM # 2 Bank 1, Socket 3 ¨ SGOS ROM # 3 Bank 2, Socket 1 ¨ SGOS ROM # 4 Bank 2, Socket 2 ¨ not currently used.
Bank 2, Socket 3 ¨ Disk On Chip ¨ Game personality program.
Batteries ¨ Removed Rev: May 2001 z:::t-:i.:'=."-iShuffle Master zl =
. GAMING

N.4¨HIC N-6 G. Connections PC/104 Connector ¨ PC bus CN1 ¨ Reserved by Advantec.
4. HIC
A. Flow/Block Diagram Attached "HICflow.vsd"
B. Schematic Diagram Attached C. Layout Diagram Attached D. Parts List Attached E. Jumper Settings One jumper that selects SRAM secondary enable from either Vcc or Battery Monitor. Cur-rently the jumper is set to select Vcc by shorting pins 1-2, pin 3 is open.
(Jumper away from the connector.) F. Removable Components U2 ¨ Control Decode GAL
U3 ¨ Address Decode GAL
U10 ¨ Watchdog ROM
G. Connections JP I, JP2 ¨ PC/104 Connector¨ PC bus P1 ¨1/0 to HABIT
5. HABIT
A. Flow/Block Diagram Attached "HABITflow.vsd"
B. Schematic Diagram Attached C. Layout Diagram Attached Rev: May 2001 414 /Shuffle Master . = wir I
Pa c N.5-HABIT N-7 =
D. Parts List Attached E. Jumper Settings No jumpers, however there is an ECO to remove the non-working power off door monitor circuit.
See Engineering Change Orders FTC-001, FTC-002, and FTC-003, available from Advantec.
F. Removable Components There are no removable components.
G. Connections P1 ¨ Game Harness P2 ¨ Game Harness J1 ¨ Feed through COMM ports from CHIMP
54 ¨ from Power Supply J8 ¨ Audio from CHIMP
J9 ¨ Feed through Printer from CHIMP
J10 ¨ Feed through USB from CHIMP
J11 ¨ Feed through Keyboard & Mouse from CHIMP
J12 ¨ Feed through Ethernet from Chimp J13 ¨ Feed through Video from CHIMP
J14 ¨ Power for CHIMP
J16 ¨ UO from HIC
Rev: May 2001 /Shuffle Master.
. = . GAMING

APPENDIX 0 ¨ FURTHER HELP AND
TROUBLESHOOTING
1. SHUFFLE MASTER WEBSITE
shufflemastersupport.com 2. TROUBLESHOOTING
=
[add list of known problems and solutions]
=
Rev: May 2001 4 ?Shuffle m Master"
sk . = ca Pa a

Claims (20)

THE SUBJECT-MATTER OF THE INVENTION FOR WHICH AN EXCLUSIVE
PROPERTY OR PRIVILEGE IS CLAIMED IS DEFINED AS FOLLOWS:
1. A method of generating a computer based wagering application comprising:
providing a gaming operating system operable 1) to load a gaming application comprising a plurality of game program objects and to generate a wagering game on a computing system in response to information received from the gaming application, 2) to maintain a set of gaming data variables for reconstructing a state of the wagering game in response to a power loss or other malfunction on the computing system wherein the gaming operating system comprises a plurality of software components, one or more Application Program Interfaces (APIs), associated with the plurality of software components, that define information recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system, and plural gaming callback functions that allow the wagering game to be provided on the computing system, said plurality of software components and gaming callback functions compatible with one or more of a plurality of different computing systems, a plurality of different gaming applications or combinations thereof; and wherein said plurality of software components and gaming callback functions can be provided by a plurality of different software vendors, 3) to determine a vendor associated with each of the plurality of software components, the one or more APIs associated with the plurality of software components and gaming callback functions; 4) to determine whether each software component associated with the vendor is related to a presentation, a determination or a storage of win-loss information for said wagering game; 5) to determine whether the vendor is license by a gaming regulatory authority to provide software components associated with the presentation, the determination, or the storage of win-loss information for said wagering game based upon said determination of whether each software component associated with the vendor is related to the presentation, the determination or the storage of win-loss information for said wagering game;

providing the one or more APIs that define the information that is recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system wherein the one or more APIs are designed or configured to allow the gaming application to at least 1) access a non-volatile memory (NV-RAM) wherein the NV-RAM is for at least storing the set of gaming data variables, 2) specify storage requirements for the NV-RAM including information related to the set of gaming data variables, 3) provide instructions related to outputting video data or audio data available with the gaming operating system, provide instructions for peripheral devices recognized by the gaming operating system wherein the instructions are translated by the gaming operating system into formats recognized by the peripheral devices, 5) request one or more random number to be generated and 6) provide gaming application specific data used in the wagering game;
determining that a portion of the plurality of software game components and call back functions are required by the gaming application;
providing a configuration file for running the gaming operating system on the computing system; and compiling a gaming program specific to the gaming application and that is compatible with the gaming operating system wherein the gaming program includes the portion of the plurality of software gaming components and the callback functions.
2.
The method of claim 1, wherein the plurality of software gaming components are selected from the group consisting of random number generator, game initiation sequence, bonus module, video gaming module, audio gaming module, jackpot module, graphics conversion tool, debugging tool, pay-out table module, value-handling module, power-loss recovery module, gaming payout history module, player history module, and user interaction module.
3. The method of claim 1 wherein public and/or private authentication keys are revved and different public and/or private authentication keys are provided to each of at least two different legal jurisdictions to prevent one or more of the gaming application or the gaming operating system approved to operate in a first legal jurisdiction from operating in a second legal jurisdiction.
4. The method of claim 1 wherein the computer based wagering game application is developed for an apparatus comprising:
a computerized game controller including a processor, memory, and the NV-RAM; and an operating system kernel that executes a system handler application.
5. The method of claim 4 wherein the system handler application comprises:
a plurality of the device handlers;
software having the ability when executed to:
load the gaming program; and execute the gaming program;
the API with functions callable from the gaming program; and an event queue for executing specified ones of the plurality of device handlers in an order.
6. The method of claim 4 wherein a first gaming data variable in the set of gaming data variables is modified by a first game program object in the plurality of game program objects via the API prior to the execution of a second game program object in the plurality of game program.
7. The method of claim 6, and wherein the first gaming data variable modified by the first game program object is stored in the NV-RAM and changing the first gaming data variable in the NV-RAM causes execution of a corresponding callback function or a corresponding device handler.
8. The method of claim 4, wherein the operating system kernel is a an open operating system kernel having customized proprietary modules and the kernel has at least one modification wherein each modification is selected from the group consisting of: 1) accessing user level code from ROM, 2) executing from ROM, 3) zero out unused RAM, 4) test and/or hash the kernel, and 5) disabling selected device handlers.
9. The method of claim 4 wherein the apparatus contains a machine-readable component with machine-readable instructions thereon, the instructions when executed are operable to cause the processor to manage at least one of the plurality of game program objects via the system handler application and to execute a single gaming program object at any one time, wherein at least two of the plurality of game program objects are operable to share game data via the NV-RAM.
10. The method of claim 1 wherein after compiling the gaming program specific to the gaming application, a machine-readable memory storage element with instructions thereon has instructions that when executed to cause the computing system to:
load a first game program object in the plurality of game program objects to a memory;
execute the first game program object;
store gaming data in the NV-RAM in response to the execution of the first game program object, such that a second game program object in the plurality of game program objects later loaded can access the gaming data;
unload the first game program object from the memory; and load the second game program object to the memory so that the second game program object is accessible to the computer for execution.
11. The method of claim 10 wherein additional instruction are executed to cause the computing system to perform a task selected from the group consisting of a) executing a corresponding callback function upon alteration of the game data in the NV-RAM;
and b) managing events via a system handler application.
12. The method of claim 1 wherein the computer based wagering game application is developed for an apparatus comprising the gaming operating system stored in a memory storage component designed or configured to be operatively inserted along with game identity data into an electronic or electromechanical gaming device having ancillary functions so that the gaming device can effect play of the wagering game provided in the game identity data and the gaming operating system will control at least one ancillary function selected from the group consisting of coin acceptance, credit acceptance, currency acceptance and boot up.
13. The method of claim 12 wherein the API further comprises a plurality of APIs, and where the apparatus further comprises an operating system kernel customized for gaming purposes and an event queue.
14. The method of claim 12 wherein the gaming operating system controls access to a networked on-line system or controls a progressive meter.
15. The method of claim 12 wherein the gaming operating system comprises a kernel customized for gaming purposes utilizing a method of operation selected from the group consisting of: 1) accessing user level code from ROM, 2) executing from ROM, 3) zero out unused RAM, 4) test and/or hash the kernel, and 5) disabling selected device handlers.
16. A method wherein after compiling the gaming program specific to the gaming application that is compatible with the gaming operating system according to claim 1, 2, 3, 4 or 5, the gaming program manages data in the computer based wagering game apparatus via a system handler application, where managing data comprises:
loading a first game program object in the plurality of game program objects;
executing the first game program object; and accessing and storing game data related to the play of the wagering game in the NV-RAM.
17. The method of claim 16 wherein managing data further comprises a) unloading a first game program object, and loading a second game program object or b) executing a corresponding callback function upon alteration of the game data in the NV-RAM.
18. A gaming machine comprising:
a computerized game controller comprising a processor, an executable memory, and a non-volatile memory (NV-RAM);
a gaming application executed by the computerized game controller;
a gaming operating system executed by the computerized gaming controller operable 1) to load the gaming application and to generate a wagering game on the gaming machine in response to information received from the gaming application and 2) to maintain a set of gaming data variables in the NV-RAM
for reconstructing a state of the wagering game in response to a power loss or other malfunction on the computing system wherein the gaming operating system comprises a plurality of software gaming components, one or more Application Program Interfaces (APIs), associated with the plurality of software components, that define information recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system and plural gaming callback functions that allow the wagering game to be provided on the computing system, said plurality of software gaming components and gaming callback functions compatible with one or more of a plurality of different gaming devices, a plurality of different gaming applications or combinations thereof; wherein said plurality of software gaming components and gaming callback functions can be provided by a plurality of different software vendors; and 3) to determine a vendor associated with each of the plurality of software gaming components, the one or more APIs and gaming callback functions; 4) to determine whether each software component associated with the vendor is related to the presentation, the determination, or the storage of win-loss information for said wagering game; 5) to determine whether the vendor is licensed by a gaming regulatory authority to provide software components associated with the presentation, the determination or the storage of win-loss information for said wagering game based upon said determination of whether each software component associated with the vendor is related to the presentation, the determination or the storage of win-loss information for said wagering game; and the one or more APIs that define the information that it recognized by the gaming operating system and enable communication between the gaming application and the gaming operating system wherein the one or more APIs are designed or configured to allow the gaming operation to at least 1) access the NV-RAM wherein the NV-RAM is for at least storing the set of game data variables, 2) specify storage requirements for the NV-RAM including information related to the set of gaming data variables, 3) provide instructions related to outputting video data or audio data available with the gaming system, 4) provide instructions for peripheral devices recognized by the gaming operating system into formats recognized by the peripheral devices, 5) request one or more random number to be generated and 6) provide gaming application specific data used in the wagering game to the gaming operating system;
one or more value handling devices for inputting, outputting or combinations thereof, credits on the gaming machine wherein the credits are for wagers on the wagering game;
one or more input devices for providing input used to play the wagering game;
and a display device for displaying the wagering game on the gaming machine.
19. The gaming machine of claim 18, wherein the display device is one of mechanical reels or a video display.
20. The gaming machine of claim 18, wherein the plurality of software components are selected from the group consisting of random number generator, game initiation sequence, bonus module, video gaming module, audio gaming module, jackpot module, graphics conversion tool, debugging tool, pay-out table module, value-handling module, power-loss recover module, gaming payout history module, and user interaction module.
CA2460046A 2001-09-10 2002-09-10 Method for developing gaming programs compatible with a computerized gaming operating system and apparatus Expired - Fee Related CA2460046C (en)

Applications Claiming Priority (3)

Application Number Priority Date Filing Date Title
US31836901P 2001-09-10 2001-09-10
US60/318,369 2001-09-10
PCT/US2002/030286 WO2003023647A1 (en) 2001-09-10 2002-09-10 Method for developing gaming programs compatible with a computerized gaming operating system and apparatus

Publications (2)

Publication Number Publication Date
CA2460046A1 CA2460046A1 (en) 2003-03-20
CA2460046C true CA2460046C (en) 2014-06-10

Family

ID=23237889

Family Applications (1)

Application Number Title Priority Date Filing Date
CA2460046A Expired - Fee Related CA2460046C (en) 2001-09-10 2002-09-10 Method for developing gaming programs compatible with a computerized gaming operating system and apparatus

Country Status (5)

Country Link
US (1) US7618317B2 (en)
EP (1) EP1433078A4 (en)
CA (1) CA2460046C (en)
WO (1) WO2003023647A1 (en)
ZA (1) ZA200402744B (en)

Families Citing this family (168)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CA2419624A1 (en) * 1999-08-01 2001-02-08 Deep Video Imaging Limited Interactive three dimensional display with layered screens
US7724208B1 (en) 1999-08-19 2010-05-25 Puredepth Limited Control of depth movement for visual display with layered screens
EP1212744A4 (en) 1999-08-19 2006-06-14 Pure Depth Ltd Display method for multiple layered screens
WO2001015128A1 (en) 1999-08-19 2001-03-01 Deep Video Imaging Limited Data display for multiple layered screens
CA2402389A1 (en) * 2000-03-08 2002-09-19 Shuffle Master, Inc. Computerized gaming system, method and apparatus
US7043641B1 (en) * 2000-03-08 2006-05-09 Igt Encryption in a secure computerized gaming system
US7988559B2 (en) 2001-03-08 2011-08-02 Igt Computerized gaming system, method and apparatus
US7951002B1 (en) * 2000-06-16 2011-05-31 Igt Using a gaming machine as a server
AU8326401A (en) * 2000-08-18 2002-03-04 Int Game Tech Gaming machine virtual player tracking and related services
US9626824B2 (en) * 2000-10-11 2017-04-18 Igt Game result graphical verification on remote clients
US9251647B2 (en) * 2000-10-19 2016-02-02 Igt Remote configuration of gaming terminals
US7972214B2 (en) 2000-12-07 2011-07-05 Igt Methods and devices for downloading games of chance
NZ511444A (en) 2001-05-01 2004-01-30 Deep Video Imaging Ltd Information display
US7155710B2 (en) * 2001-06-08 2006-12-26 Igt Method and apparatus for gaming device software configuration
EP1401546A4 (en) 2001-06-15 2006-11-02 Walker Digital Llc Method and apparatus for planning and customizing a gaming experience
US20040054952A1 (en) * 2002-09-13 2004-03-18 Morrow James W. Device verification system and method
US7931533B2 (en) 2001-09-28 2011-04-26 Igt Game development architecture that decouples the game logic from the graphics logics
US7131909B2 (en) * 2002-09-10 2006-11-07 Igt Method and apparatus for managing gaming machine code downloads
US8708828B2 (en) * 2001-09-28 2014-04-29 Igt Pluggable modular gaming modifiers and configuration templates for gaming environments
US6902481B2 (en) 2001-09-28 2005-06-07 Igt Decoupling of the graphical presentation of a game from the presentation logic
US6997803B2 (en) 2002-03-12 2006-02-14 Igt Virtual gaming peripherals for a gaming machine
US8597116B2 (en) 2002-03-12 2013-12-03 Igt Virtual player tracking and related services
US8360838B2 (en) * 2006-07-03 2013-01-29 Igt Detecting and preventing bots and cheating in online gaming
US7637816B2 (en) * 2002-04-05 2009-12-29 Wms Gaming Inc. System and method for combining low-power signals and high-power signals on a single circuit board in a gaming machine
WO2003089084A1 (en) * 2002-04-19 2003-10-30 Walker Digital, Llc Managing features on a gaming device
US20030203755A1 (en) * 2002-04-25 2003-10-30 Shuffle Master, Inc. Encryption in a secure computerized gaming system
US7717791B2 (en) * 2002-06-05 2010-05-18 Igt Method for fault and/or disaster tolerant cashless gaming
EP1539493B1 (en) * 2002-07-09 2018-09-05 Futurelogic, Inc. Gaming machine printer
US20050109810A1 (en) * 2002-07-09 2005-05-26 Futurelogic, Inc. Gaming machine printer
US20040053699A1 (en) * 2002-09-12 2004-03-18 Rasmussen James M. Conversion of gaming machine between reel slots and video game
NZ521505A (en) 2002-09-20 2005-05-27 Deep Video Imaging Ltd Multi-view display
US7972206B2 (en) * 2002-11-20 2011-07-05 Wms Gaming Inc. Gaming machine and display device therefor
US20040106452A1 (en) * 2002-12-02 2004-06-03 Igt Hosted game development environment
US20040235563A1 (en) * 2003-02-26 2004-11-25 Blackburn Christopher W. Game update service in a service-oriented gaming network environment
US20100062844A1 (en) * 2003-03-05 2010-03-11 Bally Gaming, Inc. Authentication and validation systems for gaming devices
US20040242328A1 (en) * 2003-03-05 2004-12-02 Blackburn Christopher W. Boot service in a service-oriented gaming network environment
US8308567B2 (en) * 2003-03-05 2012-11-13 Wms Gaming Inc. Discovery service in a service-oriented gaming network environment
US8784195B1 (en) 2003-03-05 2014-07-22 Bally Gaming, Inc. Authentication system for gaming machines
US20040243848A1 (en) * 2003-03-06 2004-12-02 Blackburn Christopher W. Authentication service in a service-oriented gaming network environment
US20040243849A1 (en) * 2003-03-06 2004-12-02 Blackburn Christopher W. Authorization service in a service-oriented gaming network environment
US20040242331A1 (en) * 2003-03-17 2004-12-02 Blackburn Christopher W. Time service in a service-oriented gaming network environment
US8414397B2 (en) 2003-03-17 2013-04-09 Wms Gaming Inc. Gaming terminal network with a message director
US20040266532A1 (en) * 2003-03-27 2004-12-30 Blackburn Christopher W. Event management service in a service-oriented gaming network environment
US20040266533A1 (en) * 2003-04-16 2004-12-30 Gentles Thomas A Gaming software distribution network in a gaming system environment
US20040259640A1 (en) * 2003-04-16 2004-12-23 Gentles Thomas A. Layered security methods and apparatus in a gaming system environment
US20040266523A1 (en) * 2003-04-16 2004-12-30 Gentles Thomas A Secured networks in a gaming system environment
CA2464797A1 (en) * 2003-04-16 2004-10-16 Wms Gaming Inc. Remote authentication of gaming software in a gaming system environment
NZ525956A (en) 2003-05-16 2005-10-28 Deep Video Imaging Ltd Display control system for use with multi-layer displays
US20050227768A1 (en) * 2003-05-27 2005-10-13 Blackburn Christopher W Gaming network environment having a language translation service
US6964609B2 (en) 2003-05-28 2005-11-15 Igt Gaming device having alternate outcome presentations
US7794323B2 (en) * 2003-07-25 2010-09-14 Igt Gaming apparatus with encryption and method
WO2005038555A2 (en) * 2003-09-12 2005-04-28 Aristocrat Technologies Australia Pty Ltd Communications interface for a gaming machine
US8512144B2 (en) 2003-10-20 2013-08-20 Tipping Point Group, Llc Method and apparatus for providing secondary gaming machine functionality
US9564004B2 (en) 2003-10-20 2017-02-07 Igt Closed-loop system for providing additional event participation to electronic video game customers
US20070155469A1 (en) * 2003-10-20 2007-07-05 Sam Johnson Automatic funding of paragames on electronic gaming platform
US7641555B2 (en) * 2004-03-04 2010-01-05 Wms Gaming Inc. Method and apparatus for automated configuration of gaming machine operating parameters
WO2005110565A2 (en) * 2004-05-07 2005-11-24 Wms Gaming Inc. Protecting a gaming machine from rogue code
WO2006002084A1 (en) * 2004-06-15 2006-01-05 Wms Gaming Inc. Gaming software providing operating system independence
US7856395B2 (en) * 2004-08-10 2010-12-21 Microtick, Llc Short-term option trading system
US7828656B2 (en) * 2004-08-31 2010-11-09 Igt Gaming method and apparatus utilizing secondary software applications
US7610462B2 (en) * 2004-09-16 2009-10-27 Wms Gaming Inc. Gaming machine with secure fault-tolerant memory
WO2006052212A1 (en) * 2004-11-12 2006-05-18 Acei Ab Game interruption and reconnection management
US9697673B2 (en) 2004-11-12 2017-07-04 Henrik Kniberg Gaming interruption and reconnection management
US9613491B2 (en) 2004-12-16 2017-04-04 Igt Video gaming device having a system and method for completing wagers and purchases during the cash out process
US7806762B2 (en) * 2005-03-09 2010-10-05 Multimedia Games, Inc. Bingo prize mapping system with prize promotion
US7722468B2 (en) * 2005-03-09 2010-05-25 Igt Magnetoresistive memory units as read only memory devices in gaming machines
US7736234B2 (en) * 2005-03-09 2010-06-15 Igt MRAM as critical event storage for powered down gaming machines
US20060205513A1 (en) * 2005-03-09 2006-09-14 Igt MRAM as nonvolatile safe storage for power hit and ESD tolerance in gaming machines
US20060247057A1 (en) * 2005-04-28 2006-11-02 Green Anthony E Logic Interface Engine System and Method
US7887420B2 (en) 2005-09-12 2011-02-15 Igt Method and system for instant-on game download
US8287379B2 (en) 2005-09-12 2012-10-16 Igt Distributed game services
US7736231B2 (en) * 2005-10-03 2010-06-15 Microsoft Corporation Common controller
JP2007136072A (en) * 2005-11-22 2007-06-07 Aruze Corp Data converter for game machine and credit management system
US20080293499A1 (en) * 2005-12-02 2008-11-27 Christopher Brewer Gaming System Peripherals With Automatic System Configuration
WO2007092608A2 (en) * 2006-02-09 2007-08-16 Wms Gaming Inc. Wagering game server availability broadcast message system
WO2007095368A2 (en) * 2006-02-14 2007-08-23 Wms Gaming Inc. Reorganizing a wagering game machine's nvram
US7967682B2 (en) 2006-04-12 2011-06-28 Bally Gaming, Inc. Wireless gaming environment
US8512139B2 (en) * 2006-04-13 2013-08-20 Igt Multi-layer display 3D server based portals
US8968077B2 (en) 2006-04-13 2015-03-03 Idt Methods and systems for interfacing with a third-party application
US8784196B2 (en) 2006-04-13 2014-07-22 Igt Remote content management and resource sharing on a gaming machine and method of implementing same
US8992304B2 (en) 2006-04-13 2015-03-31 Igt Methods and systems for tracking an event of an externally controlled interface
US10026255B2 (en) 2006-04-13 2018-07-17 Igt Presentation of remotely-hosted and locally rendered content for gaming systems
US8777737B2 (en) * 2006-04-13 2014-07-15 Igt Method and apparatus for integrating remotely-hosted and locally rendered content on a gaming device
US9028329B2 (en) 2006-04-13 2015-05-12 Igt Integrating remotely-hosted and locally rendered content on a gaming device
US8100753B2 (en) 2006-05-23 2012-01-24 Bally Gaming, Inc. Systems, methods and articles to facilitate playing card games with selectable odds
US8052519B2 (en) 2006-06-08 2011-11-08 Bally Gaming, Inc. Systems, methods and articles to facilitate lockout of selectable odds/advantage in playing card games
US20080004097A1 (en) * 2006-06-30 2008-01-03 Igt Gaming device with customizable template for advertising display
WO2008021079A2 (en) 2006-08-08 2008-02-21 Wms Gaming Inc. Configurable wagering game manager
AU2007205809B2 (en) 2006-08-17 2012-05-17 Bally Gaming, Inc. Systems, methods and articles to enhance play at gaming tables with bonuses
US7963839B2 (en) * 2006-09-19 2011-06-21 Mudalla Technology, Inc. Regulated gaming exchange
US20090249492A1 (en) * 2006-09-21 2009-10-01 Hans Martin Boesgaard Sorensen Fabrication of computer executable program files from source code
US9101820B2 (en) 2006-11-09 2015-08-11 Bally Gaming, Inc. System, method and apparatus to produce decks for and operate games played with playing cards
US8920233B2 (en) 2006-11-10 2014-12-30 Bally Gaming, Inc. Assignment template and assignment bundle in a gaming configuration and download system
US8631501B2 (en) 2006-11-10 2014-01-14 Bally Gaming, Inc. Reporting function in gaming system environment
US9275512B2 (en) 2006-11-10 2016-03-01 Bally Gaming, Inc. Secure communications in gaming system
US20090156303A1 (en) * 2006-11-10 2009-06-18 Igt Bonusing Architectures in a Gaming Environment
US8784212B2 (en) 2006-11-10 2014-07-22 Bally Gaming, Inc. Networked gaming environment employing different classes of gaming machines
US9311774B2 (en) * 2006-11-10 2016-04-12 Igt Gaming machine with externally controlled content display
US9111078B2 (en) 2006-11-10 2015-08-18 Bally Gaming, Inc. Package manager service in gaming system
US9082258B2 (en) 2006-11-13 2015-07-14 Bally Gaming, Inc. Method and system for providing download and configuration job progress tracking and display via host user interface
US8930461B2 (en) * 2006-11-13 2015-01-06 Bally Gaming, Inc. Download and configuration management engine for gaming system
US8347280B2 (en) 2006-11-13 2013-01-01 Bally Gaming, Inc. System and method for validating download or configuration assignment for an EGM or EGM collection
US8628416B2 (en) * 2007-03-28 2014-01-14 Igt Device embedded in gaming machine handle
US7949998B2 (en) * 2007-04-20 2011-05-24 Microsoft Corporation Programming framework for closed systems
US8330764B2 (en) * 2007-04-20 2012-12-11 Microsoft Corporation Programming framework for closed systems
AU2008245444B9 (en) 2007-04-30 2013-11-14 Acres Technology Gaming device with personality
US8523666B2 (en) * 2007-05-25 2013-09-03 Microsoft Corporation Programming framework for closed systems
WO2008156809A1 (en) * 2007-06-19 2008-12-24 Wms Gaming Inc. Plug-in architecture for a wagering game network
US8308554B2 (en) * 2007-06-22 2012-11-13 Igt Prize redemption kiosk
US9454384B2 (en) * 2007-07-05 2016-09-27 Microsoft Technology Licensing, Llc Custom operating system via a web-service
US20090118006A1 (en) 2007-11-02 2009-05-07 Bally Gaming, Inc. Game related systems, methods, and articles that combine virtual and physical elements
US8721458B2 (en) * 2007-11-09 2014-05-13 Wms Gaming Inc. NVRAM management in a wagering game machine
US8616958B2 (en) 2007-11-12 2013-12-31 Bally Gaming, Inc. Discovery method and system for dynamically locating networked gaming components and resources
US8721431B2 (en) 2008-04-30 2014-05-13 Bally Gaming, Inc. Systems, methods, and devices for providing instances of a secondary game
US9092944B2 (en) 2008-04-30 2015-07-28 Bally Gaming, Inc. Coordinating group play events for multiple game devices
US9005034B2 (en) 2008-04-30 2015-04-14 Bally Gaming, Inc. Systems and methods for out-of-band gaming machine management
US8856657B2 (en) 2008-04-30 2014-10-07 Bally Gaming, Inc. User interface for managing network download and configuration tasks
US8251803B2 (en) 2008-04-30 2012-08-28 Bally Gaming, Inc. Overlapping progressive jackpots
US8613655B2 (en) 2008-04-30 2013-12-24 Bally Gaming, Inc. Facilitating group play with multiple game devices
US9483911B2 (en) 2008-04-30 2016-11-01 Bally Gaming, Inc. Information distribution in gaming networks
AU2009201551A1 (en) * 2008-05-02 2009-11-19 Aristocrat Technologies Australia Pty Limited A gaming system and a method of monitoring a gaming device
US8382584B2 (en) 2008-05-24 2013-02-26 Bally Gaming, Inc. Networked gaming system with enterprise accounting methods and apparatus
WO2009155047A2 (en) 2008-05-30 2009-12-23 Bally Gaming, Inc. Web pages for gaming devices
US20090312094A1 (en) * 2008-05-30 2009-12-17 Igt Methods and apparatus for secured transaction logging
US8578338B2 (en) 2008-06-02 2013-11-05 Igt Game production and regulatory approval systems
US8412768B2 (en) * 2008-07-11 2013-04-02 Ball Gaming, Inc. Integration gateway
WO2010031041A2 (en) * 2008-09-15 2010-03-18 Mattel, Inc. Video game system with safety assembly and method of play
AU2009222627B2 (en) 2008-10-09 2011-07-21 Aristocrat Technologies Australia Pty Limited Gaming system and gaming system processor module
US11287939B2 (en) 2008-10-09 2022-03-29 Aristocrat Technologies Australia Pty Limited Gaming system and gaming system processor module
US11385758B2 (en) 2008-10-09 2022-07-12 Aristocrat Technologies Australia Pty Limited Gaming system and gaming system processor module
US10235832B2 (en) 2008-10-17 2019-03-19 Igt Post certification metering for diverse game machines
WO2010057056A1 (en) 2008-11-14 2010-05-20 Wms Gaming, Inc. Dynamic skinning of wagering games
US8266213B2 (en) 2008-11-14 2012-09-11 Bally Gaming, Inc. Apparatus, method, and system to provide a multiple processor architecture for server-based gaming
US8347303B2 (en) 2008-11-14 2013-01-01 Bally Gaming, Inc. Apparatus, method, and system to provide a multi-core processor for an electronic gaming machine (EGM)
US8423790B2 (en) 2008-11-18 2013-04-16 Bally Gaming, Inc. Module validation
US20100160039A1 (en) * 2008-12-18 2010-06-24 Microsoft Corporation Object model and api for game creation
US20100227660A1 (en) * 2009-03-09 2010-09-09 Yoshio Nakano Horse video poker apparatus
US8616978B2 (en) 2009-09-01 2013-12-31 Wms Gaming, Inc Managing wagering game applications and events
US8747228B2 (en) * 2009-10-16 2014-06-10 Nathalie Beaudoin Intermediary module for gaming systems
US8568227B2 (en) * 2009-11-13 2013-10-29 Bally Gaming, Inc. Video extension library system and method
US8747216B2 (en) * 2010-03-10 2014-06-10 Isi, Ltd Sportsbook room and method therefor
EP2577627A1 (en) * 2010-05-27 2013-04-10 Gary Shaw Systems, methods, apparatus and computer-readable mediums for on-line gaming
US20130296021A1 (en) * 2010-12-06 2013-11-07 Mercury And Associates Structure Ii, Llc Enhanced slot-machine for casino applications
AU2012202162B2 (en) 2011-04-18 2014-08-28 Wms Gaming, Inc. Dynamic updating of content based on gaming-application context
US9058716B2 (en) 2011-06-06 2015-06-16 Bally Gaming, Inc. Remote game play in a wireless gaming environment
US9466173B2 (en) 2011-09-30 2016-10-11 Igt System and method for remote rendering of content on an electronic gaming machine
US9524609B2 (en) 2011-09-30 2016-12-20 Igt Gaming system, gaming device and method for utilizing mobile devices at a gaming establishment
US9120007B2 (en) 2012-01-18 2015-09-01 Bally Gaming, Inc. Network gaming architecture, gaming systems, and related methods
US8974305B2 (en) 2012-01-18 2015-03-10 Bally Gaming, Inc. Network gaming architecture, gaming systems, and related methods
US20130217483A1 (en) * 2012-02-17 2013-08-22 Incredible Technologies, Inc. System and method for providing customizing software modules to secure electronic game machines
US9293008B2 (en) 2012-03-16 2016-03-22 Bally Gaming, Inc. Layout elements as rendering placeholders for native wagering game applications
US20130267312A1 (en) * 2012-04-06 2013-10-10 Wms Gaming, Inc. Ordered loading of wagering game assets into memory
US9224260B2 (en) 2012-04-12 2015-12-29 Patent Investment & Licensing Company Method of apparatus for communicating information about networked gaming machines to prospective players
US9129469B2 (en) 2012-09-11 2015-09-08 Igt Player driven game download to a gaming machine
US9547957B2 (en) * 2012-10-11 2017-01-17 Scientific Games International, Inc. System and method for implementing internet-based games wherein a plurality of different games share a common prize structure
US20140370989A1 (en) 2013-06-13 2014-12-18 Patent Investment & Licensing Company System to facilitate communication with casino employees and players and to log data related to employee work
US20170186270A1 (en) 2013-08-06 2017-06-29 Patent Investment & Licensing Company Method and system for dispatching casino personnel and tracking interactions with players
US9087431B2 (en) 2013-08-06 2015-07-21 Patent Investment & Licensing Company Method for creating an electronic log for documenting entries into gaming machines
US9792778B2 (en) 2013-09-26 2017-10-17 Bally Gaming, Inc. Bundling assets for mobile devices
US9916735B2 (en) 2015-07-22 2018-03-13 Igt Remote gaming cash voucher printing system
US10055930B2 (en) 2015-08-11 2018-08-21 Igt Gaming system and method for placing and redeeming sports bets
US10453298B2 (en) * 2015-10-08 2019-10-22 Igt Global Solutions Corporation System, apparatus and method for implementing game changes in a gaming platform
CN110597713B (en) * 2019-08-28 2023-05-16 上海御渡半导体科技有限公司 Hard disk expansion device of testing machine and program writing and testing method thereof
NL2026302B1 (en) * 2020-08-20 2022-04-14 Hendro Yuniko Setiowaty Johannes String handler and method for handling strings useable for games
WO2022104033A1 (en) * 2020-11-12 2022-05-19 Adrenalineip Method of managing wager micro-markets with artificial intelligence using human traders
US11839812B2 (en) 2020-11-19 2023-12-12 Jeremy McIntosh Online gaming platform systems, methods, and apparatus
CN113162863B (en) * 2021-04-12 2022-08-02 河南科技大学 Fair multipath routing method based on wheel disc algorithm
US11816356B2 (en) 2021-07-06 2023-11-14 Pure Storage, Inc. Container orchestrator-aware storage system

Family Cites Families (172)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
US2235642A (en) 1937-04-03 1941-03-18 Evans Prod Co Vehicle ventilating and heating apparatus
US3838264A (en) 1970-11-25 1974-09-24 P Maker Apparatus for, and method of, checking the contents of a computer store
US3931504A (en) 1972-02-07 1976-01-06 Basic Computing Arts, Inc. Electronic data processing security system and method
US3825905A (en) 1972-09-13 1974-07-23 Action Communication Syst Inc Binary synchronous communications processor system and method
GB1512857A (en) 1974-09-13 1978-06-01 Bally Mfg Corp Monitoring system for use with amusement game devices
US4200770A (en) 1977-09-06 1980-04-29 Stanford University Cryptographic apparatus and method
US4218582A (en) 1977-10-06 1980-08-19 The Board Of Trustees Of The Leland Stanford Junior University Public key cryptographic apparatus and method
US4193131A (en) 1977-12-05 1980-03-11 International Business Machines Corporation Cryptographic verification of operational keys used in communication networks
US4405829A (en) 1977-12-14 1983-09-20 Massachusetts Institute Of Technology Cryptographic communications system and method
DE2913999C2 (en) 1979-04-06 1983-01-20 Siemens AG, 1000 Berlin und 8000 München Device for testing system programs of numerical controls for machine tools
US4250563A (en) 1979-08-09 1981-02-10 Allen-Bradley Company Expandable programmable controller
DE2939461C2 (en) 1979-09-28 1989-07-20 Siemens AG, 1000 Berlin und 8000 München Method for determining data disturbances in memories
US4293928A (en) 1979-12-14 1981-10-06 Burroughs Corporation Peripheral dependent circuit for peripheral controller
US4467424A (en) 1979-12-17 1984-08-21 Hedges Richard A Remote gaming system
US4454594A (en) 1981-11-25 1984-06-12 U.S. Philips Corporation Method and apparatus to secure proprietary operation of computer equipment
US4430728A (en) 1981-12-29 1984-02-07 Marathon Oil Company Computer terminal security system
US4458315A (en) 1982-02-25 1984-07-03 Penta, Inc. Apparatus and method for preventing unauthorized use of computer programs
US4500933A (en) 1982-04-02 1985-02-19 Ampex Corporation Universal interface unit
US4525599A (en) 1982-05-21 1985-06-25 General Computer Corporation Software protection methods and apparatus
US4462076A (en) 1982-06-04 1984-07-24 Smith Engineering Video game cartridge recognition and security system
US4519077A (en) 1982-08-30 1985-05-21 Amin Pravin T Digital processing system with self-test capability
US4658093A (en) 1983-07-11 1987-04-14 Hellman Martin E Software distribution system
US4759064A (en) 1985-10-07 1988-07-19 Chaum David L Blind unanticipated signature systems
US4494114B1 (en) 1983-12-05 1996-10-15 Int Electronic Tech Security arrangement for and method of rendering microprocessor-controlled electronic equipment inoperative after occurrence of disabling event
US4582324A (en) 1984-01-04 1986-04-15 Bally Manufacturing Corporation Illusion of skill game machine for a gaming system
US4652998A (en) 1984-01-04 1987-03-24 Bally Manufacturing Corporation Video gaming system with pool prize structures
US4837728A (en) 1984-01-25 1989-06-06 Igt Multiple progressive gaming system that freezes payouts at start of game
US4683550A (en) 1984-07-30 1987-07-28 Burr-Brown Corporation Personal computer instrumentation system including carrier board having bus-oriented plug-in instrumentation modules
US4845715A (en) 1984-10-29 1989-07-04 Francisco Michael H Method for maintaining data processing system securing
AU571119B2 (en) 1984-12-13 1988-03-31 Ainsworth Nominees Pty Ltd A poker machine with improved security after power failure
US4911449A (en) 1985-01-02 1990-03-27 I G T Reel monitoring device for an amusement machine
JPH074449B2 (en) 1985-10-04 1995-01-25 任天堂株式会社 Cartridge for game machine and game machine using the same
US4752068A (en) 1985-11-07 1988-06-21 Namco Ltd. Video game machine for business use
DE3601813A1 (en) 1986-01-22 1987-07-23 Eduard Steininger VIDEO MACHINE
US4856787B1 (en) 1986-02-05 1997-09-23 Fortunet Inc Concurrent game network
US4926255A (en) 1986-03-10 1990-05-15 Kohorn H Von System for evaluation of response to broadcast transmissions
US4757505A (en) 1986-04-30 1988-07-12 Elgar Electronics Corp. Computer power system
US4727544A (en) 1986-06-05 1988-02-23 Bally Manufacturing Corporation Memory integrity checking system for a gaming device
US5155680A (en) 1986-10-24 1992-10-13 Signal Security Technologies Billing system for computing software
US4817140A (en) 1986-11-05 1989-03-28 International Business Machines Corp. Software protection system using a single-key cryptosystem, a hardware-based authorization system and a secure coprocessor
US5146575A (en) 1986-11-05 1992-09-08 International Business Machines Corp. Implementing privilege on microprocessor systems for use in software asset protection
CA1258912A (en) 1986-11-20 1989-08-29 Stephen J. King Interactive real-time video processor with zoom, pan and scroll capability
US5224160A (en) 1987-02-23 1993-06-29 Siemens Nixdorf Informationssysteme Ag Process for securing and for checking the integrity of the secured programs
US4930073A (en) 1987-06-26 1990-05-29 International Business Machines Corporation Method to prevent use of incorrect program version in a computer system
US4972470A (en) 1987-08-06 1990-11-20 Steven Farago Programmable connector
US4862355A (en) 1987-08-13 1989-08-29 Digital Equipment Corporation System permitting peripheral interchangeability during system operation
US5237688A (en) 1987-11-18 1993-08-17 International Business Machines Corporation Software packaging structure having hierarchical replaceable units
US4944008A (en) 1988-02-18 1990-07-24 Motorola, Inc. Electronic keying scheme for locking data
DE68922847T2 (en) 1988-07-13 1996-02-08 Matsushita Electric Ind Co Ltd TRANSFER DEVICE.
EP0356538B1 (en) 1988-08-27 1993-12-22 International Business Machines Corporation Arrangement in data processing system for system initialization and reset
US5179517A (en) 1988-09-22 1993-01-12 Bally Manufacturing Corporation Game machine data transfer system utilizing portable data units
JPH0290330A (en) 1988-09-28 1990-03-29 Hitachi Ltd Program constitution system
US4951149A (en) 1988-10-27 1990-08-21 Faroudja Y C Television system with variable aspect picture ratio
US5400246A (en) 1989-05-09 1995-03-21 Ansan Industries, Ltd. Peripheral data acquisition, monitor, and adaptive control system via personal computer
EP0419064A3 (en) 1989-09-22 1992-08-05 International Business Machines Corporation Computer system having apparatus for providing pointing device independent support in an operating environment
US5004232A (en) 1989-10-13 1991-04-02 Macronix, Inc. Computer game cartridge security circuit
FR2653578B1 (en) 1989-10-24 1992-01-17 Adventure ELECTRONIC PORTABLE DEVICE FOR LOYALIZING A PUBLIC TO A MEDIA OR THE LIKE.
JP2560124B2 (en) 1990-03-16 1996-12-04 株式会社セガ・エンタープライゼス Video game system and information processing device
US5103081A (en) 1990-05-23 1992-04-07 Games Of Nevada Apparatus and method for reading data encoded on circular objects, such as gaming chips
US5050212A (en) 1990-06-20 1991-09-17 Apple Computer, Inc. Method and apparatus for verifying the integrity of a file stored separately from a computer
US5161193A (en) 1990-06-29 1992-11-03 Digital Equipment Corporation Pipelined cryptography processor and method for its use in communication networks
JPH04143881A (en) 1990-10-05 1992-05-18 Toshiba Corp Mutual authenticating system
US5594903A (en) * 1991-02-26 1997-01-14 Lynx Real-Time Systems, Inc. Operating System architecture with reserved memory space resident program code identified in file system name space
US5444642A (en) 1991-05-07 1995-08-22 General Signal Corporation Computer system for monitoring events and which is capable of automatically configuring itself responsive to changes in system hardware
US5469571A (en) * 1991-07-15 1995-11-21 Lynx Real-Time Systems, Inc. Operating system architecture using multiple priority light weight kernel task based interrupt handling
US5291585A (en) 1991-07-29 1994-03-01 Dell Usa, L.P. Computer system having system feature extension software containing a self-describing feature table for accessing I/O devices according to machine-independent format
US5429361A (en) 1991-09-23 1995-07-04 Bally Gaming International, Inc. Gaming machine information, communication and display system
JPH0736175B2 (en) 1991-10-11 1995-04-19 インターナショナル・ビジネス・マシーンズ・コーポレイション System configuration setting method of data processing system, data processing system, and expansion unit for data processing system
US5264958A (en) 1991-11-12 1993-11-23 International Business Machines Corp. Universal communications interface adaptable for a plurality of interface standards
US5394547A (en) 1991-12-24 1995-02-28 International Business Machines Corporation Data processing system and method having selectable scheduler
US5326104A (en) 1992-02-07 1994-07-05 Igt Secure automated electronic casino gaming system
US5259613A (en) 1992-04-08 1993-11-09 Rio Hotel Casino, Inc. Casino entertainment system
US5342047A (en) 1992-04-08 1994-08-30 Bally Gaming International, Inc. Touch screen video gaming machine
US5421006A (en) 1992-05-07 1995-05-30 Compaq Computer Corp. Method and apparatus for assessing integrity of computer system software
DE69330691T2 (en) 1992-06-03 2002-07-04 Sun Microsystems Inc Dynamically configurable core system
WO1993025412A1 (en) 1992-06-10 1993-12-23 Ford Motor Company Limited A communication system for motor vehicles
US5428525A (en) 1992-07-01 1995-06-27 Cappelaere; Patrice G. Computer system and method for signal control prioritizing and scheduling
US5489095A (en) 1992-07-01 1996-02-06 U.S. Philips Corporation Device for protecting the validity of time sensitive information
US5235642A (en) 1992-07-21 1993-08-10 Digital Equipment Corporation Access control subsystem and method for distributed computer system using locally cached authentication credentials
US5655965A (en) 1992-10-22 1997-08-12 Kabushiki Kaisha Ace Denken Screen display type slot machine with seemingly flowing condition of moving symbols
FR2697653B1 (en) 1992-11-04 1995-01-20 Info Telecom Electronic game of chance device.
US5375241A (en) 1992-12-21 1994-12-20 Microsoft Corporation Method and system for dynamic-link library
US5548782A (en) 1993-05-07 1996-08-20 National Semiconductor Corporation Apparatus for preventing transferring of data with peripheral device for period of time in response to connection or disconnection of the device with the apparatus
ZA943336B (en) 1993-05-19 1995-08-11 Menashe Julian Interactive computerised gaming system with remote terminals
US5398799A (en) 1993-06-03 1995-03-21 Maxtrol Corp. Method and apparatus for converting single price vending machines to multiple price vending machines
US5343527A (en) 1993-10-27 1994-08-30 International Business Machines Corporation Hybrid encryption method and system for protecting reusable software components
US5473785A (en) 1993-10-29 1995-12-12 Lager; Bengt G. Traveling collapsible toddler bed
GB2283341A (en) * 1993-10-29 1995-05-03 Sophos Plc Central virus checker for computer network.
US5379431A (en) 1993-12-21 1995-01-03 Taligent, Inc. Boot framework architecture for dynamic staged initial program load
US5398932A (en) 1993-12-21 1995-03-21 Video Lottery Technologies, Inc. Video lottery system with improved site controller and validation unit
US5473765A (en) 1994-01-24 1995-12-05 3Com Corporation Apparatus for using flash memory as a floppy disk emulator in a computer system
JP3653709B2 (en) 1994-02-28 2005-06-02 株式会社セガ Data security device
RU95103479A (en) * 1994-03-11 1996-12-27 Уолкер Эссет Мэнеджмент Лимитед Партнершип (US) Game system, game computer, method for playing or drawing lottery when player participates in it
US5488702A (en) 1994-04-26 1996-01-30 Unisys Corporation Data block check sequence generation and validation in a file cache system
US5586766A (en) 1994-05-13 1996-12-24 Casinovations, Inc. Blackjack game system and methods
US6035321A (en) * 1994-06-29 2000-03-07 Acis, Inc. Method for enforcing a hierarchical invocation structure in real time asynchronous software applications
EP0693795B1 (en) * 1994-07-22 1999-03-17 Berg Electronics Manufacturing B.V. Selectively metallizized connector with at least one coaxial or twinaxial terminal
US20010003709A1 (en) * 1994-09-23 2001-06-14 William Adams Method of playing game and gaming games with an additional payout indicator
US5542669A (en) 1994-09-23 1996-08-06 Universal Distributing Of Nevada, Inc. Method and apparatus for randomly increasing the payback in a video gaming apparatus
JPH08212086A (en) * 1994-09-30 1996-08-20 Microsoft Corp System and method for operating of office machine
US5655961A (en) * 1994-10-12 1997-08-12 Acres Gaming, Inc. Method for operating networked gaming devices
US5664187A (en) * 1994-10-26 1997-09-02 Hewlett-Packard Company Method and system for selecting data for migration in a hierarchic data storage system using frequency distribution tables
US5568602A (en) 1994-10-28 1996-10-22 Rocket Science Games, Inc. Method and apparatus for game development using correlation of time sequences and digital video data
US5442568A (en) 1994-11-15 1995-08-15 Audit Systems Company Vending machine audit monitoring system
US5644704A (en) 1994-11-30 1997-07-01 International Game Technology Method and apparatus for verifying the contents of a storage device
US5707286A (en) * 1994-12-19 1998-01-13 Mikohn Gaming Corporation Universal gaming engine
US6272223B1 (en) * 1997-10-28 2001-08-07 Rolf Carlson System for supplying screened random numbers for use in recreational gaming in a casino or over the internet
DE69500346T2 (en) * 1995-01-23 1997-12-11 Ibm Improved memory self-check
US5604801A (en) 1995-02-03 1997-02-18 International Business Machines Corporation Public key data communications system under control of a portable security device
US5725428A (en) * 1995-03-09 1998-03-10 Atronic Casino Technology Distribution Gmbh Video slot machine
US5611730A (en) 1995-04-25 1997-03-18 Casino Data Systems Progressive gaming system tailored for use in multiple remote sites: apparatus and method
US5737418A (en) * 1995-05-30 1998-04-07 International Game Technology Encryption of bill validation data
US5643086A (en) * 1995-06-29 1997-07-01 Silicon Gaming, Inc. Electronic casino gaming apparatus with improved play capacity, authentication and security
US7063615B2 (en) * 1995-06-29 2006-06-20 Igt Electronic gaming apparatus with authentication
US5575717A (en) 1995-08-18 1996-11-19 Merit Industries, Inc. System for creating menu choices of video games on a display
US5870757A (en) * 1995-09-11 1999-02-09 Sun Microsystems, Inc. Single transaction technique for a journaling file system of a computer operating system
US5872973A (en) * 1995-10-26 1999-02-16 Viewsoft, Inc. Method for managing dynamic relations between objects in dynamic object-oriented languages
US5704835A (en) * 1995-12-13 1998-01-06 Infinity Group, Inc. Electronic second spin slot machine
US5835594A (en) * 1996-02-09 1998-11-10 Intel Corporation Methods and apparatus for preventing unauthorized write access to a protected non-volatile storage
US5870587A (en) * 1996-03-20 1999-02-09 International Business Machines Corporation Information-handling system, method, and article of manufacture including a mechanism for providing an improved application binary interface
US6015344A (en) * 1996-04-05 2000-01-18 Rlt Acquisition, Inc. Prize redemption system for games
US6181336B1 (en) * 1996-05-31 2001-01-30 Silicon Graphics, Inc. Database-independent, scalable, object-oriented architecture and API for managing digital multimedia assets
US5871400A (en) * 1996-06-18 1999-02-16 Silicon Gaming, Inc. Random number generator for electronic applications
CA2259354C (en) * 1996-06-28 2004-06-22 Silicon Gaming, Inc. Improved electronic gaming apparatus
JP3790307B2 (en) * 1996-10-16 2006-06-28 株式会社ルネサステクノロジ Data processor and data processing system
US5889990A (en) * 1996-11-05 1999-03-30 Sun Microsystems, Inc. Information appliance software architecture with replaceable service module providing abstraction function between system library and platform specific OS
US6052778A (en) * 1997-01-13 2000-04-18 International Business Machines Corporation Embedded system having dynamically linked dynamic loader and method for linking dynamic loader shared libraries and application programs
US6073124A (en) * 1997-01-29 2000-06-06 Shopnow.Com Inc. Method and system for securely incorporating electronic information into an online purchasing application
US6039648A (en) * 1997-03-04 2000-03-21 Casino Data Systems Automated tournament gaming system: apparatus and method
EP0864951B1 (en) * 1997-03-12 2001-06-13 Rittal-Werk Rudolf Loh GmbH & Co. KG Switchgear cabinet with a central control system for monitoring and control of integrated and/or separate units
FR2762118B1 (en) * 1997-04-11 1999-07-16 Gemplus Card Int SECURE PROCEDURE FOR CONTROLLING TRANSFER OF VALUE UNITS IN A CHIP CARD GAME SYSTEM
US6102796A (en) * 1997-04-21 2000-08-15 Microsoft Corporation System and method for composing an image with fragments
US5893121A (en) * 1997-04-23 1999-04-06 Sun Microsystems, Inc. System and method for swapping blocks of tagged stack entries between a tagged stack cache and an untagged main memory storage
US6071190A (en) * 1997-05-21 2000-06-06 Casino Data Systems Gaming device security system: apparatus and method
US6215495B1 (en) * 1997-05-30 2001-04-10 Silicon Graphics, Inc. Platform independent application program interface for interactive 3D scene management
US6014714A (en) * 1997-06-16 2000-01-11 International Business Machines Corporation Adapter card system including for supporting multiple configurations using mapping bit
US6039645A (en) * 1997-06-24 2000-03-21 Cummins-Allison Corp. Software loading system for a coin sorter
US6203427B1 (en) * 1997-07-03 2001-03-20 Walker Digital, Llc Method and apparatus for securing a computer-based game of chance
JP3526215B2 (en) * 1997-07-03 2004-05-10 大日本印刷株式会社 Phase mask for optical fiber processing and method of manufacturing the same
US6026238A (en) * 1997-08-18 2000-02-15 Microsoft Corporatrion Interface conversion modules based upon generalized templates for multiple platform computer systems
AUPO910297A0 (en) * 1997-09-10 1997-10-02 Aristocrat Leisure Industries Pty Ltd Slot machine game - progressive jackpot with decrementing jackpot
US20010010046A1 (en) * 1997-09-11 2001-07-26 Muyres Matthew R. Client content management and distribution system
US6075939A (en) * 1997-09-27 2000-06-13 Lynx Real-Trime Systems, Inc. Tightly coupled, scalable module based micro-kernel operating system architecture
US5879234A (en) * 1997-10-01 1999-03-09 Universal De Desarrollos Electronicos, S.A. (Unidesa) Security system for reel type slot machine with physical mapping to control the win odds
US6185678B1 (en) * 1997-10-02 2001-02-06 Trustees Of The University Of Pennsylvania Secure and reliable bootstrap architecture
US6144888A (en) * 1997-11-10 2000-11-07 Maya Design Group Modular system and architecture for device control
US5863041A (en) * 1997-12-11 1999-01-26 Bet Technology, Inc. Pai gow poker with auxiliary game
AUPP149998A0 (en) * 1998-01-27 1998-02-19 Aristocrat Leisure Industries Pty Ltd Multi-platform gaming architecture
US6044428A (en) * 1998-03-17 2000-03-28 Fairchild Semiconductor Corporation Configurable universal serial bus node
US6243692B1 (en) * 1998-05-22 2001-06-05 Preview Software Secure electronic software packaging using setup-external unlocking module
US6044471A (en) * 1998-06-04 2000-03-28 Z4 Technologies, Inc. Method and apparatus for securing software to reduce unauthorized use
US6379246B1 (en) * 1998-08-03 2002-04-30 Stanley P. Dabrowski Method and apparatus for modifying gaming machines to provide supplemental or modified functionality
US6257638B1 (en) * 1998-09-16 2001-07-10 K-Z, Inc. Travel trailer with rear wall slide-out room
US6222529B1 (en) * 1999-05-05 2001-04-24 Shareware, Inc. Method and apparatus for providing multiple sessions on a single user operating system
EP1221080A2 (en) * 1999-06-03 2002-07-10 Anchor Gaming Method and device for implementing a downloadable software delivery system
US6935946B2 (en) * 1999-09-24 2005-08-30 Igt Video gaming apparatus for wagering with universal computerized controller and I/O interface for unique architecture
US6866581B2 (en) * 1999-09-24 2005-03-15 Igt Video gaming apparatus for wagering with universal computerized controller and I/O interface for unique architecture
US6368219B1 (en) * 1999-10-15 2002-04-09 Gtech Rhode Island Corporation System and method for determining whether wagers have been altered after winning game numbers are drawn
WO2001065358A2 (en) * 2000-02-17 2001-09-07 Acclim Entertainment, Inc. Multi-player computer game system and method
US7043641B1 (en) * 2000-03-08 2006-05-09 Igt Encryption in a secure computerized gaming system
AU2001245529B2 (en) * 2000-03-08 2008-09-18 Igt Computerized gaming system, method and apparatus
CA2402389A1 (en) * 2000-03-08 2002-09-19 Shuffle Master, Inc. Computerized gaming system, method and apparatus
US6857067B2 (en) * 2000-09-01 2005-02-15 Martin S. Edelman System and method for preventing unauthorized access to electronic data
US6804763B1 (en) * 2000-10-17 2004-10-12 Igt High performance battery backed ram interface
US20020151363A1 (en) * 2001-04-12 2002-10-17 Howard Letovsky Method and system for broadcast and control of a remotely located wagering device
US6978465B2 (en) * 2000-12-14 2005-12-20 Intel Corporation Control of device-driver persistency
US7574481B2 (en) * 2000-12-20 2009-08-11 Microsoft Corporation Method and system for enabling offline detection of software updates
US7203841B2 (en) * 2001-03-08 2007-04-10 Igt Encryption in a secure computerized gaming system
US7931533B2 (en) * 2001-09-28 2011-04-26 Igt Game development architecture that decouples the game logic from the graphics logics
US8216071B2 (en) * 2002-03-20 2012-07-10 Intel Corporation Method and apparatus for software delivery and management
US8016666B2 (en) * 2002-08-30 2011-09-13 Oneida Indian Nation Linking component, system, and method for providing additional services at a gaming machine
US7611405B2 (en) * 2002-10-15 2009-11-03 Igt Dynamic menu system

Also Published As

Publication number Publication date
WO2003023647A1 (en) 2003-03-20
EP1433078A4 (en) 2006-11-15
ZA200402744B (en) 2004-12-02
EP1433078A1 (en) 2004-06-30
US20030069074A1 (en) 2003-04-10
CA2460046A1 (en) 2003-03-20
US7618317B2 (en) 2009-11-17

Similar Documents

Publication Publication Date Title
CA2460046C (en) Method for developing gaming programs compatible with a computerized gaming operating system and apparatus
US7988559B2 (en) Computerized gaming system, method and apparatus
US20110177867A1 (en) Computerized gaming system, method and apparatus
AU2001245529B2 (en) Computerized gaming system, method and apparatus
US7901291B2 (en) Gaming device operable with platform independent code and method
US9235955B2 (en) Universal game monitoring unit and system
CA2527872C (en) Download procedures for peripheral devices
US11249612B2 (en) Gaming system and gaming system processor module
AU2008200148B2 (en) Method for developing gaming programs compatible with a computerized gaming operating system and apparatus
US11508220B2 (en) Gaming system and method with matching image feature
CA2319600A1 (en) Method and apparatus for providing a compartmentalized game instruction architecture within a gaming machine
AU2002341815A1 (en) Method for developing gaming programs compatible with a computerized gaming operating system and apparatus
AU2013200582B2 (en) Universal game monitoring unit and system
JP2001120787A (en) Development system and method for variable display of pachinko game machine
AU2011205032A1 (en) Gaming system and gaming system processor module

Legal Events

Date Code Title Description
EEER Examination request
MKLA Lapsed

Effective date: 20150910