CCC.DOC

(8 KB) Pobierz
-----------------------------===[ polskie znaki w standardzie Latin 2 ]===---
Cutter, Changer & Creator 1.02
Copyright (c) 1995-97 Jim Midnite

-----------------------------------------------------------------------------


1. Do czego suľy ten program? ----------------------------------------------

Program Cutter, Changer & Creator (zwany dalej CCC) suľy do wykonywania
kilku niedost©pnych w DOS-ie. Umoľliwia on:
- stworzenie pliku o dowolnym rozmiarze wypenionego dowolnĄ wartociĄ,
- wypenienie fragmentu juľ istniejĄcego pliku dowolnĄ wartociĄ,
- wypenienie fragmentu pliku danymi z innego pliku,
- oraz zgranie cz©ci jednego pliku do zupenie nowego.


2. Korzystanie z CCC - komendy i parametry ----------------------------------

WywoujĄc CCC naleľy poda† cho† jednĄ komend© - np. tworzenie pliku,
nagranie cz©ci pliku do innego itp. Opr˘cz tego w dowolnym miejscu linii
poleceä moľna umieci† opcje.

2.1. Komenda CREATE ---------------------------------------------------------

 Skadnia: CREATE:newfilename,count,value

Parametry: newfilename - nazwa pliku do utworzenia
                 count - dugo† tego pliku
                 value - warto†, jakĄ b©dzie wypeniony tworzony plik

Komenda CREATE suľy do utworzenia pliku dowolnej dugoci wypenionego
dowolnĄ wartociĄ.

Liczby okrelajĄce dugo† pliku i warto†, jakĄ b©dzie wypeniony mogĄ
by† podane w systemie dziesiĄtkowym (np. "1200"), lub teľ w systemie
szesnastkowym ("1F0h" lub "$1F0").

2.2. Komenda WRITE ----------------------------------------------------------

 Skadnia: WRITE:filename,range,value

Parametry: filename - nazwa pliku, kt˘rego zawarto† chcemy zmieni†
              range - zakres, w kt˘rym chcemy dokona† zmian
              value - warto†, kt˘rĄ wypenimy podany zakres

Komenda WRITE suľy do wypenienia fragmentu istniejĄcego juľ pliku ľĄdanĄ
wartociĄ.

Zakres moľe by† podany na dwa sposoby:
1) w formacie "offset_poczĄtkowy..offset_koäcowy", np. "105..120".
2) w formacie "offset_poczĄtkowy:dugo†", np. "105:16" (przykad analogiczny
   do poprzedniego).

Wszystkie liczby mogĄ by† podane zar˘wno w systemie dziesiĄtkowym jak i w
szesnastkowym (ze znakiem dolara na poczĄtku liczby lub z literkĄ "h" na
koäcu).

2.3. Komenda EXTRACT --------------------------------------------------------

 Skadnia: EXTRACT:newfilename,sourcefilename,range

Parametry:    newfilename - nazwa nowego pliku, w kt˘rym zostanie zapisany
                            fragment innego
           sourcefilename - nazwa pliku, kt˘rego fragment b©dzie zapisany
                            w pliku "newfilename"
                    range - zakres okrelajĄcy fragment pliku, kt˘ry
                            zostanie skopiowany

Komenda EXTRACT suľy do zapisania fragmentu juľ istniejĄcego pliku w nowym
pliku.

2.4. Komenda WRITEFILE ------------------------------------------------------

 Skadnia: WRITEFILE:destfilename,offset,sourcefilename,range

Parametry:   destfilename - nazwa pliku, do kt˘rego chcemy zapisa† fragment
                            drugiego
                   offset - offset, od kt˘rego b©dziemy zapisywa† dane
           sourcefilename - nazwa pliku, kt˘rego fragment zapiszemy w pliku
                            "destfilename"
                    range - zakres okrelajĄcy, kt˘ry fragment zostanie
                            skopiowany

Komenda WRITEFILE suľy do zapisania fragmentu juľ istniejĄcego pliku do
innego pliku.

2.5. Parametr /? ------------------------------------------------------------

Parametr /? suľy do wywietlenia kr˘tkiego spisu dost©pnych parametr˘w.
Spis ten pokazywany jest r˘wnieľ w przypadku uruchomienia CCC bez ľadnych
parametr˘w.

2.6. Parametr /O ------------------------------------------------------------

Parametr /O suľy do wĄczenia trybu nadpisywania (overwrite mode). Program
CCC uruchomiony bez tego przeĄcznika odm˘wi zapisu na juľ istniejĄcy
plik w komendach CREATE i EXTRACT (gdyľ oznaczaoby to skasowanie ich
zawartoci). WĄczenie trybu nadpisywania parametrem /O wyĄczy to
zabezpieczenie.

2.7. Parametr /Q ------------------------------------------------------------

Parametrem /Q wĄcza si© tryb cichy (quiet mode), podczas kt˘rego program
nie b©dzie nic wypisywa na ekranie (oczywicie opr˘cz komunikat˘w
o b©dach).


