Moo Man 1.00
-------------
Copyright (c) 2004 Piotr Chodzinski


Opis
=====
Moo Man to bardzo prosty w obsludze, praktycznie nie wymagajacy konfiguracji program. Ma on na celu uprzyjemnienie korzystania z klienta kazdemu uczestnikowi bioracemu udzial w jednym z projektow koordynowanych przez Distributed.net. Aplikacja ta moze bowiem wydawac losowy dzwiek za kazdym razem gdy klient Distributed.net'u zakonczy przetwarzanie jednego pakietu skladajacego sie na projekt RC5-72 badz OGR. Dostarczony razem z programem zestaw dzwiekow pozwala przeksztalcic Twoj komputer z beznamietnego zbioru ukladow elektronicznych w prawdziwa kochajaca Cie krowke, ktora od czasu do czasu uroczo muczy specjalnie dla Ciebie :). A to juz prawdziwa gratka dla zwolennikow 'krowich projektow' ...

Zalety
=======
Pierwsze wersje klientow Distributed.net'u mialy wbudowana podobna funkcje jaka realizuje sam program Moo Man. Jednak z czasem postanowiono odejsc od idei zasmiecania plikow exe zbednym kodem i innymi skladnikami i usunieto opcje zwiazana z muczeniem. Pomysl ten bardzo nie spodobal sie uczestnikom projektu, powstal wiec program Moo Sounds uzupelniajacy ta wlasnie luke w kliencie. Aplikacja Moo Man ma kilka interesujacych zalet dzieki czemu powinna Ci sie o wiele bardziej spodobac niz oryginalny programu Moo Sounds. Oto lista glownych zalet:
* aplikacja Moo Man wspolpracuje z najnowsza wersja klienta, stad obsluguje projekty RC5-72 oraz OGR-25 oraz wszelkie przyszle wersje projektu OGR,
* program ten zostal napisany oraz przetestowany bardzo szczegolowo, tak aby zuzywal jak najmniejsza ilosc zasobow systemowych, pamieci, oraz aby nie spowalniac dzialania procesora, slowem aby jak najwiecej mocy obliczeniowej procesora pozostawalo dla klienta,
* mozesz nakazac aplikacji aby monitorowala tylko jeden z projektow, badz (np. chwilowo) zaden,
* program ten ukrywa sie pod postacia ikony umieszczonej w Zasobniku systemowym. Ikona ta moze zostac ukryta tak, aby obecnosc aplikacji byla calkowicie niezauwazalna,
* program Moo Man mozna latwo dostosowac do swych potrzeb podajac czestotliwosc z jaka program monitoruje zmiany zachodzace w katalogu klienta (patrz sekcja: Zasada dzialania),
* aplikacja ta automatycznie wykrywa katalog gdzie zainstalowany zostal klient. Katalog ten mozesz takze w szczegolnych przypadkach wskazac samemu,
* istnieje mozliwosc zmiany dzwiekow dostarczonych z aplikacja na inne.

Licencja
=========
Moo Man to program typu Freeware. Oznacza to, ze mozesz go uzywac za darmo do celow zarowno prywatnych jak i komercyjnych (czyli mozesz z niego korzystac np. w biurze). Jesli spodobal Ci sie na tyle, mozesz oczywiscie - jako wyraz Twojej wdziecznosci - wyslac mi pocztowke (patrz sekcja Kontakt), mala sume pieniedzy, lub jesli pracujesz w firmie - jakikolwiek gadzet z nia zwiazany, czy cokolwiek innego co uwazasz za stosowne. Pamietaj jednak ze program jest zupelnie darmowy i robisz to zupelnie z wlasnej nieprzymuszonej woli. Mozesz go takze dawac komu tylko chcesz, pamietajac jednak o tym aby przekazywac caly program tylko w formie oryginalnej - niezmodyfikownego archiwum ZIP.
Pomimo iz program zostal dokladnie przetestowany autor nie ponosi zadnej odpowiedzialnosci za powstanie ewentualnych szkod w oprogramowaniu, sprzecie czy reputacji uzytkownika. Zakazuje sie dekompilacji, dissasemblacji lub wszelkich innych dzialan majacych na celu modyfikacje lub poznanie wewnetrznych mechanizmow dzialania programu.
Przed zamieszczeniem programu na jakiejkolwiek stronie czy CD dolaczonym do jakiegokolwiek pisma jestes zobowiazany poinformowac o tym fakcie autora tego programu - czyli mnie (patrz sekcja Kontakt) !!!
Moo Man copyright (c) 2004 Piotr Chodzinski. Wszelkie prawa zastrzezone.

