# Podręcznik &kbackgammon;

## Wprowadzenie

&kbackgammon; jest graficznym klientem backgammon. Celem gry backgammon jest usunięcie swoich pionków z planszy zanim zrobi to przeciwnik. Reguły tej gry nie należą do najprostszych (najtrudniejsze jest wstępne ustawienie pionków) i nie są one tematem tej dokumentacji. Aby je poznac warto poczytać o grze na stronach internetowych poświęconych jej tematyce, lub (najlepiej) zapytać znajomego.

&kbackgammon; daje graczowi do dyspozycji graficzną reprezentację planszy, którą można praktycznie w całości obsługiwac myszą (można tez korzystac z poleceń tekstowych i nie korzystać z myszy). &kbackgammon; jest wygodny w obsłudze i pozwala skupić sie na właściwej rozgrywce.

Do gry potrzebny jest przeciwnik. &kbackgammon; pozwala zagrac przeciwko setkom przeciwników o różnych poziomach umiejętności za pośrednictwem serwera FIBS. Istnieje też możliwość wybrania trybu Gra na zmianę który pozwala zagrać z komputerem, przyjacielem lub ze samemu ze sobą.

W przyszłości &kbackgammon; pozwoli na grę z &GNU; Backgammon, rozbudowanym programem do gry w.backgammon, pozbawionym interfejsu graficznego. Program ten jest także dostępny jako przeciwnik na serwerze FIBS i ma wynik około 2000 punktów (jest to wysoki wynik).

W planach jest umożliwienie rozgrywania gier dwóm graczom korzystających z &kbackgammon;. Architektura aplikacji &kbackgammon; jest otwarta i pozwala na dodanie obsługi innych programów rozgrywających (autorzy takich programów mogą skontaktować się w tej sprawie z autorem).

## Jak posługiwać się planszą

Najważniejszym elementem &kbackgammon; jest graficzna reprezentacja planszy gry.Są na niej pionki, kości do gry oraz kostka dublująca.Wszystkie te elementy można obsługiwać myszką.

Obrazek pokazuje typową sytuację z gry, biały gracz przesuwa pionki w kierunku pola 24, a gracz czarny postępuje odwrotnie. W tej chwili biały gracz kontroluje kostkę dublującą i wyrzucił parę liczb 3 i 4.

Plansza gry backgammon Plansza gry

Podczas swojej tury gracz może rzucić kości podwójnie klikając na ich graficznych reprezentacjach, korzystając z odpowiedniego menu albo klikając odpowiedni przycisk na pasku narzędzi (jeżeli jest widoczny i zawiera opcję rzut).

Jeżeli gracz kontroluje kostkę dublującą, może podwoić wartość jaką wskazuje klikając dwa razy w reprezentujący ją kwadrat z cyfrą, korzystając z odpowiedniego menu, lub klikając odpowiedni przycisk na pasku narzędzi (jeżeli jest widoczny i zawiera przycisk kostki dublującej).

W trakcie swojego ruchu gracz może przesuwać pionki klikając na nich i przesuwając wskaźnik myszy na pole docelowe (trzymając wciśnięty przycisk myszy). To nazywa się przeciąganiem pionka. W zależności od wybranego sposobu rozgrywki w menu konfiguracji przeciwnika ruch zakończy się po przesunięciu maksymalnej liczby pionków (od jednego do czterech, najczęściej są to dwa pionki).

Poza przeciąganiem pionków plansza gry oferuje funkcję zwaną krótkie ruchy. Jeżeli funkcja ta została włączona w konfiguracji, pionki mozna przesuwać po prostu klikając na nie. Zostanie wtedy na nich wykonany najkrótszy możliwy ruch, który usuwa je z bieżącego pola. Jeżeli włączona jest funkcja krótkich ruchów, można dodatkowo zdecydować czy przypisać ją do pojedynczego czy podwójnego kliknięcia. Jest to bardzo przydatna funkcja dla posiadaczy touchpadów, gdzie przeciąganie jest niewygodne.

