summaryrefslogtreecommitdiff
path: root/Analizator9000/Analizator9000/bin/Release/README.pl.txt
blob: 2e5a4586dee2d32171f4998ab34876a041a4bb3d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
Analizator9000 - README

0. SPIS ZAWARTOŚCI
==================

    1. Wprowadzenie
    2. Wymagania systemowe
    3. Instalacja
    4. Podręcznik użycia
    5. Kod źródłowy
    6. Autorzy
    7. Wsparcie i informacje kontaktowe
    8. Historia zmian
    9. Licencja

1. WPROWADZENIE
===============

Analizator9000 jest aplikacją oferującą graficzny interfejs użytkownika dla
analizy statystycznej liczby lew w rozdaniach brydżowych wygenerowanych na
podstawie określonych warunków.

Program stanowi interfejs dla programu Dealer oraz dla biblioteki libbcalcDDS,
będącej częścią projektu BCalc. Aby dowiedzieć się więcej o tych programach,
skieruj się do sekcji "AUTORZY".

2. WYMAGANIA SYSTEMOWE
======================

Analizator9000 działa w środowisku .NET 3.5 Client Profile i jako taki wymaga
platformy kompatybilnej ze środowiskiem .NET 3.5.

Wymagania sprzętowe platformy .NET 3.5:

    * system operacyjny Windows XP/Vista/Server 2003/Server 2008/7/8 lub nowszy
     (systemy Windows 7, Windows Server 2008 R2 oraz Windows 8 i nowsze
      dostarczają .NET 3.5 wraz z podstawową instalacją systemu)
    * procesor: równoważny Pentium 400MHz (minimalny); Pentium 1GHz (zalecany)
    * pamięć RAM: 96MB (minimalna); 256MB (zalecana)

Wymagania specyficzne dla aplikacji:

    * ekran: minimalna rozdzielczość 1024x600px; kolory 16-bit
    * wolne miejsce na dysku: minimum 500MB (.NET 3.5) + 5MB (Analizator9000)
    * dodatkowe miejsce na dysku: 1MB na pełną analizę każdego tysiąca rozdań

UWAGA!
    Aplikacja może potrzebować bardzo dużej ilości zasobów systemowych w
zależności od rozmiaru wykonywanego zadania. Nieodpowiedzialny dobór parametrów
generowania rozdań/analizy może doprowadzić do znacząco długiego czasu
wykonywania programu, zawieszenia jego działania bądź, w przypadkach skrajnych,
do ograniczenia jakości korzystania z systemu użytkownika. Autor zaleca
ostrożny dobór parametrów uruchomienia w celu rozpoznania wydajności aplikacji
i systemu użytkownika.

3. INSTALACJA
=============

Program jest gotowy do użycia po rozpakowaniu go do dowolnego katalogu na
lokalnym dysku twardym.

Aktualną wersję programu można pobrać ze strony domowej projektu:
    https://github.com/emkael/an9k/releases/

Program po rozpakowaniu niezbędnie wymaga obecności dwóch katalogów
(dostarczonych w archiwum):

    * katalogu bin/ - zawierającego programy zewnętrzne używane przez analizator
      (plik lbcalcdds.dll należący do projektu BCalc, plik wykonywalny
       dealer.exe, należący do projektu Dealer oraz bibliotekę cygwin1.dll,
       wymaganą do uruchomienia programu Dealer)
    * pustego katalogu files/ - do którego zapisywane są wyniki działania
      programu

4. PODRĘCZNIK UŻYCIA
====================

Opis użycia programu wraz ze zrzutami ekranu oraz przykładowymi wynikami
dostępny jest na stronie domowej programu:
    http://an9k.emkael.info/manual/

5. KOD ŹRÓDŁOWY
===============

P: W jakim języku programowania napisany jest Analizator9000?
O: C#.

P: Czy mogę zobaczyć kod źródłowy programu?
O: Oczywiście!

P: Skąd mogę go pobrać?
O: Z repozytorium Subversion dostępnego pod adresem:
    https://github.com/emkael/an9k/

P: Czy kod jest udokumentowany?
O: Starałem się, jak mogłem. Dokumentacja kodu w formie HTML oraz plikach MSHC/MSHA
   dostępna jest na stronie internetowej aplikacji:
    http://ank9.emkael.info/code/

P: W jakim środowisku powstał program?
O: Microsoft Visual Studio/Visual C# 2010 i 2022.

P: Czy mogę prosić o dopisanie kodu dla funkcjonalności X?
O: Proście, a będzie Wam dane.

P: Dopisałem do kodu funkcjonalność X. Czy możesz dołączyć ją do swojej edycji
   programu?
O: Jeśli jest sensowna i będę w stanie zrozumieć jej kod źródłowy bez
   konieczności uciekania się do napojów alkoholowych powyżej 8% zawartości,
   oczywiście.

6. AUTORZY
==========

Analizator9000:
    Michał Klichowicz (mkl/emkael)
    WWW: http://emkael.info
    e-mail: emkael@tlen.pl

Dealer:
    Obecny zarządca kodu: Henk Uijterwaal
    WWW: http://henku.home.xs4all.nl/html/dealer/authors.html

Bridge Calculator (bcalc):
    Piotr Beling
    WWW: http://bcalc.w8.pl/

Ikona programu:
    Tonev
    WWW: http://www.iconarchive.com/show/windows-7-icons-by-tonev.html

7. WSPARCIE I INFORMACJE KONTAKTOWE
===================================

Zgłoszenia błędów, sugestie usprawnień oraz wszelkie komentarze natury ogólnej
należy kierować bezpośrednio do autora, drogą elektroniczną.
Najłatwiej skontaktować się z autorem poprzez pocztę elektroniczną:
    emkael@tlen.pl
