home *** CD-ROM | disk | FTP | other *** search
/ Gambler 19 / GAMBLERCD19.BIN / UTILS / DDTPACK / PROGS / CCC / CCC.DOC next >
Text File  |  1997-05-10  |  8KB  |  230 lines
  1. -----------------------------===[ polskie znaki w standardzie Latin 2 ]===---
  2. Cutter, Changer & Creator 1.02
  3. Copyright (c) 1995-97 Jim Midnite
  4.  
  5. -----------------------------------------------------------------------------
  6.  
  7.  
  8. 1. Do czego sêu╛y ten program? ----------------------------------------------
  9.  
  10. Program Cutter, Changer & Creator (zwany dalej CCC) sêu╛y do wykonywania
  11. kilku niedost⌐pnych w DOS-ie. Umo╛liwia on:
  12. - stworzenie pliku o dowolnym rozmiarze wypeênionego dowolnÑ wartoÿciÑ,
  13. - wypeênienie fragmentu ju╛ istniejÑcego pliku dowolnÑ wartoÿciÑ,
  14. - wypeênienie fragmentu pliku danymi z innego pliku,
  15. - oraz zgranie cz⌐ÿci jednego pliku do zupeênie nowego.
  16.  
  17.  
  18. 2. Korzystanie z CCC - komendy i parametry ----------------------------------
  19.  
  20. WywoêujÑc CCC nale╛y podaå choå jednÑ komend⌐ - np. tworzenie pliku,
  21. nagranie cz⌐ÿci pliku do innego itp. Oprócz tego w dowolnym miejscu linii
  22. poleceΣ mo╛na umieÿciå opcje.
  23.  
  24. 2.1. Komenda CREATE ---------------------------------------------------------
  25.  
  26.  Skêadnia: CREATE:newfilename,count,value
  27.  
  28. Parametry: newfilename - nazwa pliku do utworzenia
  29.                  count - dêugoÿå tego pliku
  30.                  value - wartoÿå, jakÑ b⌐dzie wypeêniony tworzony plik
  31.  
  32. Komenda CREATE sêu╛y do utworzenia pliku dowolnej dêugoÿci wypeênionego
  33. dowolnÑ wartoÿciÑ.
  34.  
  35. Liczby okreÿlajÑce dêugoÿå pliku i wartoÿå, jakÑ b⌐dzie wypeêniony mogÑ
  36. byå podane w systemie dziesiÑtkowym (np. "1200"), lub te╛ w systemie
  37. szesnastkowym ("1F0h" lub "$1F0").
  38.  
  39. 2.2. Komenda WRITE ----------------------------------------------------------
  40.  
  41.  Skêadnia: WRITE:filename,range,value
  42.  
  43. Parametry: filename - nazwa pliku, którego zawartoÿå chcemy zmieniå
  44.               range - zakres, w którym chcemy dokonaå zmian
  45.               value - wartoÿå, którÑ wypeênimy podany zakres
  46.  
  47. Komenda WRITE sêu╛y do wypeênienia fragmentu istniejÑcego ju╛ pliku ╛ÑdanÑ
  48. wartoÿciÑ.
  49.  
  50. Zakres mo╛e byå podany na dwa sposoby:
  51. 1) w formacie "offset_poczÑtkowy..offset_koΣcowy", np. "105..120".
  52. 2) w formacie "offset_poczÑtkowy:dêugoÿå", np. "105:16" (przykêad analogiczny
  53.    do poprzedniego).
  54.  
  55. Wszystkie liczby mogÑ byå podane zarówno w systemie dziesiÑtkowym jak i w
  56. szesnastkowym (ze znakiem dolara na poczÑtku liczby lub z literkÑ "h" na
  57. koΣcu).
  58.  
  59. 2.3. Komenda EXTRACT --------------------------------------------------------
  60.  
  61.  Skêadnia: EXTRACT:newfilename,sourcefilename,range
  62.  
  63. Parametry:    newfilename - nazwa nowego pliku, w którym zostanie zapisany
  64.                             fragment innego
  65.            sourcefilename - nazwa pliku, którego fragment b⌐dzie zapisany
  66.                             w pliku "newfilename"
  67.                     range - zakres okreÿlajÑcy fragment pliku, który
  68.                             zostanie skopiowany
  69.  
  70. Komenda EXTRACT sêu╛y do zapisania fragmentu ju╛ istniejÑcego pliku w nowym
  71. pliku.
  72.  
  73. 2.4. Komenda WRITEFILE ------------------------------------------------------
  74.  
  75.  Skêadnia: WRITEFILE:destfilename,offset,sourcefilename,range
  76.  
  77. Parametry:   destfilename - nazwa pliku, do którego chcemy zapisaå fragment
  78.                             drugiego
  79.                    offset - offset, od którego b⌐dziemy zapisywaå dane
  80.            sourcefilename - nazwa pliku, którego fragment zapiszemy w pliku
  81.                             "destfilename"
  82.                     range - zakres okreÿlajÑcy, który fragment zostanie
  83.                             skopiowany
  84.  
  85. Komenda WRITEFILE sêu╛y do zapisania fragmentu ju╛ istniejÑcego pliku do
  86. innego pliku.
  87.  
  88. 2.5. Parametr /? ------------------------------------------------------------
  89.  
  90. Parametr /? sêu╛y do wyÿwietlenia krótkiego spisu dost⌐pnych parametrów.
  91. Spis ten pokazywany jest równie╛ w przypadku uruchomienia CCC bez ╛adnych
  92. parametrów.
  93.  
  94. 2.6. Parametr /O ------------------------------------------------------------
  95.  
  96. Parametr /O sêu╛y do wêÑczenia trybu nadpisywania (overwrite mode). Program
  97. CCC uruchomiony bez tego przeêÑcznika odmówi zapisu na ju╛ istniejÑcy
  98. plik w komendach CREATE i EXTRACT (gdy╛ oznaczaêoby to skasowanie ich
  99. zawartoÿci). WêÑczenie trybu nadpisywania parametrem /O wyêÑczy to
  100. zabezpieczenie.
  101.  
  102. 2.7. Parametr /Q ------------------------------------------------------------
  103.  
  104. Parametrem /Q wêÑcza si⌐ tryb cichy (quiet mode), podczas którego program
  105. nie b⌐dzie nic wypisywaê na ekranie (oczywiÿcie oprócz komunikatów
  106. o bê⌐dach).
  107.  
  108.  
  109. 3. Komunikaty zwracane przez program ----------------------------------------
  110.  
  111. >>>> Cannot find file:
  112.      Nie mo╛na znale½å pliku:
  113.  
  114. Program nie mo╛e odnale½å ╛Ñdanego pliku - byå mo╛e podano niewêaÿciwÑ nazw⌐
  115. lub plik ma atrybut Read-Only.
  116.  
  117. >>>> Cannot read from file:
  118.      Nie mo╛na czytaå z pliku:
  119.  
  120. Program nie mo╛e przeczytaå danego pliku. PrzyczynÑ tego mo╛e byå bêÑd na
  121. dyskietce (dysku).
  122.  
  123. >>>> Cannot write to file:
  124.      Nie mo╛na zapisaå pliku:
  125.  
  126. Program nie mo╛e zapisaå danych w pliku. PrzyczynÑ tego mo╛e byå
  127. zabezpieczona dyskietka lub bêÑd na dysku.
  128.  
  129. >>>> COUNT must be a number greater than zero.
  130.      COUNT musi byå liczbÑ wi⌐kszÑ ni╛ zero.
  131.  
  132. Podano ujemnÑ lub zerowÑ wartoÿå COUNT.
  133.  
  134. >>>> COUNT must be a number indicating the file length.
  135.      COUNT musi byå liczbÑ oznaczajÑcÑ dêugoÿå pliku.
  136.  
  137. Podana wartoÿå COUNT nie jest liczbÑ.
  138.  
  139. >>>> Error in range!
  140.      BêÑd w zakresie!
  141.  
  142. Podany zakres jest bê⌐dny (np. wielkoÿå jest ujemna, bÑd½ offset koΣcowy
  143. jest mniejszy od poczÑtkowego).
  144.  
  145. >>>> File ... already exists. Use /O switch to overwrite it.
  146.      Plik ... ju╛ istnieje. U╛yj opcji /O do skasowania go.
  147.  
  148. Plik o podanej nazwie ju╛ istnieje. Podany komunikat to zabezpieczenie przed
  149. niechcianÑ utratÑ potrzebnego pliku. U╛yj przeêÑcznika /O, aby znieÿå to
  150. zabezpieczenie.
  151.  
  152. >>>> Invalid parameter - please run program with '/?' switch to obtain help.
  153.      Bê⌐dny parametr - uruchom program z opcjÑ '/?', aby otrzymaå pomoc.
  154.  
  155. Podano nieznany programowi parametr.
  156.  
  157. >>>> OFFSET must be a number!
  158.      OFFSET musi byå liczbÑ!
  159.  
  160. Podana wartoÿå OFFSET nie jest liczbÑ.
  161.  
  162. >>>> OFFSET must be a number greater or equal zero.
  163.      OFFSET musi byå liczbÑ wi⌐kszÑ lub równÑ zero.
  164.  
  165. Podano ujemnÑ wartoÿå parametru OFFSET.
  166.  
  167. >>>> Specify at least one action!
  168.      Podaj chocia╛ jednÑ komend⌐!
  169.  
  170. Nie podano ╛adnej komendy.
  171.  
  172. >>>> Specify data in ... format.
  173.      Podaj dane w formacie ....
  174.  
  175. Dane potrzebne komendzie zostaêy podane w niezrozumiaêym formacie
  176. (zastosowano nieodpowiedniÑ iloÿå parametrów).
  177.  
  178. >>>> Syntax error! Use ACTION:PARAMETERS format.
  179.      BêÑd skêadni! U╛yj formatu KOMENDA:PARAMETRY.
  180.  
  181. Komenda lub jej parametry sÑ podane nieprawidêowo, bÑd½ nie zostaêy
  182. oddzielone dwukropkiem
  183.  
  184. >>>> VALUE must be a number indicating the file fill value.
  185.      VALUE musi byå liczbÑ oznaczajÑcÑ wartoÿå do wypeênienia pliku.
  186.  
  187. Podana wartoÿå VALUE nie jest liczbÑ.
  188.  
  189. >>>> VALUE must be in range 0..255
  190.      VALUE musi zawieraå si⌐ w zakresie 0..255
  191.  
  192. Podano zbyt maêÑ (lub za du╛Ñ) wartoÿå parametru VALUE.
  193.  
  194.  
  195. 4. Przykêady korzystania z programu -----------------------------------------
  196.  
  197. 1) CCC CREATE:001.DAT,1000,20 WRITE:001.DAT,0:500,40
  198.  
  199. Stworzenie pliku 001.DAT i wypeênienie jego pierwszej poêowy bajtami o
  200. wartoÿci 40, a drugiej poêowy - bajtami o wartoÿci 20.
  201.  
  202. 2) CCC EXTRACT:002.DAT,GAME.GPH,0..1FFh WRITE:GAME.GPH,0..1FFh,0
  203.  
  204. Nagranie pierwszych 512 bajtów pliku GAME.GPH do pliku 002.DAT, po czym
  205. wyczyszczenie tych╛e bajtów w pliku GAME.GPH.
  206.  
  207. 3) CCC WRITEFILE:GAME.GPH,$20,002.DAT,0..1FFh
  208.  
  209. Nagranie pierwszych 512 bajtów z pliku 002.DAT do pliku GAME.DAT poczÑwszy
  210. od offsetu 32 (20h).
  211.  
  212. 5. Inne ---------------------------------------------------------------------
  213.  
  214. Program Cutter, Changer & Creator nale╛y do kategorii freeware, co znaczy,
  215. ╛e mo╛na bezpêatnie i bez ograniczeΣ go kopiowaå pod warunkiem, ╛e ╛aden
  216. plik wchodzÑcy w jego skêad nie zostanie zmieniony.
  217.  
  218. Aktualna wersja programu to wersja beta, tak wi⌐c mogÑ w niej wystÑpiå
  219. pewne bê⌐dy. Zaleca si⌐ wi⌐c ostro╛ne korzystanie z opcji '/O'. Jeÿli
  220. znajdziesz jakiÿ bêÑd jakieÿ sugestie, pomysêy lub komentarze dotyczÑce
  221. programu, napisz pod adres:
  222.  
  223. Gambler
  224. Wydawnictwo Lupus
  225. ul. St⌐piΣska 22/30
  226. 00-739 Warszawa
  227. z dopiskiem "Jim Midnite"
  228.  
  229. ------------------------------------------------------- Jim Midnite, 1997 ---
  230.