Instalacja
===========
Instalacja programu jest bardzo prosta. Wystarczy ze wykonasz wszystkie podane czynnosci:
* wypakuj wszystkie pliki zawarte w archiwum mooman.zip do dowolnego, wybranego przez Ciebie katalogu (np. C:\Program Files\Moo Man\),
* uruchom program MooMan.exe,
* uzywajac prawego przycisku myszy tuz nad nowa ikona z Zasobnika systemowego, wywolaj podreczne menu i wybierz pozycje Konfiguracja,
* uzyj przycisku Sciezka do klienta > Wykryj a nastepnie przycisku Autostart > Dodaj,
* na koniec kliknij przycisk OK by potwierdzic dokonane zmiany,
* to wszystko, odtad przy kazdym starcie systemu zostanie automatycznie uruchomiony program Moo Man.
Jesli chcesz mozesz takze dokonac innych zmian w dialogu Konfiguracja (patrz kolejna sekcja).

Konfiguracja
=============
Dialog Konfiguracja moze zostac wywolany poprzez wybranie pozycji Konfiguracja umieszczonej w menu podrecznym. Menu to jest dostepne po kliknieciu prawym przyciskiem myszy na ikonce umieszczonej w Zasobniku systemowym. Oto opis poszczegolnych opcji zawartych w tymze dialogu:
* Sciezka do klienta - pole to zawiera pelna sciezke do katalogu w ktorym zainstalowany zostal klient. Jesli sciezka nie miesci sie w calosci w tymze polu mozna ja obejrzec w pelni zatrzymujac nad nim na chwile kursor myszy,
* Sciezka do klienta > Wykryj - uzycie tego przycisku spowoduje automatyczne pobranie sciezki do klienta z odpowiedniego klucza rejestru,
* Sciezka do klienta > Wybierz - przycisk ten umozliwia samodzielne wskazanie katalogu za pomoca typowego dialogu wyboru folderu. Opcja ta moze byc przydatna w przypadku gdy automatyczne wykrycie katalogu zawiedzie,
* Sprawdzaj pliki co > x sekund - wpisana tutaj wartosc oznacza ilosc sekund pomiedzy powtorzeniami procedury sprawdzajacej zawartosc katalogu z klientem w celu wykrycia zapisu ukonczonego pakietu (patrz sekcja Zasada dzialania). Wartosc ta moze zawierac sie w przedziale od 1 do 999 sekund, przy czym podanie wartosci z przedzialu 1 - 10 nie jest zalecane,
* Zasobnik systemowy > Pokazuj ikonke - jesli opcja ta jest zaznaczona, to w trakcie dzialania programu w Zasobniku systemowym widoczna bedzie charakterystyczna ikonka. Odznaczenie tej opcji pozwala na calkowite ukrycie dzialnia programu, np. aby nie zasmiecac Zasobnika systemowego zbednymi ikonami. Klikniecie prawym przyciskiem myszy na wspomnianej ikonie pozwala wyswietlic menu podreczne zawierajace kolejne opcje:
   - Muuuuu - domysl sie co robi ta opcja :),
   - Konfiguracja - wyswietla omawiany wlasnie dialog Konfiguracja,
   - O programie - wyswietla dialog zawierajacy informacje o wersji programu
     a takze o kontakcie ze mna,
   - Zamknij - konczy dzialanie aplikacji,
