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