@database X-Wins_english.guide @$VER: 1.3 @author "Mario Dannebauer" @(c) "(C) 1994 Mario Dannebauer. All rights reserved." /****************************************************************************/ @node "Main" "X-Wins.Guide" @{b}@{bg shine}X-Wins@{ub}@{bg back} Version 2.4 @{b}(c) 1995/96 Mario Dannebauer@{ub} @{" Introdution  " link "Introdution" 0} What is X-Wins? @{" Disclaimer   " link "Disclaimer" 0} NO WARRANTY! @{" Copyright    " link "Copyright" 0} It's mine! @{" Distribution " link "Distribution" 0} How to spread? @{" Requirements " link "Requirements" 0} What you need to start X-Wins. @{" Installation " link "Installation" 0} How to install? @{" Gameplay     " link "Gameplay" 0} How to play the Game? @{" History      " link "History" 0} The Story so far... @{" Future       " link "Future" 0} I don't know. @{" Credits      " link "Credits" 0} Thanks to... @endnode /****************************************************************************/ /****************************************************************************/ @node "Introdution" "Introdution" @{b} @{u}What is X-Wins?@{uu} @{ub} X-Wins is s strategy game like "4-in-a-row". The goal of this game is to become 4 (or more) Stones in a row (verticaly,  horizontaly or digonaly). This happens while the opponents sets their stones  alternate in a x*y-sizing gamefield. You can set a stone by clicking in a free  field of your choise in the gamefield. If the field(s) under your clicked field are free too, your stone will fall down, because the stones in one vertical row are like a tower. For more information read the chapter @{" Gameplay " link "Gameplay" 0} of this documantation. @endnode /****************************************************************************/ /****************************************************************************/ @node "Disclaimer" "Disclaimer" @{b} @{u}Disclaimer@{uu} @{ub} THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR  PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE  PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE  THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA  BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. @endnode /****************************************************************************/ /****************************************************************************/ @node "Copyright" "Copyright " @{b} @{u}Copyright@{uu} @{ub} @{b}X-Wins is copyrighted by Mario Dannebauer 1995/96.@{ub} X-Wins is @{i}Giftware @{ui}! This means you are absolutely NOT forced to send me money to go on using this program. But, if you reallylike this software or find it really useful, then feel free to send me some money or other stuff like a postcard, a letter, software, hardware, etc... If you find some @{" bugs " link "Disclaimer" 0} in this program or if you have any suggestions, ideas etc. please contact the @{" author " link "Author" 0}. For building this program the following products were used: o A4000/40 (OS 3.0) with 80MB HD and 8MB fast ram o SAS/C V6.51 Copyright (c) 1992-1994 SAS Institute, Inc, Cary, NC o @{" Magic User Interface " link "ReadMe.mui/main" 0} V2.1 Copyright (c) 1993/94 by Stephan Stuntz o XDME Version 1.54 by Aaron Digulla [DME (C)Copyright 1987-91 by Matthew Dillon] Trademarks: Amiga, AmigaDOS and Workbench are registered trademarks of Amiga Technologies GmbH. @endnode /****************************************************************************/ /****************************************************************************/ @node "Distribution" "Distribution " @{b} @{u}Distribution@{uu} @{ub} X-Wins has to be distributed as it comes. The package must not be changed in any way. The only exception is to pack the whole package in an archieve. For any other distribution form you must have a written permission by the @{" author " link "Author" 0}. There must not be any profit selling this package! When including this program in a public-domain-serie please send me a message. May be there's already a new version of this program so you don't include old stuff. If you wish to supply this programm as part of a CD-ROM compilation, you need a written permission by the @{" author " link "Author" 0}. Explicit permission is granted to distribute this programm on any CD-ROM produced by Fred Fish / Amiga Library Services, and on any officially supported Aminet  compilation CD-ROM. Comercial distribution of this program is only allowed with written permission by the @{" author " link "Author" 0}. @endnode /****************************************************************************/ /****************************************************************************/ @node "Requirements" "Requirements" @{b} @{u}Requirements@{uu} @{ub} To use this program you need: o An Amiga with OS 2.0 or higher. o The @{" Magic User Interface " link "ReadMe.mui/main" 0} (short: MUI) Version 2.1 or higher. @endnode /****************************************************************************/ /****************************************************************************/ @node "Installation" "Installation" @{b} @{u}How to install?@{uu} @{ub} To install X-Wins on your Amiga just copy the the file "X-Wins" - or the whole drawer - where you want. To make online-help avaiable, just copy the "*.guide"-file, wich corresponds to your language, from the "Docs"-drawer to the same drawer of the Programm "X-Wins". Do you want to use the program in your local language but you have not copied the hole drawer, just copy the "*.catalog"-file from the catalogs-drawer included  in this package to the LOCALE:Catalogs directory. The build-in language is english. If you've written a catalog for another language, please send it to me. @endnode /****************************************************************************/ /****************************************************************************/ @node "Gameplay" "Gameplay" @{b} @{u}How to play the Game?@{uu} @{ub} X-Wins is s strategy game like "4-in-a-row". When you start the program a window and a requester appears. After closing the requester by clicking the "OK"-Button you see the @{" main-window " link "main-window" 0}. Now you can change the @{" prefenrences " link "prefs-window" 0} or begin to play. To make your turn (set a stone) just click in a free field of the gamefield. Since you see the gamefield from the side-view and not from the top, your stone will fall down if possible. That means you build a tower in each coloumn. After you have made your turn it's your opponents turn. You have won the game when you have 4 (or more) stones in a row. That means  verticaly, horizontaly or digonaly. If neither you nor your opponent can build  that row, nobody wins. And now have fun! @endnode /****************************************************************************/ /****************************************************************************/ @node "main-window" "Main-Window" @{b} @{u}The Main-Window@{uu} @{ub} At the top of this window you will see a status-line. This line informs you about the actual player and later about the winner of the game if exists. There are five buttons under the status-line: @{" New Game " link "BT New Game" 0} @{" Back " link "BT Back" 0} @{" Help " link "BT Help" 0} @{" Swap " link "BT Swap" 0} @{" Preferences... " link "BT Preferences" 0} Under these buttons you can see the gamefield which looks like a grid. Each field of this grid are a field where you can place a stone in the course of the game. To make your turn (set a stone) just click in a free field of the gamefield. Since you see the gamefield from the side-view and not from the top, your stone will fall down if possible. That means you build a tower in each coloumn. @endnode /****************************************************************************/ /****************************************************************************/ @node "BT New Game" "Main-Window/New Game" @{b} @{u}New Game@{uu} @{ub} Clicking at this button will clear the game field and begin a new game. @endnode /****************************************************************************/ /****************************************************************************/ @node "BT Back" "Main-Window/Back " @{b} @{u}Back@{uu} @{ub} Clicking at this button will take back your latest turn and then it's your turn again. If you are playing against the computer, the last turn of the computer will take back too, so it's your turn again. @endnode /****************************************************************************/ /****************************************************************************/ @node "BT Help" "Main-Window/Help " @{b} @{u}Help@{uu} @{ub} Clicking at this button will change in the help-mode. In this mode the computer will search for the best move he find for you. The result is ... ... a blinking field. That means this is the best turn from the view of the computer. (Not really always the best move you can do.) ... a requester wich informs you that you have no chanche to win this game. That means that your next turn doesn't matter, because you will always loose later. (If you take back your last turn you will maybe change the situation.) ... a requester wich informs you that you will win this game if you see your chanche now. After closing this requester you will see a blinking field. That means this is the best turn from the view of the computer. (You will certainly win this game some time if conform to the move the computer found.) @endnode /****************************************************************************/ @node "BT Swap" "Main-Window/Swap" @{b} @{u}Swap sides@{uu} @{ub} Clicking this button you can swap the sides. That means, player 1 and player 2 are swapping the mode, the name and the colour of stones. After a swapping the sides, it's (logically) your opponents move! @endnode /****************************************************************************/ /****************************************************************************/ @node "BT Preferences" "Main-Window/Preferences..." @{b} @{u}Preferences@{uu} @{ub} After clicking at this button you will see the @{" prefenrences-window " link "prefs-window" 0}. @endnode /****************************************************************************/ /****************************************************************************/ @node "prefs-window" "Prefenrences-Window" @{b} @{u}Preferences-Window@{uu} @{ub} In this window you can set some preferences like width and height if the gamefield, the beginner of the game etc. Contents of this window: String-gadgets: @{" Player 1 " LINK "STR Names of players" 0} Cycle-gadgets: @{" Mode player 1 " LINK "CYCLE Player mode" 0} @{" Player 2 " LINK "STR Names of players" 0} @{" Mode player 2 " LINK "CYCLE Player mode" 0} Cycle-gadget: @{" Beginner " LINK "CYCLE Beginner" 0} Slider: @{" Deep of searching " LINK "SLIDER Deep of searching" 0} Sliders: @{" Fields horizontally " LINK "SLIDER FieldsX" 0} @{" Fields vertically " LINK "SLIDER FieldsY" 0} @{" Stones in a row " LINK "SLIDER Stones in a row" 0} Checkmarks: @{" Messages " LINK "CM Messages" 0} ( @{" Begin a new game " LINK "CM New game" 0} ) Buttons: @{" Save " LINK "BT Save Use Cancel" 0} @{" Use " LINK "BT Save Use Cancel" 0} @{" Cancel " LINK "BT Save Use Cancel" 0} @endnode /****************************************************************************/ @node "STR Names of players" "Prefenrences-Window/Names of players" @{b} @{u}Names of players@{uu} @{ub} Here you can input your and your opponents name. If a player is computer navigated, the stringgadget for the name of this player is ghosted. See also: @{" Player mode " link "CYCLE Player mode" 0}) @endnode /****************************************************************************/ @node "CYCLE Player mode" "Prefenrences-Window/Player mode" @{b} @{u}Player mode@{uu} @{ub} With this two cycle-gadgets you can set for each player, if he's a human player or computer navigated. If a player is computer navigated, the stringgadget for the name of this player is ghosted. See also: @{" Names of Players " link "STR Names of players" 0}) @endnode /****************************************************************************/ @node "CYCLE Beginner" "Prefenrences-Window/Who begins?" @{b} @{u}Who begins?@{uu} @{ub} Here you can set the beginner of the next game. @endnode /****************************************************************************/ @node "SLIDER Deep of searching" "Prefenrences-Window/Deep of searching" @{b} @{u}Deep of searching@{uu} @{ub} With this slider you can set how many moves the computer-opponent is calculating when he is searching for his move. This slider also sets the depht of the search when you are clicking the @{" Help-Gadget " link "BT Help" 0} in the @{" mainwindow " link "main-window" 0} . @endnode /****************************************************************************/ @node "SLIDER FieldsX" "Prefenrences-Window/Fields horizontally" @{b} @{u}Fields horizontally@{uu} @{ub} Here you can change the number of rows of the gamefield. (This slider is ghosted, until you begin a new game, respectively all fields of the gamefield must be free.) @endnode /****************************************************************************/ @node "SLIDER FieldsY" "Prefenrences-Window/Fields vertically" @{b} @{u}Fields vertically@{uu} @{ub} Here you can change the number of lines of the gamefield. (This slider is ghosted, until you begin a new game, respectively all fields of the gamefield must be free.) @endnode /****************************************************************************/ @node "SLIDER Stones in a row" "Prefenrences-Window/Stones in a row" @{b} @{u}Stones in a row@{uu} @{ub} With this slider you can change the number of stones in a row needed to win the game. @endnode /****************************************************************************/ @node "CM Messages" "Prefenrences-Window/Messages" @{b} @{u}Messages@{uu} @{ub} This checkmark lets you switch the messages on and off. Switching the messages on means that you'll see a requester with a message, when your computer-opponent think that you can not win the actual game, respectively that you will win the game when you see your chanche now. (This checkmark is ghosted, until one of the players is a humen player. See also: @{" Player mode " link "CYCLE Player mode" 0}) @endnode /****************************************************************************/ @node "CM New game" "Prefenrences-Window/Begin a new game" @{b} @{u}Begin a new game@{uu} @{ub} Since you can not change all the preferences during a game, this checkmark exists. Marking that means that you want to begin a new game and all ghosted gadgets will be now unghosted. (Only visible, when a game is in progress.) @endnode /****************************************************************************/ @node "BT Save Use Cancel" "Prefenrences-Window/Save Use Cancel" @{b} @{u}Save/Use/Cancel@{uu} @{ub} Here you can save and use, use without saving or chancel your changes. @endnode /****************************************************************************/ /****************************************************************************/ @node "History" "History" @{b} @{u}History@{uu} @{ub} Revision V2.4 ------------- created on 10.01.96 by Mario Dannebauer - updated text files - bug fixed in catalog-file (thanks Frank!) - decreased code size --- Public release --- Revision V2.3 ------------- created on 11.12.95 by Mario Dannebauer - bug fixed: switch messages on/off works now correctly - added new button: swap (sides) - added new options: winner/looser begins, alternate beginner - added online-help - added keyboard control for all windows - enabled beginner-options during game (don't know why disabled this before) --- Public release --- Revision V2.1 ------------- created on 15.11.95 by Mario Dannebauer - italian language catalog added --- Public release --- Revision V2.0 ------------- created on 25.10.95 by Mario Dannebauer - documantation written - icon created - add variable number of rows to win - bumped to version 2 --- First public release --- Revision V1.9 ------------- created on 21.02.95 by Mario Dannebauer - internal game structure rewritten - add variable dimensions of gamefield --- Private release --- Revision V1.6 ------------- created on 13.7.94 by Mario Dannebauer - add preferences window --- Private release --- Revision V1.5 ------------- created on 26.5.94 by Mario Dannebauer - MUI-Version --- Private release --- Revision V1.0 ------------- created on 12.03.93 by Mario Dannebauer --- Initial release --- @endnode /****************************************************************************/ /****************************************************************************/ @node "Future" "Future" @{b} @{u}Future@{uu} @{ub} I don't plan further versions of this program next time, but if you have some ideas or suggestions then contact me. @endnode /****************************************************************************/ /****************************************************************************/ @node "Credits" " Credits " @{b} @{u}Credits@{uu} @{ub} Thanks must go to: o Piergiorgio Ghezzo for the translation of the language catalog to italian. o Stephan Stuntz for his fantastic @{" Magic User Interface " link "ReadMe.mui/main" 0} o SAS Institute for their great C-Compiler o Aaron Digulla and Matthew Dillon for their XDme/Dme o Amiga Technologies GmbH and all the PD-programmers/-distributors, who keeps the Amiga alife. o ...and anyone who send me something for this program or give me suggestions. @endnode /****************************************************************************/ /****************************************************************************/ @node "Author" "author" @{b} @{u}Author@{uu} @{ub} Mario Dannebauer O7 29 68161 Mannheim Germany phone: 0621/20390 Or using e-mail (Internet) to: 86308@novell1.rz.fht-mannheim.de @endnode