Można również odwiedzić ForumBridge.pl i podrzucić prywatną wiadomość
użytkownikowi mkl:
    http://www.forumbridge.pl/private.php?do=newpm&u=360
bądź odnaleźć na Forum odpowiedni wątek i dodać w nim wiadomość.

Zgłaszane błędy będą badane oraz poprawiane w miarę możliwości autora, przy
czym oczekuje się, że wraz ze zgłoszeniem błędu użytkownik będzie w stanie
dostarczyć podstawowych informacji służących do odtworzenia błędu bądź będzie
dysponować wystarczającymi umiejętnościami z zakresu ogólnej obsługi komputera,
by te informacje zebrać na prośbę autora.

Autor zastrzega sobie prawo do traktowania propozycji ulepszeń oraz zmian
funkcjonalnych z dowolnie dobraną dozą sceptycyzmu.

Jeśli znajdujesz mój program użytecznym, i chciałbyś mi za niego podziękować,
możesz napisać do mnie maila i dać mi znać, że Ci się spodobał.
Jeśli chciałbyś go przerobić, użyć jako część większego projektu lub
zaproponować jakiekolwiek inne jego zastosowanie poza hobbystycznymi analizami,
również napisz do mnie maila, zobaczymy, co się da zrobić.
Jeśli za pomocą mojego programu odkryłeś jakieś ciekawe wyniki bądź doszedłeś
do zaskakujących wniosków, tym bardziej napisz maila.
Jeśli nie jesteś pewien, czy napisać do mnie w jakiejś sprawie związanej z
programem, napisz maila. Lubię czytać maile.

Jeśli znajdujesz mój program na tyle użytecznym, żeby chcieć podziękować mi za
niego materialnie, masz pecha. Nie przyjmuję dotacji pieniężnych, a program
jest w pełni darmowy i niekomercyjny. Lubię za to również interesujące książki
i dobre piwo.

8. HISTORIA ZMIAN
=================

2024.02 - 0.13
    * poprawka błędu: program nie analizuje kontraktów, których częstość jest wyzerowana

2021.02 - 0.12
    * chińskie tłumaczenie, autorstwa Li Ruisheng
    * kosmetyka wyświetlania wyników/max/IMP względem rozgrywającego
    
2015.12 - 0.11
    * odświeżony interfejs
    * tłumaczenie interfejsu
    * pasek menu
    * zapis rozdań do PBN
    
2014.12 - 0.10
    * zakładka analizy kontraktów

2013.04 - 0.9.1
    * wymuszenie 32-bitowego formatu binariów (kompatybilność z 32-bitową DLL)

2012.11 - 0.9
    * pierwotna wersja programu

9. LICENCJA
===========

Licencja BSD (dwuklauzulowa)

Copyright (c) 2012-2024, Michał Klichowicz
Wszystkie prawa zastrzeżone

Redystrybucja i używanie, czy to w formie kodu źródłowego, czy w formie kodu
wykonywalnego, jest dozwolone pod warunkiem spełnienia poniższych warunków:

    * Redystrybucja kodu źródłowego musi zawierać powyższą notę o prawach
    autorskich, niniejszą listę warunków oraz poniższe oświadczenie o wyłączeniu
    odpowiedzialności.

    * Redystrybucja kodu wykonywalnego musi zawierać powyższą notę o prawach
    autorskich, niniejszą listę warunków oraz poniższe oświadczenie o wyłączeniu
    odpowiedzialności w dokumentacji i/lub w innych materiałach dostarczanych
    wraz z kopią oprogramowania.

TO OPROGRAMOWANIE JEST DOSTARCZONE PRZEZ MICHAŁA KLICHOWICZA "TAKIM, JAKIE
JEST". KAŻDA DOROZUMIANA LUB BEZPOŚREDNIO WYRAŻONA GWARANCJA, NIE WYŁĄCZAJĄC
DOROZUMIANEJ GWARANCJI PRZYDATNOŚCI HANDLOWEJ I PRZYDATNOŚCI DO OKREŚLONEGO
ZASTOSOWANIA, JEST WYŁĄCZONA. W ŻADNYM WYPADKU POSIADACZE PRAW AUTORSKICH NIE
MOGĄ BYĆ ODPOWIEDZIALNI ZA JAKIEKOLWIEK BEZPOŚREDNIE, POŚREDNIE, PRZYPADKOWE,
SPECJALNE, UBOCZNE I WTÓRNE SZKODY (NIE WYŁĄCZAJĄC OBOWIĄZKU DOSTARCZENIA
PRODUKTU ZASTĘPCZEGO LUB SERWISU, ODPOWIEDZIALNOŚCI Z TYTUŁU UTRATY
UŻYTECZNOŚCI, UTRATY DANYCH LUB KORZYŚCI, A TAKŻE PRZERW W PRACY
PRZEDSIĘBIORSTWA), SPOWODOWANE W JAKIKOLWIEK SPOSÓB, I W JAKIMKOLWIEK MODELU
ODPOWIEDZIALNOŚCI, KONTRAKTOWEJ, CAŁKOWITEJ LUB DELIKTOWEJ (WYNIKŁEJ ZARÓWNO Z
NIEDBALSTWA JAK INNYCH POSTACI WINY), POWSTAŁE W JAKIKOLWIEK SPOSÓB W WYNIKU
UŻYWANIA LUB MAJĄCE ZWIĄZEK Z UŻYWANIEM OPROGRAMOWANIA, NAWET JEŚLI O MOŻLIWOŚCI
POWSTANIA TAKICH SZKÓD OSTRZEŻONO.

===

Who needs patience anymore, when all our pleasure's virtual?