3. Komunikaty zwracane przez program ----------------------------------------

>>>> Cannot find file:
     Nie moľna znale«† pliku:

Program nie moľe odnale«† ľĄdanego pliku - by† moľe podano niewaciwĄ nazw©
lub plik ma atrybut Read-Only.

>>>> Cannot read from file:
     Nie moľna czyta† z pliku:

Program nie moľe przeczyta† danego pliku. PrzyczynĄ tego moľe by† bĄd na
dyskietce (dysku).

>>>> Cannot write to file:
     Nie moľna zapisa† pliku:

Program nie moľe zapisa† danych w pliku. PrzyczynĄ tego moľe by†
zabezpieczona dyskietka lub bĄd na dysku.

>>>> COUNT must be a number greater than zero.
     COUNT musi by† liczbĄ wi©kszĄ niľ zero.

Podano ujemnĄ lub zerowĄ warto† COUNT.

>>>> COUNT must be a number indicating the file length.
     COUNT musi by† liczbĄ oznaczajĄcĄ dugo† pliku.

Podana warto† COUNT nie jest liczbĄ.

>>>> Error in range!
     BĄd w zakresie!

Podany zakres jest b©dny (np. wielko† jest ujemna, bĄd« offset koäcowy
jest mniejszy od poczĄtkowego).

>>>> File ... already exists. Use /O switch to overwrite it.
     Plik ... juľ istnieje. Uľyj opcji /O do skasowania go.

Plik o podanej nazwie juľ istnieje. Podany komunikat to zabezpieczenie przed
niechcianĄ utratĄ potrzebnego pliku. Uľyj przeĄcznika /O, aby znie† to
zabezpieczenie.

>>>> Invalid parameter - please run program with '/?' switch to obtain help.
     B©dny parametr - uruchom program z opcjĄ '/?', aby otrzyma† pomoc.

Podano nieznany programowi parametr.

>>>> OFFSET must be a number!
     OFFSET musi by† liczbĄ!

Podana warto† OFFSET nie jest liczbĄ.

>>>> OFFSET must be a number greater or equal zero.
     OFFSET musi by† liczbĄ wi©kszĄ lub r˘wnĄ zero.

Podano ujemnĄ warto† parametru OFFSET.

>>>> Specify at least one action!
     Podaj chociaľ jednĄ komend©!

Nie podano ľadnej komendy.

>>>> Specify data in ... format.
     Podaj dane w formacie ....

Dane potrzebne komendzie zostay podane w niezrozumiaym formacie
(zastosowano nieodpowiedniĄ ilo† parametr˘w).

>>>> Syntax error! Use ACTION:PARAMETERS format.
     BĄd skadni! Uľyj formatu KOMENDA:PARAMETRY.

Komenda lub jej parametry sĄ podane nieprawidowo, bĄd« nie zostay
oddzielone dwukropkiem

>>>> VALUE must be a number indicating the file fill value.
     VALUE musi by† liczbĄ oznaczajĄcĄ warto† do wypenienia pliku.

Podana warto† VALUE nie jest liczbĄ.

>>>> VALUE must be in range 0..255
     VALUE musi zawiera† si© w zakresie 0..255

Podano zbyt maĄ (lub za duľĄ) warto† parametru VALUE.


4. Przykady korzystania z programu -----------------------------------------

1) CCC CREATE:001.DAT,1000,20 WRITE:001.DAT,0:500,40

Stworzenie pliku 001.DAT i wypenienie jego pierwszej poowy bajtami o
wartoci 40, a drugiej poowy - bajtami o wartoci 20.

2) CCC EXTRACT:002.DAT,GAME.GPH,0..1FFh WRITE:GAME.GPH,0..1FFh,0

Nagranie pierwszych 512 bajt˘w pliku GAME.GPH do pliku 002.DAT, po czym
wyczyszczenie tychľe bajt˘w w pliku GAME.GPH.

3) CCC WRITEFILE:GAME.GPH,$20,002.DAT,0..1FFh

Nagranie pierwszych 512 bajt˘w z pliku 002.DAT do pliku GAME.DAT poczĄwszy
od offsetu 32 (20h).

5. Inne ---------------------------------------------------------------------

Program Cutter, Changer & Creator naleľy do kategorii freeware, co znaczy,
ľe moľna bezpatnie i bez ograniczeä go kopiowa† pod warunkiem, ľe ľaden
plik wchodzĄcy w jego skad nie zostanie zmieniony.

Aktualna wersja programu to wersja beta, tak wi©c mogĄ w niej wystĄpi†
pewne b©dy. Zaleca si© wi©c ostroľne korzystanie z opcji '/O'. Jeli
znajdziesz jaki bĄd jakie sugestie, pomysy lub komentarze dotyczĄce
programu, napisz pod adres:

Gambler
Wydawnictwo Lupus
ul. St©piäska 22/30
00-739 Warszawa
z dopiskiem "Jim Midnite"

------------------------------------------------------- Jim Midnite, 1997 ---
Zgłoś jeśli naruszono regulamin