home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / blabla / modinfo / modinfo.doc < prev    next >
Text File  |  1998-01-24  |  15KB  |  342 lines
  1.  
  2.                                   ModInfo
  3.  
  4.                      Wersja 2.1
  5.  
  6.                               Data 20.01.1996
  7.  
  8.           Copyright (c) 1995-1996 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?                           39.
  19.         3. Opis programu.                                      65.
  20.         4. Jak wydrukowaê tekst z ModInfo?                    155.
  21.         5. Wymagania, biblioteki, dane techniczne.            188.
  22.         6. Komunikaty pîentuf.                                218.
  23.         7. Co w przyszîoôci?                                  230.
  24.         8. Historia programu.                                 241.
  25.         9. Pozostaîe informacje.                              264.
  26.  
  27.  
  28. 1. Prawa autorskie i rozpowszechnianie.
  29.  
  30. Jest to program typu PublicDomain. Oznacza to, ûe jego rozpowszechnianie
  31. jest nieodpîatne. Mimo tego zastrzegam sobie w nim prawa autorskie. Nie
  32. zezwalam teû na jego odpîatne rozpowszechnianie (poza typowymi stawkami
  33. za dystrybucjë dysków PublicDomain). Nie zezwalam teû na dokonywanie w
  34. programie jakichkolwiek zmian. Program *POWINIEN* byê rozpowszechniany
  35. wraz z dokumentacjâ i ewentualnie pozostaîymi plikami doîâczonymi do
  36. archiwum, wyszczególnionymi w pliku "ReadMeFirst.Asc".
  37.  
  38.  
  39. 2. Do czego ten program sîuûy?
  40.  
  41. ModInfo - dla ludzi na codzieï pracujâcych z doskonaîym FileMasterem,
  42. nazwa ta powinna wyjaôniê wszystko. Warto jednak dla tej wâskiej grupy
  43. amigowców, która nie miaîa dotâd jeszcze moûliwoôci poznania tegoû
  44. programu, dokonaê krótkich objaônieï. Otóû program ten pozwala na
  45. uzyskanie informacji od dowolnym module muzycznym formatu trackera.
  46.  
  47. Dziëki niemu moûemy wiëc dowiedzieê sië o nazwach sampli, ich numerach,
  48. dîugoôci i innych ciekawych informacjach. Opcja ta nie byîaby taka waûna,
  49. gdyby (dziëki FM of course) nie nastaîa moda na wpisywanie zamiast nazw
  50. sampli róûnych pozdrowieï, informacji i tym podobnych.
  51.  
  52. Program w odróûnieniu od procedurki z FM pozwala dane nie tylko
  53. zobaczyê na ekranie, ale równieû dziëki wspaniaîem systemowi
  54. amigowskiemu wydrukowaê na drukarce, dowolnym oknie, czy teû nawet
  55. zgraê do pliku.
  56.  
  57. Dodatkowo, program ma poprawiony pewien nieznaczny bîâd wystëpujâcy w
  58. FM (dotyczy wersji <=2.208).  Umoûliwia równieû wîasne tworzenie
  59. formatu przedstawiania danych (!) oraz zawiera wartoôê FINETUNE, która
  60. w FM nie znalazîa swojego miejsca.
  61.  
  62. Program poprzez ewolucjë z prostej AMOS'owskiej procedury, staî sië
  63. dosyê mocno rozbudowanâ komendâ DOS'a.
  64.  
  65.  
  66. 3. Opis programu.
  67.  
  68. Program mimo, iû jest wyposaûony w ikonkë, to przewidziany jest
  69. wyîâcznie do uruchamiania ze ôrodowiska CLI. Wymaga bowiem podania
  70. przynajmniej jednego argumenty. W takiej postaci jest go równieû
  71. îatwiej podpiâc pod dowolnego dir-utila jako opcjë dodatkowâ.
  72.  
  73. Program posiada nastëpujâcâ skîadnië:
  74.  
  75. "ModInfo FILENAME #NS/O #SN/O #VL/O #LN/O #RT/O #RN/O #FI/O"
  76.  
  77. gdzie:
  78.  
  79. FILENAME = nazwa pliku (moduîu) wraz ze ôcieûkâ dostëpu
  80.   #NS    = numer sampla
  81.   #SN    = nazwa sampla
  82.   #VL    = gîoônoôê sampla
  83.   #LN    = dîugoôê sampla
  84.   #RT    = powtórzenia
  85.   #RN    = tzw. replen
  86.   #FI    = tzw. finetune
  87.  
  88. Pierwszy argument (FILENAME) jest obowiâzkowy. Bez niego program odmówi
  89. wspóîpracy. Pozostaîe 7 argumentów jest opcjonalnych. Sîuûâ one do
  90. ustawiania formatu tekstu, jaki ma byê wyôwietlany. W przypadku nie
  91. podania ûadnego z nich (po nazwie pliku FILENAME jest <enter>) program
  92. sam dobiera ustawienie domyôlne, które wyglâda nastëpujâco:
  93.  
  94. "Sample #NS: #SN Volume #VL Length #LN Repeat #RT Replen #RN"
  95.  
  96. Oczywiôcie jest to zapis "emulujâcy" procedurë z FM. Z tego przykîadu
  97. îatwo juû domyôliê sië jakâ funkcjë speîniajâ owe dwie litery
  98. poprzedzone znakiem hash ("#"). Sâ to po prostu kody sterujâce
  99. wstawiajâce pomiëdzy nasz tekst wartoôci im odpowiadajâce. I tak na
  100. przykîad kodowi #SN odpowiada nazwa kolejnego sampla, a #LN jego
  101. dîugoôê.
  102.  
  103. Do podanego przez nas ciâgu, program po prostu wstawia odpowiednie
  104. wartoôci zamiast naszych kodów. Oczywiôcie wcale nie muszâ one byê
  105. pisane duûymi literami (tak jak w przykîadzie), program bowiem
  106. rozróûnia i maîe znaki. Waûne jest tylko, aby byîy one poprzedzone
  107. znakiem "#"!
  108.  
  109. Dodatkowo kody te moûemy traktowaê jak zwykîe zmienne tekstowe.
  110. Moûliwe jest wiëc ich mieszanie, czy nawet uûywanie po kilka razy tej
  111. samej opcji. Nie musi teû byê zachowany jakikolwiek odstëp pomiëdzy
  112. kolejnymi kodami. Program jest wiëc bardzo tolerancyjny, a dodatkowo
  113. kaûdy nasz bîâd znajduje i powiadamia nas o nim.
  114.  
  115. Na koniec zostawiîem sobie przykîad, który mam nadziejë rozwieje
  116. ostatnie niejasnoôci. Nie od dziô przecieû wiadomo, ûe dobry przykîad
  117. jest w stanie zastâpiê caîâ instrukcjë.
  118.  
  119. Po podaniu drugiego argumentu w nastëpujâcej postaci:
  120.  
  121. ".... Numer Sampla=#NS Nazwa: "#SN" Dîugoôê=#LN-Koniec"
  122.  
  123. powinniômy otrzymaê:
  124.  
  125. "Numer Sampla= 1 Nazwa: "...................." Dîugoôê=01F3-Koniec"
  126.  
  127. Jest to oczywiôcie tylko przykîad. Chciaîem jednak poprzez niego
  128. zwróciê uwagë na jeszcze kilka szczegóîów. Otóû pobrane z pliku dane sâ
  129. w pewien sposób formatowane. Tak wiëc - numer sampla (#NS) jest zawsze
  130. wartoôciâ dwuznakowâ, formatowanâ do PRAWEGO marginesu. Nazwa sampla
  131. (#SN) jest to ciâg zawsze 20 znakowy, formatowany do LEWEGO marginesu.
  132. Gîoônoôê (#LN) to jeden bajt wyôwietlany w zapisie hexadecymalnym - tak
  133. wiëc zawsze dwa znaki formatowane do PRAWEGO marginesu i uzupeîniane z
  134. LEWEJ strony przez ZERA. Wartoôê tego kodu bëdzie oscylowaîa w
  135. granicach 00-48. Dziesiëtnie bëdzie to 0-63, bo takâ skalë gîoônoôci
  136. oferuje Amiga. Dîugoôê (#LN) to 4 znaki w zapisie hex, formatowane jak
  137. wyûej. Podobnie jest z repeat (#RT) i replen (#RN) - te wartoôci
  138. równieû sâ 4 znakowe i formatowane jak w przypadku gîoônoôci. Ostatnia
  139. wartoôê finetune to liczba dziesiëtna nieuzupeîniana zerami i tylko
  140. formatowana do PRAWEJ strony. Zawiera sië w przedziale od -8 do 7.
  141.  
  142. Tutaj teû napomknë o bîëdzie istniejâcym w FM. Otóû dotyczy on
  143. gîoônoôci i nieraz wyôwietla wartoôci niedopuszczalne i nierealne,
  144. czyli powyûej $48. Spowodowane jest to niepoprawnym odczytywaniem
  145. danych z pliku. Nie zamierzam sië zagîëbiaê w temat, ale dodam tylko, ûe
  146. autor FM odczytywaî bîëdnie sîowo, a nie bajt. Jeôli starsze osiem
  147. bitów byîo równe zero to wszystko byîo ok. Jeôli jednak znalazîa sië
  148. tam inna liczba to program szalaî.
  149.  
  150. Do tego FM ma skîonnoôci do "szarpania" testu, czyli jak to szczególnie
  151. dobrze widaê w moduîach Dreamera, tekst wyôwietlany jest w sposób
  152. powiedziaîbym delikatnie "trochë dziwny". W tym programie bîâd ten nie
  153. wystëpuje.
  154.  
  155.  
  156. 4. Jak wydrukowaê tekst z ModInfo?.
  157.  
  158. Tutaj juû nie jest to zasîugâ tylko i wyîâcznie programu. W sumie
  159. jedynâ jego zasîugâ na tym polu jest, to ûe dane skierowuje do
  160. standard-output. Resztâ natomiast zajmuje sië nasz kochany AmigaDOS. Za
  161. jego pomocâ moûemy wîaônie takie dane skierowaê do dowolnego innego
  162. urzâdzenia. W tej sytuacji moûliwoôci sâ juû prawie nieograniczone.
  163. Zaleûâ bowiem od zainstalowanych "urzâdzeï", handlerów i innych takich.
  164.  
  165. Przykîadowo wydrukowanie informacji o module, które normalnie
  166. pojawiîyby sië na ekranie, do pliku "Ram:ModInfo.Asc" nastâpi po
  167. wklepaniu:
  168.  
  169. ModInfo >Ram:ModInfo.Asc FILENAME... i opcjonalnie reszta argumentów
  170.  
  171. Wydrukowaê na drukarce??? Bezpoôrednio, czy poprzez dodatkowe
  172. sformatowanie przez sterownik?
  173.  
  174. ModInfo >PRT: ........
  175.  
  176. Moûe przesîaê kumplowi na drugi komputer poîâczony np. ParNetem??? Nie
  177. ma sprawy:
  178.  
  179. ModInfo >PAR: .......
  180.  
  181. No a moûe zobaczymy, a raczej USÎYSZYMY nasz wydruk?
  182.  
  183. ModInfo >SPEAK: ........
  184.  
  185. No i co??? Jak widaê moûliwoôci jest duûo. Ûyczë udanych eksperymentów
  186. na tym polu.
  187.  
  188.  
  189. 5. Wymagania, biblioteki, dane techniczne.
  190.  
  191. Program dziaîa, a moûe inaczej - powinien dziaîâê nawet na OS 1.3.
  192. Jak to w praktyce, to niestety musicie sprawdziê sami. Bo ja mimo, iû
  193. wystarczy abym przeîâczyî jeden przeîâcznik w innâ pozycjë, to jednak
  194. nie mam na to ochoty. Taki to juû jestem LeMUr (czyt. leï! it's joke OC).
  195. Oczywiôcie wynika to teû z kilku innych powodów, jak choêby posiadanie
  196. wszystkich dysków w systemie FFS. W razie jednak jakichkolwiek problemów
  197. proszë o kontakt.
  198.  
  199. W kwestii pamiëci, to dobrze aby trochë jej byîo. Program potrzebuje jâ
  200. przede wszystkim na bufor dla wczytywanego pliku. Gdyby jednak jej
  201. zabrakîo, to program powinien o tym kulturalnie nas poinformowaê.
  202. Jeôli ktoô chce czyste liczby to proszë bardzo. Bufor dla pliku 1024
  203. bajty. Na zmienne ze 3 kilo, plus z 10 kilo na "nieprzewidziane
  204. wypadki".
  205.  
  206. Cóû jeszcze jeôli chodzi o dane techniczne? Rozmiar pliku to 3448
  207. bajtów w postaci niespakowanej. Ikonki do instrukcji zrobiî Martin
  208. Huttenloher. Niech mu Bozia to w dzieciach wynagrodzi. Ikonka do
  209. programu? Autor nieznany. Poniewaû znalazîem jâ na jakimô dysku, wiëc
  210. ôladem Galla, nazwijmy do Disk Anonim.
  211.  
  212. Do archiwum doîâczyîem caîkiem niezîy moduî Voice/Silicon Arts. Mam
  213. nadziejë, ûe nie bëdzie miaî mi on tego za zîe. Jest on krótki, fajny i
  214. przede wszystkim dobry na przykîad. Proszë zwróciê uwagë na sampla
  215. numer 5 i jego gîoônoôê w FM, oraz postrzëpienie wydruku. W ModInfo
  216. v2.0 wszystkie te bîëdy sâ poprawione.
  217.  
  218.  
  219. 6. Komunikaty pîentuf.
  220.  
  221. Poniûej przedstawiam komunikaty mogâcych sië pojawiê bîëdów.
  222.  
  223. Bad file name! File "x" not exist - zîa nazwa pliku
  224.  
  225. Syntax Error! Error in second part of arg - Bîâd skîadni w drugiej
  226.                      czësci argumentu. Prawdopodobnie nieznany kod
  227.  
  228. No memory! - za maîo pamiâtki
  229.  
  230.  
  231. 7. Co w przyszîoôci?
  232.  
  233. Hmmm? Kolejna wersja? Jeôli bëdzie, to moûe OPCJONALNIE jakieô GUI sië
  234. machnie. Na pewno jednak skupië sië na dwóch danych których niestety
  235. brakuje w stosunku do FM. Jest to dîugoôê moduîu i iloôê patternów. To
  236. jednak da sië zrobiê.
  237.  
  238. To tyle jeôli chodzi o chëci. Co jednak z tego wyniknie i czy w ogóle
  239. coô z tego wyniknie, to zobaczymy.
  240.  
  241.  
  242. 8. Historia programu.
  243.  
  244. wersja 1.0    ok. 01.01.1994    Pierwsza wersja publiczna.
  245.  
  246. wersja 1.2        09.01.1995    Wersja caîkowicie zmieniona. Przede
  247.                                 wszystkim napisana juû w innym jëzyku
  248.                                 oraz przerobiona z procedury informacyjnej
  249.                                 na mini-viewerka. Oprócz nazwy sampli
  250.                                 pozwala teû dodatkowo na poznanie
  251.                                 dîugoôci sampla, repeat, gîoônoôê, numer,
  252.                                 i replen. Pozatym wszystkim gratisowo
  253.                                 dodane czëste guru :)
  254.  
  255. wersja 2.0        10.01.1995    Oto wersja teraúniejsza. W sumie pisana
  256.                                 jeszcze tego samego dnia, ale
  257.                                 ukoïczona po póînocy. Dodano informacjë
  258.                                 o finetune i dorobiono moûliwoôê
  259.                                 wprowadzania wîasnych formatów prezentacji
  260.                                 danych.
  261.  
  262. wersja 2.1        20.01.1996    Od tej wersji argumenty moga zawieraê
  263.                                 SAPCJE. Waûne jest tylko, aby ujmowaê
  264.                                 je w cudzysîów. Program takûe od tej
  265.                                 wersji dziaîa TYLKO na systemie v36+
  266.                                 Dodano takûe opcjonalny argument "?",
  267.                                 powodujâcy wyôwietlenie skîadni
  268.                                 programu.
  269.  
  270. auyourd'hui: 20.01.96 (dzisiaj)
  271.  
  272.  
  273. 9. Pozostaîe informacje.
  274.  
  275. Jeôli chcesz dostaê nowâ wersjë tego programu, bâdú wiele innych
  276. wydawanych przez "BlaBla Company GmbH" :) skontaktuj sië z którymô z jej
  277. czîonków, bâdú szukaj w bibliotece PolWare (byîa NNameLibrary). Nasze
  278. programy dostëpne powinny byê teû w internecie. Jeôli chcesz jednak
  279. mieê je pierwszy, to koniecznie dialuj do naszego grupowego BBS'u.
  280.  
  281.       SIMON BBS - (+048) (0-74) 53-01-43  godziny 23.00-2.00
  282.  
  283. Moûesz tam równieû skontaktowaê sië ze mnâ. Aby to zrobiê, po prostu w
  284. menu gîównym wciônij przycisk opisany jako "Pisz list do Co-Sysopa".
  285.  
  286. Sugestie, raporty o bîëdach, czy teû chociaû kartkë ze swojego
  287. miasta kieruj na adres (no swap):
  288.  
  289.           Kysy/AM & 2xBla as
  290.    
  291.           Krzysztof Habowski
  292.           ul. Dâbrowskiego 103/9
  293.           58-105 Ôwidnica
  294.  
  295. lub dzwoï (taki FastHelpLine):
  296.  
  297.           (+048) (0-74) 52-67-45
  298.  
  299.  
  300. Pozdrowienia dla wszystkich uûytkowników Amigi, a w szczególnoôci dla:
  301.  
  302.         Thufor/BlaBla       - nie szalej tak w tym internetcie :)
  303.         LeMUr/Fire & BlaBla - oh, post problems? znam to, ale te 6d...
  304.         Apacz/Fire & BlaBla - no, no dziaîasz juû coô
  305.         The Founder/BC      - zerwaîo sië konto; a juû byîy 4d, fuck
  306.         Misha/Illusion      - juû chyba dla mnie umarîeô
  307.         Hires/Union         - jak tam gfx do tego mdisku
  308.         Cornck/Art-B        - polware rulez
  309.         Zajc/Union          - drugi maniak z Gliwitz
  310.         Ender/Scalaris      - jak tam Bigoz - ugotowaîeô juû nowy numer?
  311.         Timer/Scalaris      - tylko greetzy
  312.         Paszczak/Obssesion  - jesteômy (blabla) Ci coô dîuûni, ty nam teû
  313.         Billy/ZOMO          - No, Kwach przy wîadzy, to moûe i robota 
  314.         Barabasz/ZOMO       - jakaô nowa dla Was sië znajdzie-lewica suxx
  315.         Snake/Opium         - jak tam idzie grafikowanie???
  316.         IrekP/Union         - oto ambitny czîowiek; cieszë sië, ûe Cië znam
  317.         Jumper/Denethor     - oj, kopë lat stary
  318.         Lac/Legion          - nasze polemiki w listach nabierajâ, ten tego
  319.         Proctor/Fire        - zobaczë kiedyô tego osîawionego b.Izv-makera?
  320.         Xenek/Atalanta May  - i jak Wam sië to podoba
  321.         Pionek/Atalanta May - hë???
  322.         MrPigmy/Illegals    - skâdô znam tâ xyvkë ;-)
  323.         Spirol/Ind          - Spirol dawno nie pisaî, kto zna niech mu powie
  324.         Fryzjer/Picco       - stary kochany Fryc; wpadnë tam na Smolucha kiedyô
  325.         Realman/Whippers    - coô nowego na placu boju z Realem?
  326.         DrRaf/Whippers      -  -   ||   -   ||  -  ||  - Asm-One?
  327.         TheStone/Whippers   - zepsuty zasilacz rulez!!! :^)
  328.         Cosa/Chaotic        - rozkrëciîeô swap? zmartwychwstaîeô?
  329.         Danthalian/Mystery  - dziëki za greetzy z modkach, odwzajemniam!!!
  330.         Watson/Ind          - oto wspólnik; jest wielki, rzeôki i ma A500+
  331.         Codet/Ind           - oto coder doskonaîy, wszystko skaszani :)
  332.         Maîy/LadyBirds      - pociâg na IO2 - pamiëtasz? rozgadaîeô sië o faszyúmie
  333.         Quovadis/Whippers   - i cóû tu napisaê, chyba niezbyt mnie lubisz?
  334.         Serek/Inferno       - a wpadnij no kiedyô to pogadamy
  335.         Skee/???            - TV Bielawa? Szybko zmienasz 'pracë'
  336.  
  337. Arek.Edi.Waldi.Siwy.Cali.Prezes.Guys form Marconi-Shop.Old members of NAV
  338. PatrykCiosek.RobertKopiec.MarcinSzkudniewski.KamilTobiasz.KamilIskra
  339. AndrzejWójtowicz.BogdanZajâc.AndrzejLitwin.DariuszÛbik.RafaîWiosna.OtherMan
  340.  
  341.                                                     Kysy/AM & 2xBla
  342.