From 9eb462772d4c54f5ebd8f6e84e97bf2e29e87f53 Mon Sep 17 00:00:00 2001 From: emkael Date: Fri, 16 Nov 2012 20:17:29 +0000 Subject: * release directory * README git-svn-id: https://svn.emkael.info/an9k@15 05ec0d5d-773b-4d93-9e23-c81a7ac79feb --- Analizator9000/Analizator9000/README.pl.txt | 221 +++++++++++++++++++++ Analizator9000/Analizator9000/README.txt | 212 ++++++++++++++++++++ .../Analizator9000/bin/Release/Analizator9000.exe | Bin 0 -> 789504 bytes .../Analizator9000/bin/Release/bin/cygwin1.dll | Bin 0 -> 2858355 bytes .../Analizator9000/bin/Release/bin/dealer.exe | Bin 0 -> 47616 bytes .../Analizator9000/bin/Release/bin/libbcalcdds.dll | Bin 0 -> 231424 bytes 6 files changed, 433 insertions(+) create mode 100644 Analizator9000/Analizator9000/README.pl.txt create mode 100644 Analizator9000/Analizator9000/README.txt create mode 100644 Analizator9000/Analizator9000/bin/Release/Analizator9000.exe create mode 100644 Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll create mode 100644 Analizator9000/Analizator9000/bin/Release/bin/dealer.exe create mode 100644 Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll diff --git a/Analizator9000/Analizator9000/README.pl.txt b/Analizator9000/Analizator9000/README.pl.txt new file mode 100644 index 0000000..81a996b --- /dev/null +++ b/Analizator9000/Analizator9000/README.pl.txt @@ -0,0 +1,221 @@ +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: + http://emkael.info/brydz/an9k/ + +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://emkael.info/brydz/an9k/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://emkael.info/svn/an9k/ + +P: Dlaczego przy próbie pobrania kodu źródłowego otrzymuję komunikat błędu o + nieprawidłowym certyfikacie HTTPS? +O: Bo jestem skąpym i leniwym bydlakiem, któremu nie chce się wykupić + porządnego certyfikatu SSL. Odcisk palca serwera: + 7c:48:1d:9a:73:d0:e6:2d:36:10:4d:d0:dc:f6:da:96:fb:3a:33:c7 + +P: Ale czy to nie znaczy, że ktoś może podszyć się pod serwer, na którym + znajduje się kod źródłowy, podmienić odcisk palca serwera na własny, a potem + podstawić mi złośliwy kod źródłowy, który skompiluję, uruchomię, a mój + komputer ukradnie mi dane moich wszystkich kart kredytowych, nakupi mnóstwo + śmieci na Allegro, a potem wybuchnie, kiedy będę potrzebować pilnie + wydrukować zeznanie podatkowe? +O: Dokładnie tak. Co więcej, ninejszy dokument dystrybuowany jest za + pośrednictwem nieuwietrzytelnionego połączenie HTTP, więc nic nie stoi na + przeszkodzie, że już się stało, a to pytanie jest tu tylko dla niepoznaki. + +P: W jakim środowisku powstał program? +O: Microsoft Visual Studio/Visual C# 2010. + +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 +================= + +2012.11 - 0.9 + * pierwotna wersja programu + +9. LICENCJA +=========== + +Licencja BSD (dwuklauzulowa) + +Copyright (c) 2012, 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? \ No newline at end of file diff --git a/Analizator9000/Analizator9000/README.txt b/Analizator9000/Analizator9000/README.txt new file mode 100644 index 0000000..a198432 --- /dev/null +++ b/Analizator9000/Analizator9000/README.txt @@ -0,0 +1,212 @@ +Analizator9000 - README + +0. TABLE OF CONTENTS +==================== + + 1. Introduction + 2. System requirements + 3. Installation + 4. User manual + 5. Source code + 6. Authors + 7. Support and contact information + 8. Changes history + 9. License + +1. INTRODUCTION +=============== + +Analizator9000 is an application which offers a graphical user interface for +statistical analysis of the number of tricks to be taken in a bridge deal +generated upon certain conditions. + +The software constitutes an interface for Dealer software and part of BCalc +project: libbcalcDDS library. To find out more on these projects, please refer +to the "AUTHORS" section. + +2. SYSTEM REQUIREMENTS +====================== + +Analizator9000 works within the .NET 3.5 Client Profile environment and as that +it requires a platfrom compatible with the .NET 3.5 framework. + +.NET 3.5 system requirements: + + * operating system: Windows XP/Vista/Server 2003/Server 2008/7/8 or newer + (Windows 7, Windows Server 2008 R2 and Windows 8 or newer + already provide .NET 3.5 with basic system installation) + * CPU: equivalence of Pentium 400MHz (minimum); Pentium 1GHz (recommended) + * memory: 96MB (minimmum); 256MB (recommended) + +Application-specific reqirements: + + * disaply: minumum resolution of 1024x600px; 16-bit colour + * free disk space: a minimum of 500MB (.NET 3.5) + 5MB (Analizator9000) + * additional free space: 1MB for full analysis per every thousand deals + +WARNING! + Using this application may require a substantial amount of resources +depending on the size of the commissioned task. Irresponsible runtime parameter +choice for deal generating/analysis may lead to recognizably long execution +time, to the limitation of application responding time or even to the limitation +of user's operating system usage experience. The author recommends a careful +choice of runtime parameters to ensure the recognition of application and system +performance capabilities. + +3. INSTALATION +============== + +The application is ready to use after unpacking it into a user's disk directory +of choice. + +The current version of the application is available from the project's homepage: + http://emkael.info/brydz/an9k/ + +After extraction, the software requires the existence of two directorys within +its working directory (provided within the archive): + + * bin/ directory - containing external software used by the analyzer + (lbcalcdds.dll file from the BCalc project, dealer.exe executable file + from project Dealer and cygwin1.dll library, required by Dealer) + * empty files/ directory - necessary for collecting application's output + files + +4. USER MANUAL +============== + +The description of usage, along with screenshots and examples, is available from +the project's homepage: + http://emkael.info/brydz/an9k/manual/ + +5. SOURCE CODE +============== + +Q: In which programming language is Analizator9000 written? +A: C#. + +Q: Can I see the source code? +A: Surely! + +Q: Where can I acquire it? +A: From the Subversion repository available at: + https://emkael.info/svn/an9k/ + +Q: Why do I keep getting the HTTPS certificate error while trying to retreive + the code? +A: Because I'm a cheap and lazy bastard and don't want to buy a proper SSL + certificate. Here's the server's fingerprint: + 7c:48:1d:9a:73:d0:e6:2d:36:10:4d:d0:dc:f6:da:96:fb:3a:33:c7 + +Q: But doesn't that mean that someone is able to spoof the source code server, + alter the fingerprint you've just provided with his own, and then substitute + the source code with his malicious one, which I'll later compile, run and my + computer will steal all my credit card's data, buys a lot of garbage on eBay + and explode in the exact moment I'll need it the most to print out my tax + form? +A: It does. What's more, this document is distributed through an unauthenticated + HTTP connection, so there's nothing stopping it from having already happened + and this question is just a decoy. + +Q: What's the environment you've used to create this software? +A: Microsoft Visual Studio/Visual C# 2010. + +Q: Can I ask you to write feature X into your software? +A: And I tell you, ask, and it will be given to you. + +P: I've written feature X into your source code. Can you add it to the your + release. +O: If it's sensible and I can comprehend its entire codebase without resorting + to alcoholic beverages stronger than 16-proof (US), I can't see why not. + +6. AUTHORS +========== + +Analizator9000: + Michał Klichowicz (mkl/emkael) + WWW: http://emkael.info + e-mail: emkael@tlen.pl + +Dealer: + Current code maintainer: Henk Uijterwaal + WWW: http://henku.home.xs4all.nl/html/dealer/authors.html + +Bridge Calculator (bcalc): + Piotr Beling + WWW: http://bcalc.w8.pl/ + +Application icon: + Tonev + WWW: http://www.iconarchive.com/show/windows-7-icons-by-tonev.html + +7. SUPPORT AND CONTACT INFORMATION +================================== + +Bug reports, feature suggestions and all other general comments should be +addressed directly to the author, via electrionic means. +The easiest way to communicate with the author is his e-mail inbox: + emkael@tlen.pl +You can also visit ForumBridge.pl and drop a private message to the user mkl: + http://www.forumbridge.pl/private.php?do=newpm&u=360 +or find an appropriate thread and leave an entry in it. + +All reported bugs will be investigated and attempted to fix if only the author +will find some capabilities to do so. It's expected from the user to be able to +provide basic information on how to reproduce the error with a bug report or to +have a sufficient overall computer skills to be able to collect those at the +author's prompt and with his guidance. + +The author reserves the right to approach feature requests with any amount of +scepticism the author finds appropriate. + +If you find my software useful and would like to thank me for it, write me an +e-mail and let me know you've liked it. +If you'd like to alter it, incorporate into a bigger project or propose a use +for it any other than purely recreational analysis, feel from to do so, just let +me know. +If you need my help with that, let me know, we'll see what we can do. +If you achieved some interesting results or curious conclusions with my +software, feel free to let me know about them. +If you're unsure whether you should write to me in a matter even slightly +related to my software, write me an e-mail. I like e-mails. + +If you find my software useful enough to want to thank me in a material way, +you're in a bad luck. I don't take donations, and this software is fully free +and non-commercial. I do like a decent book and a good beer, though. + +8. CHANGES HISTORY +================== + +2012.11 - 0.9 + * initial version + +9. LICENSE +========== + +The 2-clause BSD License + +Copyright (c) 2012, Michał Klichowicz +All right reserved + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +=== + +Who needs patience anymore, when all our pleasure's virtual? \ No newline at end of file diff --git a/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe b/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe new file mode 100644 index 0000000..ccbef28 Binary files /dev/null and b/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe differ diff --git a/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll b/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll new file mode 100644 index 0000000..71cde86 Binary files /dev/null and b/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll differ diff --git a/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe b/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe new file mode 100644 index 0000000..cb50b88 Binary files /dev/null and b/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe differ diff --git a/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll b/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll new file mode 100644 index 0000000..977fdde Binary files /dev/null and b/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll differ -- cgit v1.2.3