Obecnie PbnTools posiada następujące funkcjonalności:
Program uruchamia się otwierając plik PbnTools.exe (Windows) lub pbntools (linux).
Niektóre pliki rozpowszechniane są na bardziej liberalnej licencji MIT, ale dotyczy to tylko tych plików, które zawierają nagłówek MIT.
Program korzysta z następującego oprogramowania:
Wersja Windows korzysta także z:
Ten dokument html został wygenerowany przy użyciu translatora LaTeX2HTML.
Kody źródłowe dostępne są w dziale Pobieranie (5.2).
Funkcjonalności Pobierz... dostępne są przez przycisk
Pobierz rozdania. Dalej możemy wybrać rodzaj turnieju lub tylko
wpisać link i zostawić opcję wykryj-automatycznie.
Kops to program napisany przez Jana Romańskiego, używany do prowadzenia turniejów brydżowych. Umożliwia on również zapis wyników turniejów w formacie html, w którym później są one publikowane, m.in. na stronach Polskiego Związku Brydża Sportowego (PZBS). Wśród wyników prezentowanych przez Śląski Związek Brydża Sportowego największą popularnością wśród najlepszych graczy regionu cieszą się turnieje oznaczone Chorzów.
Lista rozdań wraz z wynikami zapisywana jest do jednego pliku z rozszerzeniem PBN. Pobrany plik PBN można następnie załadować do programu brydżowego i utworzyć na jego podstawie turniej. Utworzony w ten sposób turniej można rozegrać z komputerem lub innym użytkownikiem poprzez sieć. Funkcjonalności te posiada np. program Jack. Jack ma w Polsce promocyjną cenę i dostępny jest u Krzysztofa Jassema
Program wymaga podania linku do turnieju. Chodzi tu dokładnie o link o nazwie Wyniki, który prowadzi do dwuczęściowego ekranu: z wynikami turnieju i rozkładami rozdań. Wygenerowane pliki umieszczone zostają w katalogu wyjściowym (Konfiguracja) w podkatalogu kops. Podkatalog utworzony zostanie automatycznie.
Uwaga do pobierania linków z warszawskiego serwera warsbrydz:
Po wejściu w Wyniki i wybraniu cyklu, nie wybierajcie od razu turnieju.
Zamiast tego wybierzcie Stare.
Otrzymacie staromodną listę turniejów i teraz już normalnie:
prawy przycisk, kopiuj adres odnośnika (to na Firefoxie, na innej
przeglądarce będzie nieco inaczej, ale w ten deseń) i wkleić do PbnTools.
Teraz już zadziała.
Efektem działania tej opcji programu są następujące pliki:
XXX_wyn.pbn - plik z rozdaniami i wynikami - na podstawie tego pliku generujemy turniej w Jacku
XXX.pbn - plik z rozdaniami turnieju (XXX to nazwa turnieju, np. MCH0308)
roz.html - lista travellerów całego turnieju
links.txt - zawiera m.in. link do oryginału turnieju, ułatwiający analizę porozdaniową
pNN.html - traveller dla rozdania o numerze NN
Efektem ubocznym działania tej funkcji jest również zapisanie w katalogu roboczym kompletnej strony z wynikami turnieju. Po wrzuceniu tego katalogu np. na komórkę, można potem wygodnie analizować rozdania tuż po ich rozegraniu.
Pary to również program Jana Romańskiego, który miał zastąpić Kopsa, a ostatecznie funkcjonuje równolegle z nim. Turnieje wygenerowane tym programem poznać po stopce Pary.4.1.0.23 (C) Jan Romański'2005, strona wygenerowana .... Turnieje takie można znaleźć na przykład wśród wyników turniejów na stronie warsbrydz, cykl WOB. Linki otrzymujemy po wybraniu pseudoturnieju Stare, a następnie już normalnie - prawy przycisk, Kopiuj adres odnośnika.
Efektem działania tej opcji programu są następujące pliki:
XXX.pbn - plik z rozdaniami i wynikami
AAyymmddnnn.html - travellery poszczególnych rozdań.
Każdy z nich stanowi jednocześnie indeks umożliwiający przejście do
pozostałych rozdań turnieju.
links.txt - zawiera m.in. link do oryginału turnieju, ułatwiający analizę porozdaniową
Bridge Base Online to najpopularniejszy serwer do sieciowej gry w brydża. Spotkać tam można światowej klasy sławy, również polską czołówkę. Rozegrane turnieje czy rozdania można analizować poprzez stronę www, na której przechowywane są wszystkie rozdania. Kłopotliwe jest jednak np. przeanalizowanie licytacji lub wistu na wszystkich stołach. Dzięki ściągnięciu turnieju do pliku PBN, można wygodnie analizować turniej w swoim lokalnym programie brydżowym. Podczas otwierania takiego pliku w Jacku, bardzo szybko można przejrzeć te elementy (licytacja, rozgrywka) na wszystkich stołach.
Innym zastosowaniem ściągniętych z Bbo plików będzie rozegranie rozdań z turnieju, który odbył się w internecie. Jest to o tyle lepsze od rozegrania turnieju z Kopsa, że w pliku PBN będziemy mieć także licytację i rozgrywkę ze wszystkich stołów. Tak dokładnej informacji Kops nam nie dawał.
Obciążenie serwera Bbo przy zastosowaniu ściągania przez PbnTools jest niewielkie. Tyle, co byśmy kliknęli po kolei w każdego travellera.
Użyj opcji Pobierz rozdania / Typ rozdań: Bbo.
Który dokładnie link wkleić do PbnTools? Na stronie Bbo wchodzimy w Hand Records, następnie results of recent tournaments. Dalej np. Pairs. Właściwym linkiem jest boards. Przykładowy link do turnieju Bbo wygląda tak:
https://www.bridgebase.com/myhands/hands.php?tourney=1234-1234567890-
Efektem działania tej opcji programu są m.in. następujące pliki, umieszczane w katalogu zgodnym z nazwą turnieju, pod katalogiem roboczym:
XXX.pbn - plik z rozdaniami i wynikami
hands.php?tourney....html - lista travellerów
hands.php?traveller....html - travellery
*.lin - pliki lin (format Bbo), jeden na rozdanie
links.txt - zawiera m.in. link do oryginału turnieju, ułatwiający analizę porozdaniową
Użyj opcji Pobierz rozdania / Typ rozdań: Bbo Hand records.
Link do historii rąk uzyskujemy po naciśnięciu Get hands na ekranie Hand records. Przykładowy link:
https://www.bridgebase.com/myhands/hands.php?username=playersnick&start_time=1617573600&end_time=1617746400
Tournament Calculator to obecny program używany na polskich turniejach, np. MZBS. Zastąpił Kopsa i Pary. Do pobrania używamy głównego linku z wyników, czyli np. 260330.
Efektem działania tej opcji programu są następujące pliki:
XXX.pbn - plik z rozdaniami i wynikami
nnn.json - kompletne dane rozdania
links.txt - zawiera m.in. link do oryginału turnieju, ułatwiający analizę porozdaniową
Nie wiem, czy sprawdzą się kamery ze stałym focusem. Kamery z autofocusem mogą wymagać dalszego dostosowania programu zbarcam, który obecnie nie ma opcji włączania / wyłączania autofocusa na żądanie. Mógłbym się tym zająć, gdybym miał kamerę z autofocusem do testów.
Podczas testów z moimi kartami wpadłem w interesującą pułapkę. Mianowicie nagle ni stąd, ni zowąd, program rozpoznawał kartę król karo. Okazało się, że król kier ma króla karo we włosach, a dokładniej jego kod. Trzeba więc było włoski trochę przemalować, mazakiem. I odtąd już było dobrze.
Konwersji z formatu LIN na PBN można dokonać z interfejsu graficznego lub z linii poleceń.
/dev/video1. Domyślnym urządzeniem jest urządzenie nr 0, czyli pierwsze.
Pełna lista opcji dla zbarcam dostępna jest w pliku zbarcam.html.
Firefox/25.0.
Wersja PbnTools poniżej 1.2.0 przedstawiała się jako Java, a to
powodowało, że niektóre serwery nie zezwalały na połączenie, błąd 403.
Od wersji 1.2.0 domyślny tekst User agent to PbnTools/1.2.0.
Dzieje się tak, gdy parametr jest pusty. Jeżeli wpiszemy tu jakiś
tekst to, będzie on użyty zamiast PbnTools i numeru wersji.
To tak na wszelki wypadek, gdyby serwery rozmyślnie lub przypadkiem
blokowały PbnTools.
Część funkcjonalności programu dostępna jest w trybie linii poleceń, czyli bez uruchamiania graficznego interfejsu użytkownika (okienek dialogowych). Na przykład pobrać turniej można albo uruchamiając program i następnie klikając Pobierz turniej Kops, albo uruchamiając program w następujący sposób:
pbntools -dtk http://www.strona-turniejow.pl/turniej999/index.html
Opcje linii poleceń można uruchamiać również poprzez bezpośrednie uruchomienie pliku jar, przykładowo:
java -jar PbnTools.jar -dtk http://www.strona-turniejow.pl/turniej999/index.html
Z linii poleceń dostępne są następujące opcje:
-h
Wyświetla krótki opis wszystkich opcji.
---debug
Włącza tryb debuggowania, z wyświetlaniem informacji, które mogą
pomóc w diagnostyce nieprawidłowego działania programu.
---verbose
Zwiększa ilość informacji wyświetlanej przez program, np. podczas pobierania
turnieju.
-dtb <link>
Pobiera turniej w formacie Bbo ze wskazanego linku. Turniej
zapisywany jest w katalogu roboczym, tak samo jak przy użyciu interfejsu
graficznego.
-dtbh <link>
Pobiera historię rąk w formacie Bbo ze wskazanego linku.
-dtk <link>
Pobiera wskazany turniej w formacie Kops.
-dtp <link>
Pobiera wskazany turniej w formacie Pary.
Dodatkowej konfiguracji programu można dokonywać poprzez konfigurację właściwości maszyny wirtualnej Java (JVM). Dostępne są następujące opcje:
user.language Wymuszenie języka komunikatów
(pl lub en).
Przykładowe uruchomienie programu z zastosowaniem właściwości JVM:
java -Djsoup.log.folder=C:/temp/bbo-jsoup -jar PbnTools.jar -dtk http://www.strona-turniejow.pl/turniej999/index.html
Wymagana jest Java w wersji 6. Ze względu na wykorzystanie programu zbar wymagane są systemy operacyjne Windows lub Linux. Programy zewnętrzne zawarte są w pliku instalacyjnym i instalowane są automatycznie.
Aktualna wersja, 1.4.0:
Poprzednie wersje: 1.3.3: Windows Linux , 1.3.2: Windows Linux , 1.3.1: Windows Linux , 1.3.0: Windows Linux , 1.2.7: Windows Linux , 1.2.6: Windows Linux , 1.2.5: Windows Linux , 1.2.4: Windows Linux , 1.2.3: Windows Linux , 1.2.2: Windows Linux , 1.2.1: Windows Linux , 1.2.0: Windows Linux , 1.1.0: Windows Linux
Źródła bibliotek Apache HttpClient, Kotlin można pobrać z repozytorium mavena. Może się to odbyć automatycznie podczas budowania projektu narzędziem gradle.
zip do dowolnego nowego folderu.
Ten folder stanie się katalogiem programu PbnTools.
Uruchomiać należy plik pbntools z tego katalogu.
Folder instalacyjny, jak również wszelkie katalogi używane w programie, nie mogą zawierać spacji. Odpada więc np. katalog "Program Files".
Mam nadzieję, że program stanowi niezłą bazę do rozwoju w kierunku wielofunkcyjnego przybornika brydżowego. Sam nie dam rady doprowadzić go do pełnej postaci, dlatego postanowiłem udostępnić go na licencji umożliwiającej dalszy rozwój, w grupie programistów. Liczę na to, że znajdą się wśród Was chętni do ulepszania go. Nawet jeżeli nie jesteś programistą, możesz pomóc poprzez zgłaszanie błędów, uwag lub sugestii.
Program napisany jest w Javie.
Do dyspozycji mamy następujące narzędzia:
git clone https://github.com/jarekczek/pbntools.git
Przeglądanie on-line, strona PbnTools na sourceforge
Szczegóły pracy nad kodem źródłowym dostępne są w pliku README.SRC.txt, w archiwum kodu źródłowego, patrz: Pobieranie, 5.
%USERPROFILE%/.PbnTools/PbnTools.log).
10 zamiast T.
Jestem otwarty na sugestie. Będę wdzięczny za informacje o nieprawidłowym działaniu strony lub programu.
Jarek Czekalski, ostatnia modyfikacja 01.05.2026