======================Dokumentacja do StopMenu====================== =============================SHAREWARE============================== SPIS TREÔCI 1. O programie 2. Autor 3. Dystrybucja 4. Jak zarejestrowaê? 5. Uûytkowanie StopMenu 6. Uûytkowanie Prefs 7. Tworzenie pliku z opisem menu Stop 8. Inne ==================================================================== ============== 1. O programie ============== Program StopMenu po uruchomieniu nie jest widoczny od razu. Aby go zobaczyê musisz zjechaê kursorem myszy na dóî ekranu. Pojawi sië pasek (okno programu) z kilkoma przyciskami i zegarkiem. Dziëki przyciskom moûesz: -îatwo uruchamiaê swoje programy -kontrolowaê programy typu commodities -îatwo uruchamiaê preferencje programów (z katalogu SYS:Prefs/ ) -kontrolowaê ekrany i zapamiëtywaê je jako pliki iff -kontrolowaê okna na workbenchu Program moûna dostosowaê do swoich potrzeb za pomocâ programiku Prefs. Za jego pomocâ moûna zmieniê program nie do poznania. Za zawartoôê menu Stop odpowiada plik StopMenu.menus. Moûesz go edytowaê (za pomocâ dowolnego edytora tekstu - np. systemowego Ed-a) korzystajâc ze wskazówek zawartych w rozdziale 7. ======== 2. Autor ======== Mam 16 lat i chodzë do 2 klasy Liceum ogólnoksztaîcâcego. Od ok. 2 lat zajmujë sië programowaniem w jëzyku C. Ten program jest pierwszym moim programem za który trzeba pîaciê (wszystkie poprzednie miaîy status FREEWARE) i jednoczeônie jest najlepszy ze wszystkich moich programów. Jeôli zarejestruje sië nim wystarczajâca liczba osób, prace nad nim bëdâ kontynuowane. O tym co planujë umieôciê w drugiej wersji programu moûna przeczytaê w rozdziale 8. I jeszcze jedno - mój adres e-mail: tmsn@polbox.com ============== 3. Dystrybucja ============== StopMenu jest programem SHAREWARE. Oznacza to, ûe moûesz uûywaê niezarejestrowanej wersji przez 3 tygodnie. Po upîywie tego czasu musisz zastanowiê sië, czy chcesz dalej uûywaê tego programu. Jeôli tak, to MUSISZ go zarejestrowaê (patrz rozdziaî 4), a jeôli nie, to MUSISZ skasowaê go z dysku i wiëcej nie uûywaê. Niezarejestrowanâ wersjë moûesz kopiowaê za darmo komu tylko zechcesz i rozprowadzaê jâ bez ograniczeï. Jeôli zarejestrujesz program, otrzymasz specjalny plik-klucz (który uczyni twój program zarejestrowanym i wyîâczy pojawiajâce sië co jakiô czas komunikaty). UWAGA ! PLIKU-KLUCZA NIE WOLNO NIKOMU KOPIOWAÊ (ani w ûaden sposób powielaê, rozprowadzaê itp.) ===================== 4. Jak zarejestrowaê? ===================== Aby zarejestrowaê program naleûy uruchomiê programik register znajdujâcy sië w katalogu StopMenu:Extras/ lub kliknâê na przycisk register now w preferencjach. Po wybraniu jëzyka pojawi sië okno, w którym naleûy wpisaê swoje dane (WSZYSTKIE, no chyba ûe ktoô nie posiada adresu e-mail, to wtedy obëdzie sië bez niego), zaznaczyê czy chcemy dostaê klucz przez pocztë zwykîâ (droûej) czy nie (przez e-mail - taniej i szybciej!). Teraz naleûy wydrukowaê zamówienie lub wyôwietliê je i dokîadnie (i WYRAÚNIE) przepisaê na kartkë. Tak przygotowane zamówienie naleûy wîoûyê do koperty wraz z podanâ przez program rejestracyjny kwotâ pieniëdzy (15 zî lub 5 dolarów amerykaïskich przy wysyîce klucza przez e-mail lub 18 zî lub 8 USD przy wysyîce zwykîâ pocztâ). Uwaga! Jeôli chcesz dostaê plik-klucz pocztâ zwykîâ do zamówienia doîâcz teû czystâ dyskietkë, na którâ bëdë mógî nagraê klucz! Kopertë naleûy wysîaê na adres: Tomasz Wójcik ul. Grabowa 2 27-200 Starachowice POLAND Gdy tylko dostanë zamówienie, niezwîocznie wyôlë klucz. UWAGA! ZAMÓWIENIA NIE SPEÎNIAJÂCE PODANYCH WARUNKÓW (imië, nazwisko adres, ew. adres e-mail, PIENÂDZE, ew. dyskietka) NIE BËDÂ PRZJMOWANE! Wydaje mi sië, ûe 15 zî nie jest wygórowanâ cenâ i warto program zarejestrowaê. PAMIËTAJ! KUPUJÂC LEGALNE OPROGRAMOWANIE WSPIERASZ JEGO ROZWÓJ I TYM SAMYM WSPIERASZ AMIGË !!! ======================= 5. Uûytkowanie StopMenu ======================= Po zjechaniu wskaúnikiem myszy na dóî ekranu pokazuje sië pasek, na którym jest kilka przycisków. Kaûdy z nich otwiera inne menu. -Menu Stop W tym menu uûytkownik umieszcza najczëôciej uruchamiane programy, aby moûna byîo potem îatwo (i szybko) je uruchamiaê. -Menu Commodities Za pomocâ tego menu moûna îatwo i szybko kontrolowaê programy typu commodity. Moûna taki program usunâê, uôpiê, obudziê, przywoîaê lub odwoîaê. -Menu Preferences Za pomocâ tego menu moûna szybko uruchamiaê programy z katalogu SYS:Prefs/ -Menu Screens Za pomocâ tego menu moûna îatwo kontrolowaê ekrany (zmieniaê ich kolejnoôê, usuwaê, a takûe zapisywaê na dysku jako pliki IFF). UWAGA! Usuwanie ekranów moûe byê niebezpieczne, a w skrajnych przypadkach moûe doprowadziê do zawieszenia systemu! -Menu WBWindows Za pomocâ tego menu moûna îatwo kontrolowaê okna na workbenchu (zmieniaê ich kolejnoôê, usuwaê, uaktywniaê i zamykaê). UWAGA! Usuwanie okien (podobnie jak ekranów) moûe byê niebezpieczne, a w skrajnych przypadkach moûe doprowadziê do zawieszenia systemu! Kaûde menu moûna wyîâczyê klikajâc prawym przyciskiem myszy, lub klikajâc lewym przyciskiem, ale poza obszarem menu. Klikniëcie lewym przyciskiem na jakiejô pozycji w menu spowoduje jej wybranie. ==================== 6. Uûytkowanie Prefs ==================== Po uruchomieniu proramu konfiguracyjnego pokazuje sië okno podzielone na dwie czëôci. Po lewej stronie wybieramy grupë opcji, a ona pokazuje sië po prawej. W kaûdej grupie jest kilka opcji. -Grupa Info W tej grupie wyôwietlana jest informacja o programie, a takûe przycisk, dziëki któremu moûna przejôê do programu rejestracyjnego. -Grupa Colors W tej grupie wybieramy kolory poszczególnych elementów graficznych wystëpujâcych w programie, a takûe typ napisów wyôwietlanych w menu. Moûna zmieniê kolory: -MenuBack (tîo menu) -BarBack (tîo listwy) -Selected (wybrana pozycja) -Shine (jasny tekst) -Shadow (ciemny tekst) Kolory zmienia sië wpisujâc szesnastkowe (hxadecymalne) wartoôci RGB w postaci rrggbb, gdzie rr to wartoôê czerwonego skîadnika, gg zielonego, a bb - niebieskiego. Kaûdy skîadnik przyjmuje wartoôci od 00 do ff (czyli 255). Kilka przykîadów: Biaîy - ffffff Czerwony - ff0000 Ciemnozelony - 006b00 Szary - 939393 Czarny - 000000 Bîëkitny - 00ffff Ûóîty - ffff00 Fioletowy - dd00dd do przeliczana liczb na szesnastkowe (HEX) sîuûy np. program Y.A.C. (YetAnotherCalculator) autorstwa Pawîa Wójcika. Ja proponujë ustawiê nastëpujâce wartoôci kolorów: -MenuBack afafaf -BarBack 9f9f9f -Selected 1626b6 -Shine ffffff -Shadow 000000 -Grupa On/Off Tu wîâczamy i wyîâczamy kolejno: -Menu Stop -Menu Commodities -Menu Preferences -Menu Screens -Menu WBWindows -Zegarek -Tîo paska -Wklësîâ obwódkë zaznaczonej pozycji -Grupa Hotkeys Tu moûemy ustawiê klawisze wywoujâce: -Wyjôcie z programu -Program konfiguracyjny -Ponowny start programu oraz priorytet procesu (polecam 0 lub 1). -4 grupy SkipList W tych grupach moûemy ustaliê nazwy pozycji, których nie chcemy mieê w swoich menu Commodities (skiplist 1), Preferences (2), Screens (3), i WBWindows (4). Na dole okna mamy kilka przycisków: -Save (zapisanie ustawieï na dysk) -About (informacja o programie) -Iconify (sprowadzenie programu do ikony) -Quit (wyjôcie) ===================================== 7. Tworzenie pliku z opisem menu Stop ===================================== Plik StopMenu.menus moûna edytowaê za pomocâ dowolnego edytora testu (na przykîad systemowego Ed-a). Opis menu Stop powinien byê zawary pomiëdzy liniami i . Przedstawië teraz przykîad takiego opisu. MENU 1 ITEM Podmenu 1,,1,MENU,2 ITEM Podmenu 2,,1,MENU,3 ITEM Podmenu 3,,1,MENU,4 BAR ITEM Prefs,RUNPREFS,18,COMMAND ITEM Wyjôcie,QUIT,6,COMMAND MENU 2 ITEM Podmenu 4,,1,MENU,5 ITEM Jakaô pozycja,ôcieûka:program,2,CLI ITEM Inna pozycja,dysk:katalog/program,2,WB MENU 3 ITEM Pozycja 1,dysk:katalog/program,2,WB ITEM Pozycja 2,dysk:katalog/program,2,WB ITEM Pozycja 3,dysk:katalog/program,2,WB ITEM Pozycja 4,dysk:katalog/program,2,WB ITEM Pozycja 5,dysk:katalog/program,2,WB ITEM Pozycja 6,dysk:katalog/program,2,WB MENU 4 ITEM Proram CLI,ôcieûka:program,2,CLI ITEM Proram WB,ôcieûka:program,2,WB ITEM Skrypt,ôcieûka:skrypt,2,SCRIPT SPACE ITEM Restart,RESTART,6,COMMAND MENU 5 ITEM Kolejne podmenu,,1,MENU,6 MENU 6 ITEM Bla bla bla,,2,CLI ITEM Bla bla bla,,2,CLI ITEM Bla bla bla,,2,CLI Jak widaê, nie jest to zbyt trudne. Po linii musi buê linia MENU (która oznacza, ûe od tego miejsca zaczyna sië opis danego menu) a nastëpnie linie opisujâce poszczególne pozycje w menu. Dalej moûna umieôciê opisy kolejnych podmenu. Pozycje w menu mogâ byê trzech rodzajów: -ITEM (zwykîa pozycja) -BAR (pozioma linia) -SPACE (odstëp) Po wpisaniu ITEM musimy podaê kilka paramentrów (dziëki którym program bëdzie wiedziaî jaki napis wyôwietliê w menu i jaki program uruchomiê po wybraniu danej pozycji). Kolejne parametry oddziela sië od siebie przecinkiem. Pierwszym parametrem jest nazwa pozycji w menu. Zaleca sië stosowanie w miarë krótkich nazw (aby menu wyglâdaîo îadnie ...). Drugi parametr to nazwa pliku wraz ze ôcieûkâ. Tak wiëc jeôli chcemy aby dana pozycja uruchamiaîa na przykîad program "Ram Disk:program 1" jako drugi argument naleûy podaê Ram Disk:program 1. Trzeci parametr to numer ikony, która bëdzie wyôwietlona obok nazwy pozycji. Ikony znajdujâ sië w katalogu StopMenu:Icons/ i moûna je oglâdaê za pomocâ workbencha (jeôli ma sië zainstalowane NewIcons). Czwarty parametr to typ pozycji. Wyróûniamy piëê typów pozycji: -CLI (urucamiany plik jest programem CLI) -WB (urucamiany plik jest programem workbencha) -SCRIPT (urucamiany plik jest skryptem AmigaDOS-u) -MENU (pozycja sîuûy do otwierania kolejnego podmenu) -COMMAND (uruchomienie komendy wewnëtrznej) Komendy wewnëtrzne wpisuje sië w miejsce na nazwë pliku do wykonania. -QUIT (wyjôcie z programu) -RESTART (ponowne uruchomienie programu) -RUNPREFS (uruchomienie preferencji) -REBOOT (zresetowanie amigi) W przypadku podania typu MENU nie trzeba podawaê drugiego parametru (nazwa pliku), trzeba jednak podaê dodatkowy, piâty parametr, który okreôla numer menu, które bedzie otwierane przez danâ pozycjë. I jeszcze jedna uwaga: w liniach MENU nie trzeba podawaê numeru !!! Jest on caîkowicie ignorowany (liczy sië kolejnoôê), ale ja go podajë poniewaû uîatwia orientacjë i zwiëksza przejrzystoôê pliku. ======= 8. Inne ======= Jak tworzyê wîasne ikonki? -------------------------- Kaûdâ z ikon z katalogu StopMenu:Icons/ moûna podmieniê na swojâ. Moûna teû dodawaê nowe ikony (ich nazwy powinny byê kolejnymi liczbami np.: 45.info 46.info 47.info itd.). Robi sië to za pomocâ programiku InjectBrush (z pakietu NewIcons, jest takûe w StopMenu:Extras/). Przykîadowo aby zrobiê ikonë do menu naleûy: 1. Wykonaê 1 lub 2 brushe (maîe obrazki) o wymiarach max. 18x22 i zapisaê je jako (przykîadowo) Ram:1.bsh Ram:2.bsh. 2. Skopiowaê (przykîadowo) na ram: jakâô ikonë (najlepsza bëdzie StopMenu:Icons/Program/std.indo). 3. Wykonaê polecenie: InjectBrush ram:std.info ram:1.bsh FORCE lub w przypadku dwóch brushy InjectBrush ram:std.info ram:1.bsh ram:2.bsh FORCE 4. Skopiowaê ikonë do StopMenu:Icons/ jako np. 48.info Jeôli wykonamy ikonë z dwoma obrazkami, ten drugi bëdzie widoczny po zaznaczeniu pozycji z danâ ikonâ. Jak zdobyê nowe wersje ? ------------------------ Jak na razie jedynym úródîem nowych wersji programu jest AMINET. Prawdopodobnie w przyszîoôci zarejestrowani uûytkownicy bëdâ dostawaê najnowsze wersje przez e-mail. Kilka pomysîów na drugâ wersjë: ------------------------------- -Edytor menu Stop wbudowany w Prefs -System plug-in'ów. -Moûliwoôê zmiany czcionki -i kilka innych ... Moûecie teû sami przysyîaê propozycje zmian w drugiej wersji (oczywiôcie na adres tmsn@polbox.com ) Moje zalecenia: --------------- Polecam uruchamiaê program na ekranach o jak najwiëkszej liczbie kolorów. Tak w ogóle to najlepiej mieê ikonkë startera w WBStartup. (Ikonka ta znajduje sië w StopMenu:Extras/StopMenuStarter.info) I jeszcze jeden drobiazg: ------------------------- Pasek nie pojawia sië jeôli CapsLock jest wîâczony. ==================================================================== Tomasz "Th0m$0n" Wójcik ====================================================================