home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / blabla / swapperbox / swapperbox.doc < prev    next >
Text File  |  1998-01-24  |  16KB  |  354 lines
  1.  
  2.                                  SwapperBox
  3.  
  4.                  Wersja 1.1
  5.  
  6.                               Data 31.12.1995
  7.  
  8.              Copyright (c) 1995 Kysy/AM & 2xBla
  9.  
  10.  
  11.  
  12.                   Instrukcja obsîugi
  13.  
  14.  
  15.     Spis treôci:                          Numer linii:
  16.  
  17.         1. Prawa autorskie i rozpowszechnianie.                28.
  18.         2. Do czego ten program sîuûy?                           42.
  19.         3. Opis programu.                                      65.
  20.         4. Wymagania, biblioteki, dane techniczne.            115.
  21.         5. Komunikaty pîenduf.                                153.
  22.         6. Struktura danych.                                  194.
  23.         7. Co w przyszîoôci?                                  227.
  24.         8. Historia programu.                                 261.
  25.         9. Pozostaîe informacje.                              276.
  26.  
  27.  
  28. 1. Prawa autorskie i rozpowszechnianie.
  29.  
  30. Jest to program typu FreeWare. Oznacza to, ûe jego rozpowszechnianie
  31. jest nieodpîatne. Zastrzegam sobie jednak prawa autorskie do tego
  32. programu.  Nie zezwalam teû na jego odpîatne rozpowszechnianie (poza
  33. typowymi stawkami za dystrybucjë dysków PublicDomain).  Nie zezwalam
  34. takûe na dokonywanie w programie jakichkolwiek zmian.  Program
  35. *powinien* byê rozpowszechniany wraz z dokumentacjâ i ewentualnie
  36. pozostaîymi plikami doîâczonymi do archiwum, wyszczególnionymi w pliku
  37. "ReadMeFirst.Asc".  Ze wzglëdu jednak na formë programu, ostatni
  38. warunek nie musi byê speîniany.  Niemniej jednak rozpowszechnianie
  39. dodatkowo instrukcji jest wskazane.
  40.  
  41.  
  42. 2. Do czego ten program sîuûy?
  43.  
  44. SwapperBox jest programem typu... ehm chyba jest programem nie-typowym.
  45. Idea jest moûe przez niektórych juû trochë znana. Pierwsza wersja tego
  46. programu, zostaîa napisana przez Extenda i zamieszczona w NTB#4.
  47. Ten program natomiast jest wersjâ plikowâ, speîniajâcâ dokîadnie to
  48. samo zadanie.
  49.  
  50. Zadaniem tym jest gromadzenie danych o kolejnych posiadaczach tego
  51. programu. Dzieje sië to poprzez wprowadzenie swojej ksywki, grupy i
  52. miejscowoôci, w której sië mieszka. Dane te sâ zapamiëtywane
  53. w specjalnym pliku.
  54.  
  55. SwapperBox'a moûna ômiaîo porównaê do rozbudowanej wersji krâûâcego juû
  56. od dosyê dawna, a bardzo popularnego wôród swaperów SpreadIt'a (no
  57. wiecie, ten plik z chmurâ :-). Kaûdy sië tam kolejno dopisuje i na
  58. dzisiaj widziaîem taki plik z prawie setkâ ludzi. SB ma jednak na celu
  59. dokîadniejsze zobrazowanie drogi jakâ program pokonaî. Przy okazji mamy
  60. szansë zorientowaê sië, kto gdzie mieszka i nawet z kim ma kontakt.
  61. Jest bowiem znaczna szansa, ûe program ten zostaî mu przysîany wraz z
  62. jakimô nowym stuff'em.
  63.  
  64.  
  65. 3. Opis programu.
  66.  
  67. Program moûna uruchomiê zarówno spod CLI, jak i spod WorkBench'a. SB
  68. nie wymaga przekazywania poprzez CLI, bâdú przez ikonkë ûadnych
  69. argumentów.
  70.  
  71. Program otwiera na ekranie ôredniej wielkoôci okno, w którym rysuje sië
  72. konturowa mapa. Z góry informujë, ûe miaîa ona wyobraûaê granice
  73. Polski. Po chwili powinno teû otworzyê sië jeszcze jedno maîe okienko z
  74. zapytaniem o ksywë i grupë. Tutaj podajemy swoje dane personalne, po
  75. czym naciskamy RETURN. W tym momencie pojawia sië kolejne okienko, w
  76. którym tym razem musimy podaê nazwë swojej miejscowoôci. Jeôli program
  77. wczeôniej miaî juû do czynienia, z miejscowoôciâ o podanej nazwie, to
  78. sam wskaûe nam jej miejsce. Musicie w tym miejscu uwaûaê. Jeôli bowiem
  79. mieszkasz w jakimô mieôcie, które w Polsce ma 10 odpowiedników, to moûe
  80. Ci sië trafiê, ûe program wskaûe Ci jakâô innâ miejscowoôê o
  81. identycznej nazwie.
  82.  
  83. Z natury jednak program nie zna sië na geografii i kaûde nowe miasto
  84. karze sobie zaznaczaê rëcznie. Naleûy teû zaznaczyê, ûe program
  85. *rozróûnia* duûe i maîe litery. W zwiâzku z tym "Warszawa"<>"wARSZAWA".
  86.  
  87. Moûe sië teû zdarzyê, ûe program po wpisaniu ksywki od razu przejdzie
  88. do menu gîównego. Dzieje sië tak dlatego, ûe aplikacja porównuje
  89. wprowadzony tekst z ostatnim goôciem z listy. Jeôli wypada TRUE, to
  90. znaczy to, ûe ostatni Ty sië wpisywaîeô i nie ma sensu powtarzaê caîej
  91. procedury.
  92.  
  93. Po przejôciu poprzez wszystkie pytania, mamy okazjë zapoznaê sië z menu
  94. gîównym. Sâ tam tylko cztery opcje, które jak na razie w zupeînoôci
  95. wystarczâ.
  96.  
  97. SHOW   - jest to najwaûniejsza opcja pokazujâca przebytâ przez program
  98.          drogë.
  99.  
  100. ABOUT  - standardowo jest to kilka informacji o programie
  101.  
  102. GREETZ - tutaj podziëkowania i pozdrowienia (dla osób specjalnych :)
  103.  
  104. QUIT   - tego niestety nie wiem ;-)
  105.  
  106. Dodatkowo znajdziecie teû w okienku standardowe gadûety zamykania okna
  107. i wysuwania go naprzód/do tyîu.
  108.  
  109. Po wciôniëciu SHOW macie okazjë przeôledziê drogë, którâ tuîaî sië ten
  110. program. Migajâce biaîe prostokâty to miejscowoôci, których nazwa
  111. znajduje sië w linii z komunikatami. Jest tam teû napisana xyva/grupa
  112. delikwenta. Czarne kreski to droga przebyta.
  113.  
  114.  
  115. 4. Wymagania, biblioteki, dane techniczne.
  116.  
  117. Program niestety potrzebuje systemu co najmniej w wersji 37, czyli 2.04
  118. Poprzednia wersja wymagaîa na 100% obecnoôci systemu 3.0, tutaj
  119. program moûe jeszcze uruchomiê sië na wersji 36 (2.0)
  120.  
  121. Sâ to oczywiôcie zaîoûenie teoretyczne. Tak naprawdë to jeszcze tego
  122. sam nie testowaîem. Jestem bowiem na tyle leniwy, ûe nie chce mi sië
  123. przejôê do kumpla obok, aby wypróbowaê jak tam program sië zachowuje.
  124. Nie denerwujcie sië wiëc, jeôli na wymienionym systemie 2.0 program nie
  125. ruszy. W kaûdym bâdú razie na 3.0 powinno to pomykaê bez ûadnych
  126. kîopotów. Mimo pokusy nie korzystam z reqtools'ów co mam
  127. nadziejë uîatwi posiadaczom tylko dfx: korzystanie z programu. W ogóle
  128. program nie korzysta z ûadnej *zewnëtrznej* biblioteki.
  129.  
  130. Do poprawnej pracy potrzebna mu jest jednak pewna iloôê pamiëci. Dobrze
  131. by byîo, gdyby ta pamiëê w chwili uruchomienia byîa wolna, bo inaczej
  132. zakoczy nas komunikat o bîëdzie. Komunikaty bîëdów opisane zostaîy
  133. niûej.
  134.  
  135. Program potrzebuje teû koniecznie pliku "SwapperBox.Datas", który musi
  136. znajdowaê sië w tym samym katalogu co program. Myôlë, ûe takie
  137. rozwiâzanie sprawy, równieû uîatwi korzystanie z programu.
  138.  
  139. Program napisany jest w AmigaE, dziëki czemu kod wynikowy nie jest za
  140. dîugi. W danej chwili bëdzie tego coô okoîo 10 kilobajtów. Jest to
  141. "wielkoôê surowa", bo potraktowanie pliku np. CrunchManiâ zmniejsza go
  142. juû do 4 kilo. Myôlë, ûe nie jest to duûo (ale i tak znacznie wiëcej
  143. niû listy niektórych swaperów :-).
  144.  
  145. Mimo wielkiej pokusy, w programie uûywam *zazwyczaj* jëzyka polskiego.
  146. Nie byîo to wygodne dla mnie, a z powodu nie uûywania polskich
  147. znaków diakrytycznych, moûe byê równieû niewygodne i dla Was. Zrobiîem
  148. tak tylko dlatego, aby byîo wiadomo o co chodzi. Jeôli program sië
  149. przyjmie, a powstanâ kolejne jego wersje, to obiecujë, ûe juû w 100%
  150. wszystko bëdzie *normalnie*, czyli "Where You live?".
  151.  
  152.  
  153. 5. Komunikaty pîenduf.
  154.  
  155. Poniûej przedstawiam komunikaty mogâcych sië pojawiê bîëdów.
  156.  
  157. ERROR: Nie mogë otworzyê gadtools.library ! - brak pamiëci, bâdú
  158.                                               niewîaôciwa wersja
  159.  
  160. ERROR: Nie mogë znaleúê ekranu WB ! - w przypadku braku ekranu
  161.                                       WorkBencha
  162.  
  163. ERROR: Nie mogë uzyskaê informacji o ekranie ! - z róûnych powodów :)
  164.  
  165. ERROR: Nie mogë create context ! - prawdopodobnie brak pamiëci na
  166.                                    stworzenie struktury gadûetów
  167.  
  168. ERROR: Nie mogë stworzyê gadgetu ! - patrz wyûej
  169.  
  170. ERROR: Nie mogë otworzyê okna ! - prawdopodobnie brak pamiëci
  171.  
  172. ERROR: Nie mogë otworzyê pliku ! - program nie ma dostëpu do pliku;
  173.                                    sprawdú, czy znajduje sië on w tym
  174.                                    samym katalogu co program i czy nie
  175.                                    jest czasem uszkodzony, bâdú niepeîny
  176.  
  177. ERROR: Dysk jest zaprotegowany - no comments
  178.  
  179. ERROR: Dysk jest peîny - brak miejsca na dysku w celu dopisania nowych
  180.                          danych; mogâ byê kîopoty, patrz "Struktura
  181.                          danych"
  182.  
  183. ERROR: Nie ma dysku - jasne jak sîoïce
  184.  
  185. ERROR: Dysk jest niezwalidatowany - uniewaûnienie dysku; spróbuj
  186.                                     podziaîaê FixDisk'iem bâdú DiskSalv'em
  187.                                  
  188. ERROR: Nieznany bîâd nr $X - nieprzewidywalny bîâd mogâcy wyniknâc z
  189.                              wielu przyczyn. Skontaktuj sië ze mnâ,
  190.                              sprawdú w INCLUDE'ach jego znaczenie;
  191.                              <dos/dos.h>
  192.  
  193.  
  194. 6. Struktura danych.
  195.  
  196. W tym rozdziale spróbujë omówiê strukturë zapisu danych w pliku
  197. "SwapperBox.Datas". Moûe sië to przydaê, przy wprowadzaniu drobnych
  198. poprawek - wynikajâcych na przykîad z niewîaôciwego podania
  199. wczeôniejszych danych. Moûe równieû przydaê sië w przypadku zniszczenia
  200. czëôci pliku, bâdú nawet utracenia go.
  201.  
  202. Z góry jednak ostrzegam, ûe wykreôlanie jakiejô nielubianej osoby z
  203. listy, nie jest zaliczne do chwalebnych. Pamiëtaj o tym!
  204.  
  205. Plik zaczyna sië cyfrâ. Oznacza ona liczbë delikwentów na niej
  206. figurujâcych. Nastëpnie znajdujâ sië bloki danych kaûdego osobniaka z
  207. listy. Bloki te powtarzajâ sië, aû do koïca pliku, a ich liczba
  208. odpowieda danej zapisanej na poczâtku pliku.
  209.  
  210. Blok skîada sië z czterech linii. W pierwszej podana jest ksywa/grupa,
  211. w drugiej nazwa miasta, a w kolejnych dwóch jego wspóîrzëdne. Ostrzegam
  212. tutaj przed eksperymentowaniem. Wykroczenie z liczbami poza zasiëg INT,
  213. moûe nie tyle zawiesiê program, co spowodowaê trochë dzwiwnâ sytuacjë.
  214.  
  215. Równieû dane tekstowe sâ programowo limitowane do 40 znaków i wiëksza
  216. ich iloôê moûe byê nie odczytana (raczej na pewno tak bëdzie).
  217.  
  218. Z poziomu programu oczywiôcie wszelka pomyîka jest niemoûliwa, wiëc nie
  219. musimy sië o niâ martwiê. Program nie *pozwoli* nam na wklepanie
  220. wiëcej niû 40 znaków, czy teû wskazanie miasta poza mapâ (poza granicâ
  221. jeszcze moûna).
  222.  
  223. Poprzez znajomoôê struktury pliku moûliwe jest rëczne dopisywanie
  224. danych. Kîopotliwe moûe byê tylko podawanie wspóîrzëdnych miejscowoôci.
  225.  
  226.  
  227. 7. Co w przyszîoôci?
  228.  
  229. Program zamierzam unowoczeôniaê i rozbudowywaê. W przyszîoôci postaram
  230. sië rozszerzyê przede wszystkim zakres przechowywanych przez niego
  231. danych. Zamierzam doîâczyê moûliwoôê wpisania dokîadnego adresu, oraz
  232. ewentualnie kilku linii komentarza (celem pozdrowieï et coetera).
  233. Dziëki tym zabiegom program wspaniale bëdzie sië nadawaî na swego
  234. rodzaju advert-base'a.
  235.  
  236. Powinien zmieniê sië teû sposób przedstawiania drogi, oraz
  237. moûliwoôê tworzenia wîasnych mapek. Niewâtpliwie teû powinna znaleúê
  238. sië opcja wyszukujâca danego goôcia z listy. Bëdzie teû moûliwoôê
  239. wydrukowania na drukarce jego adresu i innych danych.
  240.  
  241. Z gadûetów przydaê sië moûe niektórym opcja SLEEP, która bëdzie juû
  242. dostëpna w nastëpnej wersji. To chyba wszystko na razie. Oprócz
  243. wprowadzenia wymienionych innowacji spróbujë poprawiê kilka
  244. istniejâcych juû bîëdów. Przede wszystkim nie ma moûliwoôci
  245. wyôwietlenia w okienku zbyt dîugiego teksty. To nie jest demko, abym go
  246. scrollowaî. Proszë wiëc na razie, na wpisywanie *maksymalnie* jak
  247. najkrótszych danych. Problem ten rozwiâûë albo zwiëkszajâc okno, albo
  248. ograniczajâc dîugoôê ciâgu, albo po prostu tworzâc osobne miejsca na
  249. nazwë miasta i ksywë.
  250.  
  251. Jeôli chcesz dostaê nowâ wersjë tego programu, bâdú wiele innych
  252. wydawanych przez "BlaBla Company GmbH" skontaktuj sië z którymô z jej
  253. czîonków, bâdú szukaj w bibliotece PolWare. Wszystkie nasze nowe
  254. programy sâ równieû dostëpne w Internecie oraz SIMON BBS. Dzwoï tam w
  255. godzinach od 23.00 do 6.00 - numer (0-74) 53-01-43. Moûesz sië tam
  256. równieû skontaktowaê za mnâ.
  257.  
  258.  
  259. 8. Historia programu.
  260.  
  261. wersja 1.0      29.10.1995      Na razie jest to pierwsza i jedyna
  262.                                 wersja tego programu. Z powaûniejszych
  263.                                 bîëdów stwierdzono wychodzenie czasem
  264.                                 tekstu poza okienko.
  265.  
  266. wersja 1.1      31.12.1995      Program chodzi juû na systemie 2.0
  267.                                 (chyba); po pokazaniu drogi ekran
  268.                                 jest czyszczony DOPIERO po wciôniëciu
  269.                                 SHOW a nie jak poprzednio zaraz po
  270.                                 ostatnim goôciu. Poprawiono równieû
  271.                                 czekanie na wiadomoôê od usera.
  272.  
  273. auyourd'hui: 18.12.95 (czytaj [uûurdîi] - dzisiaj :)
  274.  
  275.  
  276. 9. Pozostaîe informacje.
  277.  
  278. Jeôli chcesz dostaê nowâ wersjë tego programu, bâdú wiele innych
  279. wydawanych przez "BlaBla Company GmbH" :) skontaktuj sië z którymô z jej
  280. czîonków, bâdú szukaj w bibliotece PolWare (byîa NNameLibrary). Nasze
  281. programy dostëpne powinny byê teû w Internecie. Jeôli chcesz jednak
  282. mieê je pierwszy, to koniecznie dialuj do naszego grupowego BBS'u.
  283.  
  284.       SIMON BBS - (+048) (0-74) 53-01-43  godziny 23.00-6.00
  285.  
  286. Moûesz tam równieû skontaktowaê sië ze mnâ. Aby to zrobiê, po prostu w
  287. menu gîównym wciônij przycisk opisany jako "Pisz list do Co-Sysopa".
  288.  
  289. Sugestie, raporty o bîëdach, czy teû chociaû kartkë ze swojego
  290. miasta kieruj na adres (no swap):
  291.  
  292.           Kysy/AM & 2xBla as
  293.    
  294.           Krzysztof Habowski
  295.           ul. Dâbrowskiego 103/9
  296.           58-105 Ôwidnica
  297.  
  298. lub dzwoï (taki FastHelpLine):
  299.  
  300.           (+48) (0-74) 52-67-45
  301.  
  302.  
  303. Pozdrowienia dla wszystkich uûytkowników Amigi, a w szczególnoôci dla:
  304.  
  305. Thufor/blabla       - Internet róîû
  306. LeMUr/Fire & blabla - jak tam Twoje programowanie... pralki :^) Izviesti
  307. Apacz/Fire & blabla - DO ROBOTYYYYY! jak to krzyczaî Gieremek
  308. Tomash/ArtB & blabla- O Ty niewierny Tomash'u ;-)
  309. The Founder/Scum    - nowa grupka??? ql! Skizo + StuffPack = coolizna
  310. Misha/Erotic Design - nowa nazwa stary skîad? A co z resztâ Ils
  311. Hires/Union         - sparksów jeszcze nie mam
  312. Zayc/Union          - przesyîki kurierskie "Tonk-Po-Company" RULEZ!
  313. Ender/Scalaris      - coô nie widaê nowego Bigoza - jeszcze nie ugotowaîeô?
  314. Timer/Scalaris      - wiëcej efekciarskich kawaîków
  315. Paszczak/Obssesion  - mam do Ciebie pecha - miaîeô byê na gieîdzie!
  316. Billy/ZOMO          \ co jest z tymi ZOMO'wcami nagle obydwoje przestali
  317. Barabasz/ZOMO       / odpisywaê! Billy podobno zagarniëty przez SAS'a
  318. Snake/Opium         - o jedyny grafik-rëczny jakiego znam
  319. Fryzjer/Picco       - 4 Mb FASTu za 3 tausenty? kól
  320. SpoonMan/Ils&Obs    - w ilu aktualnie jesteô grupach? Czterech? Corrupt?
  321. IrekP/Union         - arty sië piszâ, baza sië opisuje
  322. Mad Mack/Union      - wreszcie Cië poznaîem, szkoda ûe tak póúno
  323. Jumper/Denethor     - ûyjesz?
  324. Lac/Legion          - polemika ûondzi
  325. Proctor/Damage      - Damage? Czësto zmieniasz grupy!
  326. MrPigmy/Illegals    - dalej nielegalni? moûe tak wróciê na dobrâ drogë?
  327. Spirol/Clan         - Clan? Nie... A jednak...
  328. Xenek/AM            - dalej to samo? moûe coô nowego by sië zrobiîo?
  329. Pionek/AM           - narysowaîeô juû tâ kropkë na ekranie? ql :-)
  330. Realman/Whippers    \ mieliôcie wpaôê ostatnio do mnie?
  331. DrRaf/Whippers      / mieliôcie zrobiê coô nowego wreszcie!
  332. TheStone/Whippers   - miaîeô naprawiê ten zasilacz
  333. Cosa/Chaotic        - jednak trzeba bëdzie A1200, nie ma co czekaê!
  334. Danthalian/Mystery  - wiëcej przeróbek z Atarusa! Misja i Draconus Cool
  335. Quovadis/Whippers   - prawie zapomniaîem jak wyglâdasz
  336. Serek/Inferno       - miaîeô wpaôê kiedyô??? Co? Brukowietz dead???
  337. Skee/???            - Ha! Ty wpadasz tylko jak coô potrzebujesz!
  338. Watson/Ind          - Robiîy jaskóîki spóîki? My teû zrobimy!
  339. Codet/Ind           - c je z ty komponiere? Szybcie t ni moûn?
  340. Simon/Ind           - ciâgnij to dalej
  341. Maîy/LadyBirds      - widziaîem Cië ostatnio na gieîdzie... urosîeô! :-)
  342. Szkudnik/Ind        - i co tu napisaê? Chyba Cië zwerbujë na Text-Writera
  343.  
  344. Arek.Edi.Valdi.Siwy.Cali.Prezes.Mytych and his group.Old members of NAV
  345. PatrykCiosek.RobertKopiec.KamilIskra.KamilTobiasz.Guys form Marconi-Shop
  346. AndrzejWójtowicz.BogdanZajâc.RobertBuczyïski.DariuszZbik.AndrzejLitwin
  347. OtherMan
  348.  
  349. Spreadujâc ten i inne programy - przyczyniasz sië do tworzenia nowych.
  350.  
  351. Hasîo na dziô: "Amiga E-automat compiluje juû przy 30 stopniach"
  352.  
  353.                                                     Kysy/AM & 2xBla
  354.