podręcznik użytkownika

eHo – podręcznik użytkownika
1
Sławomir Rudnicki
eHo
podręcznik użytkownika
Spis treści
1 Kompilacja...................................................................................................................................2
Generowanie dokumentacji.................................................................................................... 2
2 Uruchomienie...............................................................................................................................2
3 Zasady gry....................................................................................................................................2
4 Ustawienia programu i rozgrywka...............................................................................................3
Okno ustawień.............................................................................................................................3
Okno planszy...............................................................................................................................4
Elementy okna planszy:..........................................................................................................4
Czynności w oknie planszy.................................................................................................... 5
Zakończenie gry..................................................................................................................... 6
5 Opcje specjalne ........................................................................................................................... 7
Tryb testowy programu.............................................................................................................. 7
6 The Credits...................................................................................................................................7
eHo – podręcznik użytkownika
1
2
Sławomir Rudnicki
Kompilacja
W celu utworzenia pliku wykonywalnego programu należy umieścić archiwum
eho.tar.gz w pewnym katalogu, następnie uczynić ten katalog aktywnym i
wydać polecenia
tar -xzf eho.tar.gz
w celu rozpakowania archiwum i
make
w celu utworzenia pliku wykonywalnego programu. W czasie kompilacji
zostanie utworzony ukryty katalog .lib, ktorego zawartości nie należy usuwać,
jeżeli chce się wygenerować dokumentację kodu.
Generowanie dokumentacji
Aby wygenerować pełną dokumentację kodu programu w postaci zestawu
plików HTML wydaj polecenie
make doc
Dokumentacja będzie dostępna w katalogu ./doc
2
Uruchomienie
Po kompilacji program uruchamia się z terminala poleceniem
./eho
3
Zasady gry
Program eHo oferuje możliwość gry w dwuosobową grę planszową ho. Jest to
modyfikacja starochińskiej gry go, rozgrywana na sześciokątnej planszy.
Szczegółowe zasady dostępne są pod adresem
http://games.mimuw.edu.pl/?menu=games&submenu=Ho
eHo – podręcznik użytkownika
4
3
Sławomir Rudnicki
Ustawienia programu i rozgrywka
Okno ustawień
Po uruchomieniu programu ukazuje się okno
ustawień, w którym można wybrać
właściwości gry. Zmiany ustawień dokonuje
się przez klikanie na strzałki przy polach z
ustawieniami.
Opcje, które można zmienić, to:
●
wielkość planszy (BOARD SIZE)
liczba pól na przekątnej planszy. eHo
umożliwia grę na planszach o wielkości
od 3 do 51 pól na przekątnej.
●
gracze (BLACK PLAYER, WHITE PLAYER)
wybór, czy ruchy graczy będzie
wykonywał użytkownik czy komputer
●
komi
niecałkowita wielkość dodawana do
punktacji
gracza
białego
jako Ilustracja 1: Okno ustawień
rekompensata za to, że przeciwnik
wykonuje
pierwszy
ruch.
Komi może przyjmować wartości od 0.5 do 99.5. Przy zmianie wielkości
planszy komi ulega automatycznej zmianie.
Po dokonaniu ustawień naciśnij START, aby rozpocząć grę. Naciśnij QUIT,
aby wyjść z programu.
eHo – podręcznik użytkownika
4
Sławomir Rudnicki
Okno planszy
przycisk wyjścia
z gry
plansza
wskaźnik aktywnego gracza
panel przycisków
Elementy okna planszy:
–
wskaźnik aktywnego gracza
–
przyciski w dolnym panelu: PASS, UNDO, HINT
–
przycisk wyjścia z gry QUIT
–
plansza
eHo – podręcznik użytkownika
5
Sławomir Rudnicki
Czynności w oknie planszy
1. Wykonanie ruchu
wykonanie ruchu przez aktywnego gracza polega na kliknięciu na jedno z pól
planszy, tj. przecięć linii tworzących planszę. Jeżeli w miejsce użytkownika
ruch ma wykonać komputer, to ruch ten następuje bezpośrednio po ruchu
przeciwnika.
Ostatni ruch wykonany na planszy jest dla wygody
śledzenia rozgrywki oznaczany czerwonym
znakiem „+” na ostatnio położonym kamieniu
(Ilustracja 2).
2. Pass
zamiast ruchu można wykonać pass poprzez
kliknięcie na odpowiednim przycisku dolnego
panelu. Jeżeli ostatnim ruchem był pass, to
program wyświetla odpowiednią informację nad Ilustracja 2: Oznaczenie
ostatnio wykonanego
dolnym panelem (Ilustracja 3).
ruchu
3. Cofnięcie ruchu
W momencie, kiedy użytkownik ma wykonać
ruch, może wybrać cofnięcie ostatnio
wykonanego
ruchu
poprzez
naciśnięcie
przycisku UNDO. Jeżeli gra toczy się z
komputerem, cofnięty zostanie również ostatnio
wykonany ruch komputera, w przeciwnym
wypadku cofnięciu ulega tylko ostatni ruch Ilustracja 3: Informacja, że
przeciwnika aktywnego gracza.
ostatni ruch był passem
4. Wyświetlenie podpowiedzi
Aktywny gracz może zażądać wyświetlenia podpowiedzi wygenerowanej przez
silnik sterujący graczem komputerowym. W tym celu należy kliknąć na
przycisku HINT. Podpowiedź jest reprezentowana przez oznaczenie
sugerowanego pola na czerwono (Ilustracja 4) lub wyświetlenie informacji, że
sugerowanym ruchem jest pass (Ilustracja 5)
Ilustracja 4: Podpowiedź: ruch
w oznaczone pole
Ilustracja 5: Podpowiedź:
pass
eHo – podręcznik użytkownika
6
Sławomir Rudnicki
5. Wyjście z gry
Kliknięcie na przycisku QUIT powoduje powrót do okna ustawień. Jest to
możliwe również w przypadku obserwowania gry pomiędzy dwoma graczami
komputerowymi, kiedy pozostałe przyciski są nieaktywne. W takim wypadku
powrót do okna ustawień może wymagać dłuższego przytrzymania wciśniętego
przycisku myszy nad przyciskiem QUIT.
Zakończenie gry
Gra kończy się, kiedy obaj gracze wykonają po dwa passy z rzędu. Po
zakończeniu partii wyświetlone zostaje okno z wynikiem gry (Ilustracja 6).
Okno z informacją o wyniku gry zawiera liczbę punktów zgromadzonych przez
obu graczy, kolor zwycięskiego gracza oraz przyciski NEW GAME, który służy
do powrotu do okna ustawień, oraz QUIT, który zamyka program.
Ilustracja 6: Informacja o wyniku gry
eHo – podręcznik użytkownika
5
7
Sławomir Rudnicki
Opcje specjalne
Tryb testowy programu
Program eHo można uruchomić w trybie, w którym możliwe będzie
sprawdzenie inteligencji gracza komputerowego w potyczce z programem
losującym swoje ruchy. W tym celu należy zastosować przełącznik -t w
czasie uruchamiania programu:
./eho -t
Po takim wywołaniu programu w oknie ustawień będzie dostępna nowa
opcja wyboru gracza CPU Random. Gracz ten wykonuje ruchy w pełni
losowe.
6
The Credits
Autor koncepcji, kodu, inteligencji gracza komputerowego, pięknych przycisków,
fantastycznego wystroju okien i innych cudowności programu eHo:
Sławomir Rudnicki, WMIM UW
Betatesting i opiniodawstwo:
- Marcin Jakubczak
- Rafał Dąbrowski
Program stworzony w całości w OCamlu, fantastycznym funkcyjnym języku
programowania, którego potężne interpretery są dostępne pod adresem:
http://caml.inria.fr
Niniejszy podręcznik użytkownika
OpenOffice.org Writer.
stworzono w
darmowym
programie
Kod programu powstawał w edytorze emacs, w ciągu ponad miesiąca. Historię
walki autora o poprawne działanie programu przedstawia dokument eHo
Development Log dostępny pod adresem
www.saf.su.pl/projects/eho/devlog.txt