Na planszy można wykonywać tylko dozwolone ruchy (zależą one od bieżącego wyniku rzutu). O ile tryb gry na zmianę pozwala wyłączyć tą funkcję (w przypadku wybrania opcji Tryb Edycji), jest ona przydatna dla początkujących(a zaawansowanym graczom nie przeszkadza). Funkcja ta pozwala także anulowac ruchy - wystarczy przesunąć pionka na niedozwolone pole.

## Przeciwnicy

&kbackgammon; służy tylko jako interfejs i daje graczowy planszę gry. Cała rozgrywka (rzuty kośćmi, itp;) prowadzone są przez zewnętrzne programy.

### Gra na zmianę

Tryb Gra na zmianę pozwala zagrać ze sobą, lub z drugą osobą przy jednym komputerze.

### Serwer FIBS

FIBS to skrót od First Internet Backgammon Server- społeczności graczy w backgammona, dostępnej 24 godziny na dobę, w której można spotkać zarówno początkujących graczy jak i ekspertów.

Oprócz rozgrywki, FIBS pozwala zapisywać stan gry, rozmawiać z innymi graczami, oraz posiada złożony system rankingu graczy.

Dostępna jest także obszerna strona internetowa website na której fani gry moga znaleźć różne ciekawe informacje.

### Silnik &GNU; backgammon.

Tryb GNUbg nie jest jeszcze gotowy, ponieważ nie został jeszcze do końca zaimplementowany(mimo, że posiada odpowiednią opcję w menuPrzeciwnik). Tak więc opis korzystania z tego programu można na razie pominąć.

Tryb rozgrywki z GNUbg wymaga posiadania zainstalowanego w systemie programu GNUbg. &kbackgammon; uruchamia go w tle i wykorzystuje go do prowadzenia rozgrywki. Działanie to jest niewidoczne dla użytkownika , a kontrola nad rozgrywką zapewniona jest przez &kbackgammon;.

Pomoc w implementacji obsługi GNUbg w &kbackgammon;jest mile widziana &kbackgammon;. Zainteresowani proszeni są o kontakt z autorem, lub przysyłanie gotowych fragmentów kodu. Jednymi z trudniejszych wyzwań są analiza sytuacji oraz zapis i odczyt stanu gry. W tej chwili jednak najważniejszym zagadnieniem jest umożliwienie samej rozgrywki.

W &kbackgammon; jedna rzecz nigdy nie zostanie zaimplementowana - granie na serwerze FIBS programem GNUbg. Używanie komputerowego programu w celu poprawienia swojego rankingu jest niedozwolone.

## Opcje gry

Opcje gry &kbackgammon; zmienia się wybierając Ustawienia Konfiguruj &kbackgammon;... z paska menu. To spowoduje pokazanie się okna dialogowego.

## Opis menu i skróty klawiszowe

W tym rozdziale opisane są wszystkie polecenia dostepne na pasku menu.

### Menu Gra

&Ctrl;N Gra Nowy

- Rozpoczyna nową grę. Opcja ta powoduje otworzenie okna, w którym można wpisać imiona obu graczy.

&Ctrl;P Gra Drukuj...

- Drukuje obrazek z aktualnym stanem planszy.

&Ctrl;Q Gra Zakończ

- Zakończ powoduje wyjście z &kbackgammon;

### Menu Przenieś.

&Ctrl;Z Przenieś Cofnij

- Cofa ostatnio wykonany ruch.

&Ctrl;&Shift;Z Przenieś Przywróć

- Ta opcja pozwala na przywrócenie ostatnio cofniętego ruchu.

Przenieś Odśwież

- Rysuje planszę od nowa.

&Ctrl;R Przenieś Rzuć kością

- Rzuca kośćmi.

Przenieś Zakończ turę

- Informuje drugiego gracza o zakończeniu tury.

Przenieś Kostka dublująca

- Oferuje przeciwnikowi (przed wykonaniem rzutu kośćmi) podwojenie aktualnej stawki rozgrywki. Jeżeli przeciwnik odrzuci tą ofertę - przegrywa.

