home *** CD-ROM | disk | FTP | other *** search
-
- LessMore version 1.0
-
- Intrukcja obsîugi
-
-
- i. PRAWO
- ¯¯¯¯¯¯¯¯
- Program LessMore moûe byê rozprowadzany jako produkt niekomercyjny w
- oryginalnej, nie zmienionej formie wraz z dokumentacjâ i bibliotekami tylko
- pod warunkiem, ûe jego cena nie bëdzie wyûsza niû koszt noônika na którym
- bëdzie nagrany plus koszty kopiowania plus koszty przesyîki. Poniewaû program
- jest typu FREEWARE ûadna dodatkowa zapîata autorowi programu nie jest
- konieczna (ale mile widziana). Program nie moûe byê rozprowadzany komercyjnie
- bez pisemnej zgody autora.
-
- Autor programu LessMore nie ponosi ûadnej odpowiedzialnoôci za
- niepoprawne dziaîanie tegoû programu i wynikîe z tego ewentualne straty.
-
-
- ii. WSTËP
- ¯¯¯¯¯¯¯¯¯
- More... MuchMore... ..8^S .. . . LessMore ???
-
- Program LessMore jest rozbudowanym programem typu More. Moûna przy jego
- pomocy odczytywaê pliki jako standardowy tekst ASCII oraz dodatkowo jako (!)
- tzw. HEX DUMP - czyli wartoôci liczbowe wraz z ich odpowiednikami z tabeli
- znaków ASCII. Odczytywane pliki mogâ byê skompresowane przy pomocy
- PowerPackera (© Nico François) Do kaûdego pliku moûna dobraê (!)
- indywidualnie odpowiedni zestaw fontów (np. polskich), rozdzielczoôê ekranu,
- wielkoôê tabulatora oraz tryb odczytu ASCII/HEX. Indywidualnie to znaczy, ûe
- istnieje moûliwoôê zapamiëtania (zapisania na dysku) odpowiednio ustawionych
- parametrów dla kaûdego pliku osobno. Dodatkowo istnieje takûe opcja
- poszukiwania odpowiedniego ciâgu liczb podanego bezpoôrednio w formie
- hexadecymalnej lub teû jako tekst ASCII.
-
-
- iii. OBSÎUGA
- ¯¯¯¯¯¯¯¯¯¯¯¯
- Wszystkie opcje programu zostaîy umieszczone w menu i podzielone sâ na
- trzy gîówne grupy:
-
- 1° Project - operacje podstawowe
-
- Load File... - Otwiera okno umoûliwiajâce wybór nowego pliku do
- wczytania. Wraz z plikiem wczytywane sâ i ustawiane odpowienie
- parametry.
-
- Sleep... - Posyîa program w stan "uôpienia". Zostaje zamkniety gîówny
- ekran programu. Na standardowym public screenie otwiera sië jedynie
- maîe okienko z nazwâ aktualnie wczytanego pliku. Powrót do
- normalnego stanu nastëpuje przez naciôniëcie prawego przycisku
- myszy przy uaktywnionym okienku programu. Jeûeli okienko to zostnie
- zamkniëte (poprzez naciôniecie gadgetu zamkniëcia okna) program
- zakoïczy pracë.
-
- About... - Wyôwietla kilka informacji o programie, nazwë jego public
- screenu oraz iloôê wolnej pamiëci.
-
- Quit - Zakaïcza pracë programu. UWAGA - program nie ûâda potwierdzenia
- tej czynnoôci.
-
- 2° Settings - parametry pracy
-
- View Mode - Umoûliwia wybór metody pokazywania pliku miëdzy trybem ASCII
- oraz HEX DUMP. Tryb ASCII - standardowy wyglâd tekstu (w linijkach,
- jedna pod drugâ). Tryb HEX DUMP - kaûdej linii odpowida 16 bajtów
- pliku w nastëpujâcej formie, kolejno: odlegîoôê "tego" miejsca od
- poczâtku pliku, cztery liczby (wielkoôci dîugiego sîowa kaûda), 16
- znaków odpowidajâcych tym liczbom.
-
- Smooth Scroll ? - Wîâcza/wyîâcza tryb pîynnego przesuwania tekstu. Jak
- to wyglâda najlepiej przekonaê sië samemu.
-
- Set Screen... - Otwiera okienko umoûliwiajâce wybór typu ekranu/monitora
- na jakim ma pracowaê program oraz iloôci kolorów na tym ekranie (2
- lub 4).
-
- Set Font... - Otwiera okienko wyboru fontu. Wyboru moûna dokonaê poprzez
- wskazanie odpowiedniej nazwy wraz z wielkoôciâ fontów lub teû przez
- wpisanie nazwy i/lub wielkoôci fontów. Jeûeli fonty o podanej
- wielkoôci nie istniejâ program automatycznie przeskaluje jeden z
- istniejâcych rozmiarów dopasowywujâc go do ûâdanej wielkoôci. Istnieje
- moûliwoôê podania peînej ôcieûki dostëpu, dziëki czemu moûna korzystaê
- z czcinek z katalogu innego niû FONTS: - niestety w takim przypadku
- program nie pokazuje spisu czcinek we wskazanym katalogu. UWAGA - Przy
- podawaniu ôcieûki dostëpu nie zaleca sië stosowania bezpoôrednio nazw
- urzâdzeï (np. DF0: DH0: itp.) tylko nazw dysków bâdú assignów. Moûna
- równieû stosowaê ôcieûki odnoône (np: /x/font.font lub :fonts/x.font).
-
- Set Tabs... - Sîuûy do ustawiania wielkoôci tabulatora.
-
- Load Settings - Odczytuje z dysku i ustawia parametry pracy programu. Do
- dyspozycji sâ trzy moûliwoôci:
- Default - Odczytane zostanâ parametry zapisane jako standardowe. Jeôli
- nie jest moûliwe ich odczytanie z dysku, zostanâ przyjëte wartoôci
- domyôlne. Zobacz teû: Save Settings as Default.
- from Icon - Odczytane zostanâ parametry zapisane pod ikonâ aktualnie
- wczytanego pliku. Poniewaû ikona moûe nie posiadaê zdefiniowanych
- niektórych parametrów bëdâ one ustawione z parametrów
- standardowych. Zobacz teû: Load Settings Default.
- from File... - Odczytane zostanâ parametry ze wskazanego przez
- uûytkownika pliku.
-
- Save Settings - Zapisuje na dysku aktualne parametry pracy programu. Do
- dyspozycji, podobnie jak w Load Settings, sâ trzy moûliwoôci:
- as Default - Zapisuje aktualnie ustawione parametry jako standardowe.
- Zapisane zostajâ wszystkie parametry oprócz View Mode. Miejsce
- zapisu zaleûy od sposobu uruchomienia programu. Jeôli program
- zostaî uruchomiony z Workbencha parametry zostanâ zapisane pod
- ikonâ programu. Jeûeli natomiast uruchomienie nastâpiîo z Shella
- parametry zostanâ zapisane jako plik w katalogu S: pod nazwâ
- LessMore.mprf. Z tychûe teû miejsc program bëdzie póúniej
- odczytywaî standardowe parametry. Zobacz teû: Load Settings
- Default.
- to Icon - Zapisuje ustawione parametry pod ikonâ aktualnie wczytanego
- pliku.
- to File... - Zapisuje parametry do wskazanego przez uûytkownika pliku.
- W celu wyboru odpowiedniego katalogu i nazwy pliku program otwiera
- specjalne okno. Jeûeli parametry zostanâ nagrane pod zaproponowanâ
- nazwâ przy wczytywaniu pliku program automatycznie odczyta takûe
- plik parametrów. Zobacz teû: Load Settings from File.
-
- 3° Search/Move - poszukiwanie ciâgu i przemieszczanie sië
-
- Find Previous - Korzystajâc z ustawionego wzorca przeszukuje plik w górë.
- Znaleziony odpowiednik zostaje zaznaczony jako tekst w negatywie.
- Zobacz teû: Search for ASCII/HEX.
-
- Find Next - Korzystajâc z ustawionego wzorca przeszukuje plik w dóî.
- Znaleziony odpowiednik zostaje zaznaczony jako tekst w negatywie.
- Zobacz teû: Search for ASCII/HEX.
-
- Search for ASCII... - Otwiera okienko umoûliwiajâce podanie wzorca w
- formie tekstu ASCII. Wzorzec ten bëdzie porównywany bez wzglëdu na
- wielkoôê liter.
-
- Search for HEX... - Otwiera okienko umoûliwiajâce podanie wzorca w postaci
- ciâgu liczb hexadecymalnych (np: ab120c3, FFC000, itp.).
-
- Goto line... - Pokazuje plik poczynajâc od wskazanej linii.
-
- Goto byte... - Pokazuje plik poczynajâc od linii w której znajduje sië
- wskazany bajt.
-
- Przeglâdany plik moûna przesuwaê przy pomocy klawiszy kursorów lub
- klawiatury numerycznej (wykorzystujâc teû klawisze Home, End, Pg Dn i Pg Up).
- Kombinacje strzaîek z klawiszami Alt, Ctrl i Shift umoûliwiajâ ponadto:
- 1° z Alt - przesuwanie o 12 linii/znaków;
- 2° z Ctrl - przesuwanie "do koïca";
- 3° z Shift - przesuwanie o wielkoôê strony/ekranu.
-
-
- iiii. URUCHOMIENIE
- ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
- Program moûna uruchomiê na dwa sposoby:
-
- 1° Z poziomu Shella -
- - Poprzez podanie nazwy programu i ewentualnie nazwy pliku oraz
- parametrów pracy. Jeôli nazwa pliku nie zostanie podana program otworzy
- odpowiednie okienko w celu wyboru pliku do odczytu. Nie podane parametry
- bëdâ przyjëte z pliku S:LessMore.mprf.
-
- Format:
- LessMore [<nazwa>] [<parametry>]
-
- Prykîad:
- LessMore LessMore.dok TABSIZE=4 FONTNAME=topazpl.font FONTSIZE=16
-
- Wczytuje plik LessMore.dok, ustawia tabulator na 4 oraz przyjmuje
- aktualnâ czcionkë na topazpl o wielkoôci 16.
-
- Spis dostëpnych parametrów znajduje sië w punkcie PARAMETRY PRACY.
-
- LessMore moûe byê programem rezydentnym. Moûna go wczytaê do pamiëci
- komendâ C:Resident, a nastëpnie uruchamiaê bez potreby kaûdorazowego
- wczytywania go z dysku. UWAGA: Program nie moûe byê jednak w takim
- przypadku skompresowany do formy samouruchamialnej.
-
- 2° Z Workbencha -
- - LessMore moûna uruchomiê na trzy sposoby:
- a) Poprzez podwójne klikniëcie na ikonie programu.
- b) Poprzez pojedyïcze klikniëcie na ikonie programu oraz podwójne z
- wciôniëtym klawiszem Shift na ikonie pliku od wczytania.
- c) Poprzez podanie w ikonie pliku do odczytu nazwy programu ze ôcieûkâ
- dostëpu jako default tool a nastëpnie podwójne klikniëcie na ikonie
- tegoû pliku.
-
-
- v. PARAMETRY PRACY
- ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
- Program LessMore umoûliwia indywidualne ustawienie odpowiednich parametrów
- pracy dla kaûdego pliku osobno. Moûliwe jest to dziëki wykorzystaniu do
- przechowywania tychûe parametrów ikony danego pliku lub w razie jej braku
- specjalnego dodatkowego pliku przechowywujâcego parametry (moûliwe jest
- równieû wykorzystywanie obu tych form jednoczeônie).
-
- 1° Ikona (nazwa.info)
- Najczytelniejszâ i zalecanâ matodâ jest przechowywanie parametrów pod
- ikonâ pliku. Dostëp do nich i ich modyfikacja jest prosta i moûliwa nawet
- bez potrzeby wczytywania programu LessMore. Spis parametrów jest dostëpny
- w ikonie jako Tool Types, a zmian najlepiej dokonywaê przy pomocy opcji
- Workbencha Information... z menu Icons. W momencie wczytywania pliku
- program sprawdza istnienie ikony i automatycznie ustawia z niej parametry.
- Oto lista dostëpnych parametrów (dokîadny opis ich znaczenia moûna znaleúê
- w punkcie 2. OBSÎUGA menu Settings), w nawiasach klamrowych znajdujâ sië
- wartoôci ustawiane domyôlnie jeûeli parametr nie jest podany (a
- uûytkownik nie zdefiniuje innych standardowych wartoôci - patrz
- OBSÎUGA menu Settings Load/Save Settings Default):
-
- VIEWMODE - Ustala sposób prezentacji pliku:
- =ASCII - patrz menu Settings ViewMode ASCII,
- =Hex - patrz menu Settings ViewMode HEX DUMP,
- =Smart - program automatycznie rozpozna typ pliku i wybierze
- miëdzy ASCII i HEX.
- {=Smart}
-
- SMOOTHSCROLL - Pîynny przesów tekstu:
- =Yes/No - wîâczony (Yes albo nic) lub wyîâczony (No).
- {=Yes}
-
- TABSIZE - Wielkoôê tabulatora:
- =n - gdzie n jest liczbâ caîkowitâ z zakresu 1 ÷ 16.
- {=8}
-
- DISPLAYID - Identyfikator typu ekranu/monitora:
- =x - gdzie x jest szesnastkowâ liczbâ caîkowitâ
- okreôlajâcâ typ ekranu na jakim ma otworzyê swój screen
- program (UWAGA - nie zaleca sië rëcznego ustawiania tego
- parametru).
- {program przyjmuje tryb aktualnie standardowego public screenu}
-
- DISPLAYDEPTH - Iloôê kolorów screenu:
- =d - gdzie d przyjmuje wartoôê 1 (2 kolory) lub 2 (4 kolory).
- {=2}
-
- FONTNAME - Nazwa czcionki (fontu):
- =name - gdzie name jest peînâ nazwâ czcionki (wraz z .font) wraz
- z ewentualnâ ôcieûkâ dostëpu.
- {=topaz.font}
-
- FONTSIZE - Wielkoôê czcionki (fontu):
- =size - gdzie size jest liczbâ caîkowitâ wiëkszâ od 1.
- {=8}
-
- Przykîady:
-
- VIEWMODE=ASCII
- SMOOTHSCROLL=No
- TABSIZE=4
- DISPLAYID=0x29000
- DISPLAYDEPTH=1
- FONTSIZE=8
- FONTNAME=topazpl.font
-
- SMOOTHSCROLL
- TABSIZE=1
- DISPLAYDEPTH=1
- FONTSIZE=16
-
-
- Te same parametry wraz z dodatkowym (NAME) obowiâzujâ przy uruchamianiu
- programu z poziomu Shella.
-
- [NAME] - (parametr opcjonalny) wskazujâcy nawë pliku do odczytu:
- =file - gdzie file jest nazwâ pliku do wczytania podczas
- uruchamiania programu.
- {program otworzy okno umoûliwiajâce wybór pliku do wczytania}
-
- Przykîad:
-
- LessMore NAME=LessMore.dok FONTNAME=topazpl.font
-
- LessMore TABSIZE=4 SMOOTHSCROLL=No ReadMe.txt
-
- 2° Plik (nazwa.mprf)
- W celu przechowywania parametrów zostaî opracowany specjalny format
- pliku zawierajâcy wszystkie niezbëdne do tego celu informacje. Program
- LessMore umoûliwia zarówno zapis jak i odczyt takiego pliku. Dodatkowo
- jeûeli aktualnie wczytywany plik posiada plik parametrów o swojej nazwie z
- rozszerzeniem .mprf (np: Instrukcja i Instrukcja.mprf) to program
- wczytujâc plik automatycznie wczyta i ustawi teû jego parametry.
-
- Format pliku jest nastëpujâcy:
-
- struct MorePrefs
- {
- ulong mp_Magic; /* identyfikator */
- uword mp_Version; /* wersja */
- uword mp_Size; /* wielkoôê pliku */
-
- ulong mp_TabSize; /* wielkoôê tabulatora */
- ulong mp_DisplayID; /* identyfikator ekranu */
- uword mp_DisplayDepth; /* "gîëbokoôê" ekranu */
- byte mp_ViewMode; /* tryb pokazywania */
- byte mp_SmoothScroll; /* pîynny przesów */
-
- uword mp_YSize; /* atrybuty czcionki */
- ubyte mp_Style; /* patrz: struct TextAttr */
- ubyte mp_Flags;
- char mp_FontName[MAXFONTPATH];
- };
-
- gdzie:
-
- mp_Magic - Zawsze równy "MPRF".
- mp_Version - Dla tej struktury równy 1.
- mp_Size - Dîugoôê pliku jest aktualnie zaleûna od dîugoôci nazwy
- czcionki (mp_FontName jest zapisywane tylko z pierwszym
- wystëpujâym za nazwâ zerem).
- mp_DisplayID - Standardowy identyfikator ekranu/monitora (patrz:
- <graphics/displayinfo.h>, graphics.library/GetVPModeID(), itp).
- mp_ViewMode - Gdzie:
- SMART_READ = -1L,
- ASCII_READ = 0L,
- HEX_READ = 1L.
- mp_SmoothScroll - Gdzie:
- NULL - No,
- x != NULL - Yes.
- mp_YSize - Wielkoôê czcionki.
- mp_Style - Nie brane pod uwagë.
- mp_Flags - Nie brane pod uwagë.
- mp_FontName - Peîna nazwa czcionki (razem z .font) i ewentualnâ
- ôcieûkâ dostëpu.
-
- Autor zastrzega sobie prawo do wyîâcznoôci ustalania innych wersji
- formatu pliku, zapewniajâc jednoczeônie kompatybilnoôê w dóî.
-
- *** UWAGA !!!
-
- Ze wzglëdu na doôê skomplikowany system skîadowania parametrów zostaîy
- ustalone pewne priorytety pozwalajâce zaprowadziê porzâdek i usystematyzowaê
- kolejnoôê dostëpu do nich.
-
- 1° Najniûszy priorytet majâ parametry ustalone jako standardowe. Przy ich
- ustawieniu bëdâ pokazywane tylko pliki nie majâce w ûaden inny sposób
- zdefiniowanych swoich parametrów.
-
- 2° Wyûszy priorytet majâ parametry zdefiniowane w dodatkowym pliku (.mprf).
- Jeûeli wczytywany plik posiada tak zdefiniowane parametry zastëpujâ one
- caîkowicie te zdefioniowane jako standardowe.
-
- 3° Najwyûszy priorytet majâ parametry zdefiniowene w ikonie pliku. Poniewaû
- jednak ikona nie musi posiadaê zdefiniowanych ich wszystkich, zastëpowane sâ
- tylko te zdefiniowane, a reszta pozostaje bez zmian.
-
- W skrócie dziaîanie programu podczas wczytywania pliku moûna przedstawiê
- nastëpujâco:
- 1° Wczytanie pliku.
- 2° Ustawienie parametrów standardowych:
- a) domyôlnych,
- b) z ikony programu (gdy program zostaî uruchomiony z Workbencha) lub
- z pliku S:LessMore.mprf (gdy program zostaî uruchomiony z Shella).
- 3° Sprawdzenie istnienia pliku parametrów i ewentualne zastâpienie nim
- wszystkich parametrów standardowych.
- 4° Sprawdzenie istnienia ikony i zastâpienie wskazanych w niej parametrów.
- 5° Otwarcie odpowiedniego screenu i wyôwietlenie pliku.
-
-
- vi. WYMAGANIA
- ¯¯¯¯¯¯¯¯¯¯¯¯¯
- Program LessMore moûna uruchomiê na kaûdej Amidze posiadajâcej Kickstart
- 2.0 lub wyûszy. Do pracy program potrzebuje nastëpujâcych bibliotek dyskowych:
-
- diskfont.library v37 (© Commodore-Amiga)
- reqtools.library v38 (© Nico François)
- powerpacker.library v35 (© Nico François)
-
- Skrypt instalujâcy biblioteki reqtools.library i powerpacker.library wraz z
- bibliotekami jest doîâczony do pakietu programu. Biblioteka diskfont.library
- znajduje sië standardowo na dysku Workbencha.
-
-
- vii. SZCZEGÓÎY TECHNICZNE
- ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
- Program LessMore otwiera wîasny PUBLIC SCREEN o nazwie "LESSMORE.x", gdzie
- x jest liczbâ (zapewnia ona róûnoôê nazw wszyskich screenów uruchomionych w
- jednej chwili programów LessMore). Nazwë screenu dla danego programu moûna
- uzyskaê wywoîujâc z menu Project opcje About.
-
- Program LessMore moûe byê programem rezydentnym moûliwym do zainstalowania
- w pamiëci komendâ C:Resident z wszystkimi zaletami jakie z tego wynikajâ.
- UWAGA ! Nie moûna go jednak w takim przypadku kompresowaê programami typu
- PowerPacker do postaci samouruchamialnej.
-
- Do napisania programu zostaîy uûyte:
- 1° A500 (MC68000 7MHz) + 0.5MB Chip 1.75 Slow + 2 FDD + Kick 2.04,
- 2° A1200 (MC68020 14MHz) + 2MB Chip + HDD 80MB + Kick 3.00,
- 3° Zepsuty monitor 1084,
- 4° 6241.2kWh energii elektryczej,
- 5° 3.5t jedzenia i picia,
- 6° i jeszcze 742 inne rzeczy.
-
- Tekst úródîowy programu jest napisany w jëzyku C, liczy (okoîo) 4500 linii
- i waûy (okoîo) 93kB.
-
-
- viii. HISTORIA
- ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
- *** Wersja 1.0ß
-
- 1° Pierwsza wersja testowa.
-
- *** Wersja 1.0
-
- 1° Poprawionych kilka wiëkszych i mniejszych bîëdów wersji testowej.
-
- 2° Pierwsza wypuszczona, peîna wersja.
-
-
- viiii. UWAGI, ADRES, SOURCE
- ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
- Jeôli posiadasz jakieô uwagi i sugestie na temat programu LessMore lub
- zauwaûyîeô jakieô nieprawidîowoôci w dziaîaniu tegoû programu napisz do mnie:
-
- Konrad Lepiarz
- ul. Katarzynki 7m9
- 80-884 Gdaïsk 1
- Polska
-
- Z góry dziëkuje...
-
-
- PS.
- Jeûeli jesteô zainteresowany zdobyciem tekstu úródîowego programu LessMore
- przeôlij 3 USD (lub ich równowartoôê) na mój adres, a otrzymasz program wraz z
- jego tekstem úródîowym w aktualnie najnowszej wersji. Nie zapomnij podaê
- swojego adresu !!!
-
-
- Enjoy !!!
-