home *** CD-ROM | disk | FTP | other *** search
/ Spiele Spiele Spiele 1 / spiele-spiele-spiele-topware.iso / spiele / top5062 / read.doc < prev   
Text File  |  1993-08-25  |  17KB  |  334 lines

  1. * File: read.me ******************************************* Page 1 of 6 *****
  2.  
  3.    MODGO software is written by:   Alfred Knoepfle    and   Walter Knoepfle
  4.                                    Merzhauserstr 2          Planeggerstr 15
  5.                                    79100 Freiburg           82110 Germering
  6.                                    Germany                  Germany
  7.    Last update: 25-Aug-1993
  8. *****************************************************************************
  9.  
  10.    MODGO is a software system for the game of GO. Start of development
  11.    was in summer 1985. Since then component after component was added and
  12.    further developed.
  13.    The system is completely written in program language Modula-2.
  14.    A single exe file in the beginning, the system is now splitted into a
  15.    GO playing and a service program, and in more than a dozen of overlays
  16.    as well as pattern files and a lot of game records.
  17.  
  18.    Since 1988 MODGO regularly attended the European Computer GO Champion-
  19.    ships - with slowly increasing success - after several middle places
  20.    the program took 2nd place in 1992 and in 1993.
  21.    In 1991 MODGO also qualified for the Computer GO World Championship and
  22.    reached 8th place in Singapure.
  23.  
  24.    By now MODGO playing strengh is somewhere between 12th and 18th Kyu,
  25.    but an exact ranking is quit difficult, as MODGO is always ready with
  26.    completely meaningless blunders.
  27.    Therefore the system also has the additional name 'Star of Debacle'.
  28.  
  29.    Beside playing matches with MODGO, the system offers the following
  30.    additional possibilities:
  31.    - Input and editing of game records
  32.    - Archiving of game records
  33.    - Replay of stored game records
  34.    - Read and write of internal MODGO format as well as Standard Format
  35.    - Preparation and printing of diagrams - on several different printers
  36.    - Modem connection for GO matches
  37.    - Independent running demo matches with MODGO
  38.  
  39.    If You are interested in more details or in the latest MODGO
  40.    software version  -  please contact Alfred or KS-Systemtechnik
  41.    for more information.
  42.  
  43.    MODGO software system can be purchased by:
  44.  
  45.       Firma KS-Systemtechnik           Konto 4256731
  46.       Hauptstrasse 43                  Sparkasse Hochschwarzwald
  47.       79877 Friedenweiler 1            BLZ 68051004
  48.  
  49.    Please order in written form by transmitting amount to account given
  50.    above. Give also desired floppy format (3.5 HD or 5.25 HD)
  51.  
  52.    Full version:  75,-DM plus 5,-DM postage+material
  53.    Demo version:  10,-DM plus 5,-DM postage+material
  54.  
  55.    MODGO Demo Version has full graphic- and service functions as its
  56.    disposal but generates just pseudo-random moves to create some
  57.    appetite for the latest MODGO Full Version.
  58.    (MODGO demo version is also available as shareware)
  59. * File: read.me ******************************************* Page 2 of 6 *****
  60.  
  61.  
  62.    1) Contents of floppy:
  63.  
  64.    MODGO software consists of:                 (Total about 1.2 MBytes)
  65.          Procedure "install.bat" to install MODGO software on hard disc
  66.          Service program "servo.exe"
  67.          GO playing program "modgo.exe"
  68.          Additional move generating overlays for "modgo.exe"
  69.          Subdirectory "gamepool" with ascii game history files
  70.          Subdirectory "datapool" with binary pattern files
  71.  
  72.  
  73.    2) Hardware requirements:
  74.  
  75.    MODGO software runs on IBM-PCs. Memory must be at least 512 KBytes,
  76.    although overlay technics are used, to keep required memory small.
  77.    MODGO software works with Hercules, CGA, EGA or VGA graphics cards.
  78.    The most useful graphics mode is selected automatically by MODGO.
  79.    When using MDA card, make sure that CONFIG.SYS contains
  80.    "device = ansi.sys" for display of simple special-character graphics.
  81.  
  82.  
  83.    3) Installation 
  84.  
  85.    Installation on hard disc is highly recommended - but not required.
  86.    It is desirable to install MODGO system on hard disc to conveniently
  87.    (and much more quickly) use MODGO file and overlay handling.
  88.    Use tool "install.bat" to install MODGO program system on hard disc.
  89.    Just insert floppy disc and type <drive>:install without parameters
  90.    to start the installation tool for on line help text. Installation
  91.    is done from destination directory with command <drive>:install <drive>
  92.  
  93.  
  94.    4) Running MODGO
  95.  
  96.    Executable GO program MODGO can be started by typing its name.
  97.    MODGO can also be executed directly from floppy disc with command
  98.    "a:modgo" but then You have to keep disc into driver, to properly
  99.    handle not resident overlays. Overlays and pattern files are
  100.    permanently used during play - and therefore need a lot of additional
  101.    time when read from floppy.
  102.  
  103.    After loading is done, MODGO displays an empty GO board on screen and
  104.    starts playing a match with default game conditions - which are:
  105.    MODGO takes black stones against a human opponent, komi is 5.5 points,
  106.    board size is 19x19, ChineseSST rules are applied.
  107.  
  108.    For 19x19 games MODGO full version uses approximately 7 - 15 minutes of
  109.    'working' time on IBM-AT-486/50. There is a possiblity to interupt
  110.    the match and save it on file "TMPSAVE.GO" at any time. The match can
  111.    be restored from this file and be continued. By the way during match
  112.    play this file is automatically updated = overwritten after every move
  113.    for safety reasons.
  114. * File: read.me ******************************************* Page 3 of 6 *****
  115.  
  116.    4.1) MODGO play menu
  117.  
  118.    The following F-keys are supported in play menu for special functions:
  119.    F1 - Menu     (Setup new game - or change game conditions)
  120.    F2 - Pass     (Generate Pass Play)
  121.    F3 - Quit     (Terminate program without save of match)
  122.    F4 - Undo     (Undo last move pair)
  123.    F5 - Intrpt   (Terminate program with save of match on file "TMPSAVE.GO")
  124.    F6 - Resign   (If user wishes to resign the match)
  125.    F7 - Force MODGO to resign, to quickly end already decided games.
  126.  
  127.    Keys F1 to F6 can be used at any time. If MODGO is just working on its
  128.    next move, key press action is noticed after generation process is
  129.    finished. An empty-buffer routine ensures the latest key press action
  130.    to be performed only, no queueing is supported.
  131.    To work properly Key F7 must be pressed while MODGO is creating a move.
  132.  
  133.    When key F1 is used - matches under way are first saved on backup file
  134.    "TMPSAVE.GO". After that, menu window is displayed for modification of
  135.    playing mode and game condition parameters.
  136.    F1 is especially useful, if any problems occure during match play,
  137.    e.g. if electric power is switched off by accident. It is then possible
  138.    to simply load and continue the match from backup file "TMPSAVE.GO".
  139.  
  140.    Some patience is required after use of F4, as MODGO then always will
  141.    re-create all internal game informations from scratch. This needs some
  142.    time - especially for games in late Yose.
  143.  
  144.    4.2) MODGO main menu
  145.  
  146.    Display areas in gray give on line help information, areas in blue
  147.    contain input fields. For modifications of game condition parameters
  148.    best use up and down cursor keys to switch between items and use left
  149.    and right cursor keys to toggel within valid item values. Due to
  150.    selected parameters some items may be fix or redundant and therefore
  151.    not accessable.
  152.  
  153.    The following F-keys are supported in main menu:
  154.    F1 - New game      (Start new game - with active game conditions)
  155.    F2 - Continue game (Continue current game - with active game conditions)
  156.    F3 - Quit          (Terminate program)
  157.    F4 - Load game     (Load game history file up to any desired move)
  158.    Active menu action is highlighted in green. ESC immediately starts it.
  159.  
  160.    When F4 is used - an additional input area allows selection of history
  161.    files to be loaded. Besides MODGO internal ASCII game history format
  162.    also Ishi Press Standard Format game records can be read.
  163.    MODGO is looking for such files with default extension ".GO" in current
  164.    directory and in subdirectories GAMEPOOL and ISHIPOOL - in that order.
  165.    Toggeling through the list of found game files is done with up and down
  166.    cursor keys. File selection can also be done by typing in path and file
  167.    name of desired game history file.
  168.    Combination of keys ALT+G provides default: GAMEPOOL\GAME, then just add
  169.    desired number to complete input. Combination of keys ALT+I directly 
  170.    leads to default: ISHIPOOL\<1st entry>, then just toggel to desired file.
  171. * File: read.me ******************************************* Page 4 of 6 *****
  172.  
  173.    Key ENTER leads to loading of selected file. Success is indicated with
  174.    a message highlighted in green - retrieved game condition parameters
  175.    are displayed - then input desired move number to start playing with.
  176.  
  177.    Input or editing of game records can be done with playing option 1.
  178.    Option 2 is for matches against the program.
  179.    Playing options 3,4,5 let MODGO play against itself in different modes:
  180.    3 - Performance of a single game. After end of game a prompt allows to
  181.        save the game or to continue as desired.
  182.    4 - Performance of games as endless loop. After end of game another game
  183.        with same game conditions is performed. This is especially suited for
  184.        demo purposes.
  185.    5 - Performance of games as endless loop with automatic save of game
  186.        histories.
  187.  
  188.    Moves and other User actions can generally be provoked by either string,
  189.    cursor, function key or mouse input.
  190.  
  191.    As special feature Modem connection to another PC is possible: 8 data bit,
  192.    1 stop bit, no parity is used. After installations on both PCs, games
  193.    between software contestants are played without any further user inter-
  194.    action. Just lay back, relax and watch the performance of the programs.
  195.    (This is well tested with 'Nemesis' and 'Many Faces of Go' as opponents)
  196.  
  197.    4.3) MODGO save menu
  198.  
  199.    With Chinese SST rules MODGO will start Yose removals after occupation
  200.    of last points in contest. This is because computer GO tournaments
  201.    usually require removal of dead stones and groups at the end of the
  202.    game to clarify the game result. With ChineseSST rules this makes no
  203.    difference to the result. With simplified Japanese rules however MODGO
  204.    will omitt Yose removals as this would imply a loss of points.
  205.  
  206.    After the regular end of a game with consecutive pass plays MODGO will
  207.    provide the game result and a prompt weather to accept it or not.
  208.    Captured but not removed stones on board are marked as dead with crosses.
  209.  
  210.    If result is obviously wrong (may be due to sad mis-interpretations in
  211.    life&death questions) and therefore not acceptable - it is possible to
  212.    resume game play to decide the problem by playing it out.
  213.  
  214.    The following F-keys are supported in save menu:
  215.    F1 - Menu      (Setup new game - or change game conditions)
  216.    F3 - Quit      (Terminate program without save of match)
  217.    F4 - Save game (Save game history record on file)
  218.    F5 - Intrpt    (Terminate program with save of match on file "TMPSAVE.GO")
  219.    F6 - Start another game with same game conditions
  220.  
  221.    Finished games can be stored either in MODGO internal format or in Ishi
  222.    Press Standard Format in MODGO GAMEPOOL or ISHIPOOL subdirectories.
  223.    "GAMEPOOL" consists of a set of ASCII game history files - in MODGO
  224.    internal format - with default names "GAMExxx.GO" (xxx = 001 - 999)
  225.    "ISHIPOOL" is the same for standard format files - MODGO supports
  226.    default names "ISHIxxx.GO", other names are of course also possible.
  227.    Special save menu area gives You the possiblity to select format type
  228.    (1st character of given string is checked) and to insert event string,
  229.    names of players, current date and desired file name.
  230. * File: read.me ******************************************* Page 5 of 6 *****
  231.  
  232.    Stored game history files can be loaded again by MODGO at any time and
  233.    be continued from any move. Replay and printing of stored games is done
  234.    with program SERVO. To delete or rename game history files change to
  235.    subdirectory GAMEPOOL and use DOS commands 'del' or 'rename'.
  236.  
  237.  
  238.    5) Running SERVO
  239.  
  240.    Executable utility program SERVO can be started by typing its name.
  241.    SERVO performs info display, game replay, print and edit utilities.
  242.  
  243.    For study and documentation reasons - replay of stored games and
  244.    creation of hardcopy diagrams on various printer types can be done
  245.    quit simply with SERVO.
  246.    Besides MODGO internal ASCII game history format also properly
  247.    prepared Ishi Press Standard Format game records can be read -
  248.    just try out.
  249.    (Files should contain key words for relevant game condition parameters)
  250.  
  251.    SERVO is menu based - the main menu just shows the list of sub menus.
  252.    Sub menus are selected by typing in the corresponding sub menu number and
  253.    confirmation with ENTER key. To change the current sub menu, first come
  254.    back to main menu. To do this, use ENTER (without number) or ESC.
  255.  
  256.    Sub menu 1: Introduction texts
  257.        Three sub menu branches give infos about MODGO system, the game of GO
  258.        and a short description of the rules (Chinese SST and simplified
  259.        Japanese). Just go through the texts by typing in the given numbers
  260.        and confirm with ENTER. Skip pages with ENTER OR ESC.
  261.  
  262.    Sub menu 2: Demonstration games
  263.        This sub menu gives the possiblity to replay 6 selected demo games
  264.        from MODGO GAMEPOOL. Just select a game by typing the corresponding
  265.        number and confirm with ENTER. After game replay is finished this
  266.        sub menu is displayed again for selection of another demo game.
  267.  
  268.    Sub menu 3: Replay menu
  269.        This sub menu gives the possiblity to replay any stored game from
  270.        either MODGO GAMEPOOL or ISHIPOOL or any other file in supported
  271.        game history formats.
  272.  
  273.        The following F-keys are supported in replay menu:
  274.        F1 - Overviev          (Show content of game pool directories)
  275.        F2 - Start replay mode (Fast, slow and replay on key is provided)
  276.        F3 - Quit              (Return to main menu - same function as ESC)
  277.        F4 - Load game         (Load game history file)
  278.  
  279.        Before starting replay mode with key F2, it is necessary to load a
  280.        game into working buffers with key F4. Selection of file names and
  281.        loading of files is done exactly the same way as with program MODGO.
  282.  
  283.    Sub menu 4: Print Utilities
  284.        This sub menu gives the possiblity to create hardcopy diagrams of
  285.        stored games from either MODGO GAMEPOOL or ISHIPOOL or any other
  286.        file in supported game history formats.
  287. * File: read.me ******************************************* Page 6 of 6 *****
  288.  
  289.        The following F-keys are supported in print menu:
  290.        F1 - Set print mode   (Select diagram interval mode)
  291.        F2 - Select printer   (Select type of printer and printing mode)
  292.        F3 - Quit             (Return to main menu - same function as ESC)
  293.        F4 - Load game        (Load game history file)
  294.  
  295.        Print mode can be:
  296.        - Diagrams of selected move intervals
  297.        - Diagram sequences of fixed interval lenghts (e.g. every 100 moves)
  298.        - Alpanumerical lists of move coordinates - complete game.
  299.  
  300.        Supported printers include:
  301.        Epson, NEC, HP-Laserjet, Siemens  and compatibles
  302.  
  303.        Printing mode can be ONLINE or OFFLINE. If ONLINE diagrams are printed
  304.        directly via centronics interface (PRN) if printer is ready for action.
  305.        If OFFLINE, binary diagram files (with names DIA001.PIC, DIA002.PIC,
  306.        ..., DIAxxx.PIC - ascending numbers) are created on hard disc. These
  307.        files can later be printed with DOS command 'print'.
  308.        OFFLINE mode is to be recommended for larger numbers of diagrams as
  309.        much faster than ONLINE mode.
  310.  
  311.        Active modes are displayed at right side below MODGO logo. They are
  312.        also stored in configuration file "PRT.CFG" for convenient use in
  313.        next SERVO session.
  314.  
  315.        After selection of active modes and loading of desired game file
  316.        input of move interval parameters due to selected print mode is
  317.        required. Creation of binary diagram files is indicated with its
  318.        current file name. Use ESC to return to selection of next file or
  319.        to return to main menu.
  320.  
  321.    Sub menu 5: Edit Utilities
  322.        MODGO has the capability to play joseki and pattern moves, retrieved
  323.        from binary DATAPOOL pattern files. Such pattern files are to be
  324.        prepared/modified with services from SERVO edit utlility sub menu.
  325.  
  326.        Listed tools are by now in experimental state only - partly offline
  327.        - or realized as overlays - or tbc = to be coded!
  328.        As the handling of these tools is still not very sophisticated they
  329.        are missing 'for the time being' in MODGO full version.
  330.  
  331.    Sub menu 6: Termination
  332.        To end a SERVO session select main menu point 6 or just use ESC.
  333.        This immediately terminates the program.
  334.