Przenieś Przeciwnik

- Pozwala wybrać przeciwnika (Gra na zmianę, FIBS, GNU Backgammon, Nowa generacja)..

### Menu Polecenie

To menu zawiera różne ustawienia, zależnie od wybranego przeciwnika.

Tryb Gra na zmianę

Polecenie Nowa Gra

- Rozpoczyna nową grę. Opcja ta powoduje otworzenie okna, w którym można wpisać imiona obu graczy.

Polecenie Tryb edycji

- W tym trybie na planszy mozna wykonywać ruchy nie dozwolone przez reguły gry (oparte o aktualny wynik rzutu kośćmi).

Polecenie Zmień kolory

- Zamienia kolory pionków graczy na przeciwne.

### Menu Ustawienia

&Ctrl;M Ustawienia Ukryj menu

- Ukrywa pasek menu.

Ustawienia Paski narzędzi Główny pasek narzędzi (&kbackgammon;)

- Ukrywa główny pasek narzędzi

Ustawienia Paski narzędzi Przyciski poleceń (&kbackgammon;)

- Ukrywa pasek narzędziowy Polecenia

Ustawienia Ukryj pasek stanu

- Pokazuje lub ukrywa pasek stanu.

Ustawienia Zapisz ustawienia

- Zapisuje aktualne ustawienia i czyni je domyślnymi dla &kbackgammon;.

Ustawienia Konfiguracja skrótów...

- Otwiera okno konfiguracji skrótów klawiszowych. Ta opcja pozwala na zmianę domyślnych skrótów klawiszowych w &kbackgammon; lub na dodanie nowych.

Ustawienia Konfiguracja pasków narzędzi...

- Otwiera okno konfiguracji paska narzędzi. Można dodawać i usuwać przyciski odpowiadające poleceniom gry &kbackgammon; za pomocą tej opcji.

Ustawienia Konfiguracja &kbackgammon;...

- Otwiera okno pozwalające zmienić ustawienia gry &kbackgammon;.

### Menu Pomoc

&kbackgammon; posiada standardowe dla aplikacji &kde; menu Pomoc z jedną dodatkową pozycją:

Pomoc Backgammon w sieci

- Otwiera następujące strony : stronę domową serwera FIBS, stronę z regułami gry backgammon, lub stronę gry &kbackgammon; w przeglądarce &konqueror;.

Standardowe pozycje w menu Pomoc dostępne w aplikacjach &kde;to:

&help.menu.documentation;

### Domyślne skróty klawiszowe

W poniższej tabeli zebrano domyślne skróty klawiszowe &kbackgammon;.

### Przypisania klawiszy

Kombinacja klawiszy | Czynność
&Ctrl;N | Nowa gra
&Ctrl;R | Rzuć kością
&Ctrl;P | Drukuj
&Ctrl;Q | Wychodzi z &kbackgammon;
F1 | Pomoc
&Shift;F1 | Narzędzie pomocy kontekstowej
&Ctrl;M | Ukryj menu
&Ctrl;Z | Cofa ostatni ruch
&Ctrl;&Shift;Z | Ponownie wykonuje ostatnio cofnięty ruch

Skróty te można zmienić z menu Ustawienia Konfiguracja skrótów dostępnego na pasku menu.

## Zasługi i licencja

&kbackgammon;

Prawa autorskie 1999-2000 &Jens.Hoefkens; &Jens.Hoefkens.mail;

Oryginalna dokumentacja - 2000 &Jens.Hoefkens; &Jens.Hoefkens.mail;

Marcin Kowalskiyoshi314@gmail.com

&underFDL; &underGPL;

## Instalacja

### Gdzie znaleźć &kbackgammon;

&install.intro.documentation;

Strona domowa gry &kbackgammon; znajduje się pod adresem http://backgammon.sourceforge.net. Można na niej znaleźć informacje o programie i o najnowszej wersji.

### Kompilacja i instalacja

&install.compile.documentation;