* Monitoruj projekty > RC5-72/OGR - pola te pozwalaja wybrac ktore projekty powinny byc monitorowane przez program,
* Autostart > Dodaj/Usun - przyciski te umozliwiaja dodanie badz usuniecie skrotu wskazujacego na program Moo Man z folderu Autostart. Umieszczenie tego skrotu pozwala na automatyczne uruchamianie programu wraz ze startem systemu,
* OK - potwierdza i zapisuje zmiany,
* Anuluj - odrzuca wprowadzone zmiany.

Zasada dzialania
=================
Byc moze zastanawiasz sie wlasnie jak to dziala. Otoz zasada dzialania programu Moo Man jest bardzo prosta. Program przy starcie szuka we wskazanym katalogu plikow 'buff-out.r72' i 'buff-out.ogr' w ktorych klient przechowuje ukonczone pakiety. Rozmiar tych plikow zostaje zapamietany. Nastepnie rozmiar plikow jest okresowo sprawdzany, zas gdy odbiega on od poprzedniej wartosci - odtwarzany jest losowy dzwiek. Lista dzwiekow znajdujacych w katalogu WAV budowana jest za kazdym razem od nowa - tuz przed odtworzeniem dzwieku - po to, by upewnic sie ze zaden plik nie zostal w miedzyczasie dodany badz usuniety.

FAQ czyli czesto zadawane pytania 
==================================
P: Odznaczylem pole Pokazuj ikonke, jednak chcialbym zmienic konfiguracje programu. Jak wywolac okno Konfiguracja kiedy ikonka nie jest widoczna w zasobniku systemowym ?
O: Skasuj plik MooMan.ini z katalogu w ktorym znajduje sie program. Nastepnie uruchom go ponownie. Zostana przywrocone domyslne ustawienia.
P: Czy w programie ukryty jest tzw. Easter-Egg ?
O: Tak, zreszta jak zwykle :). Zapraszam do poszukiwan.

Historia wersji
================
Wersja 1.00 (31 marca 2004) - pierwsza oficjalna wersja programu. Wszystkie opcje sa juz w pelni sprawne.

Specjalne podziekowania
========================
Specjalne podziekowania naleza sie:
* mojej siostrze Justynie m.in. za korekte tego pliku pomocy oraz wsparcie psychiczne,
* autorowi programu Moo Sounds za udostepnienie zrodel aplikacji, co znacznie ulatwilo mi napisanie tego programu.

Kontakt
========
Jesli masz jakiekolwiek uwagi dotyczace programu, masz problem, a moze pomysl jak usprawnic go, lub chcesz po prostu pokorespondowac, pisz na adres:

aionel@poczta.onet.pl

Odwiedz takze moja strone domowa, na ktorej znajdziesz gry, programy, artykuly i wiele innych ciekawych rzeczy mojego autorstwa :). Adres strony to:

http://www.republika.pl/programyaionela

Moj adres domowy (do korespondencji papierowej lub wysylania pocztowek - patrz Licencja):

Piotr Chodzinski
ul. Jasna 4/3
44-100 Gliwice

Jesli nie wiesz czym sa projekty typu RC5 czy OGR koniecznie odwiedz oficjalna strone ich koordynatora:

http://www.distributed.net

lub przeczytaj artykuly znajdujace sie na mojej stronie omawiajace obszernie temat projektu RC5-64 oraz RC5-72.



Milego muuuuuczenia w projektach Distributed.net z drobna pomoca aplikacji Moo Man zyczy autor - Piotr Chodzinski :).



Dziekuje bardzo za przeczytanie pliku pomocy do konca.
Jestem pewien, iz dzieki temu bedziesz mogl lepiej wykorzystac moj program.
Zycze milej zabawy z aplikacja Moo Man !

Zadnej krowce nie stala sie krzywda podczas pisania tego programu :).

Program i plik pomocy ukonczony: 1 kwietnia 2004 o 18:27:12