MSG.TXT

(44 KB) Pobierz
  Plik ten jest z polskimi znakami w standardzie Windows
 --------------------------------------------------------


            _/             _/     _/ _/ _/ _/         _/ _/ _/ _/
          _/ _/        _/_/   _/             _/   _/              _/
        _/    _/   _/  _/      _/ _/ _/ _/      _/
      _/       _/    _/                  _/   _/         _/ _/ _/
    _/             _/    _/             _/    _/             _/
  _/             _/       _/_/ _/ _/ _/        _/ _/ _/ _/ _/

       Modify                Save                  Game

         Version 1.05 Copyright (c) 1997-99 by Fubrus


  Wprowadzenie
  ~~~~~~~~~~~~
  Prezentowany program jest pr?b? uproszczenia dzia?a? maj?cych na celu
zmian? zawarto?ci jakiego? pliku binarnego. W za?o?eniach jest to program
do zmiany zapis?w stan?w gier, tym nie mniej pozwala on na modyfikacj?
r?wnie? innych plik?w.

  I. Uruchomienie programu
  ~~~~~~~~~~~~~~~~~~~~~~~~
  Program MSG uruchamiamy poprzez wydanie komendy MSG.EXE w katalogu programu.
W przypadku, gdy program znajduje si? w katalogu zdefiniowanym w zmiennej
?rodowiskowej DOS PATH, wpisanie komendy MSG.EXE r?wnie? powinno zaowocowa?
startem programu.
  Wymagania programu s? stosunkowo niewielkie. Do uruchomienia go wymagany
jest komputer z:
  * 350 KB wolnej konwencjonalnej pami?ci operacyjnej,
  * procesorem AT min. 80286,
  * kart? grafiki VGA z 256 KB RAM karty,
  * aktywnym sterownikiem myszy.
  Program pracuje w DOS'ie wersji nowszej ni? 3.1.
  Program przy starcie pr?buje rozpozna? niekt?re zamontowane komponenty.
Chodzi tu o kart? muzyczn?, CD-ROM, itp. Gdyby program mia? problemy przy
starcie to mo?na wymusi? zaniechanie wykrywania zamontowanego sprz?tu.
Dokonujemy tego za pomoc? opcji /S:

                           MSG.EXE /S

  Dodatkowo do programu MSG do??czam program START.EXE. Jest to program
interpretuj?cy przekazany mu w linii komend skrypt. Wywo?anie jego ma
posta?:

                   START.EXE NazwaSkryptu[.SCR] [/B]

  Dodanie prze??cznika /B powoduje utworzenie kopii bezpiecze?stwa modyfikowa-
nych plik?w. Robi on dok?adnie to samo co modu? z programu MSG. Do??czam go
poniewa? umo?liwia on modyfikacje plik?w z poziomu program?w BAT.


  II. Tryby pracy programu MSG
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Bezpo?rednio po uruchomieniu programu mamy dost?p do dw?ch g??wnych modu??w
programu. S? to:
  * Modu? edycyjny pozwalaj?cy na modyfikacj? i tworzenie nowych skrypt?w,
  * Modu? startowy pozwalaj?cy na wyb?r interesuj?cego nas skryptu i jego
    wykonanie.
  Z poziomu ka?dego z tych modu??w oraz z poziomu menu startowego mamy mo?-
liwo?? ustalenia opcji systemowych. Ustalamy tam czy program i/lub skrypty
maj? tworzy? kopie modyfikowanych plik?w. W oknie tym mo?emy obejrze? r?wnie?
kr?tk? charakterystyk? systemu na kt?rym zosta? uruchomiony program. W przy-
padku menu g??wnego mamy mo?liwo?? chwilowego wyj?cia do DOS'u lub uruchomie-
nie dowolnego innego programu. Mo?na r?wnie? ustawi? opcje edycji skryptu
w rozdzielczo?ci 800x600.


  III. Skr?ty klawiszowe
  ~~~~~~~~~~~~~~~~~~~~~~
  Program zosta? przystosowany do pracy z mysz? i bez niej nie uruchomi si?.
Wynika to z tego, ?e cz??? polece? nie mo?na wybra? bez bezpo?redniego wska-
zania ich mysz?. Po mimo tego praca z programem mo?e si? odbywa? prawie bez
u?ycia tego urz?dzenia. Wszystkie polecenia z jawnie podkre?lon? liter?
skr?tu wybieramy poprzez wci?ni?cie danego klawisza na klawiaturze. Gdy
natomiast nie zosta?a ?adna litera w nazwie polecenia zakre?lona to mo?na
spr?bowa? wywo?a? to polecenie z kombinacj? klawiszy Alt+Litera. Nie zawsze
to poskutkuje, np. w przypadku gdy wyst?puj? dwa polecenia rozpoczynaj?ce si?
t? sam? liter? to zostanie wybrane to pierwsze; to drugie nale?y wybra?
za pomoc? myszy. W module edycji po wybraniu interesuj?cego nas zestawu
funkcji, wyb?r funkcji dokonujemy bez klawisza Alt - wciskamy klawisz z liter?
odpowiadaj?cy pierwszej literze nazwy funkcji. W przypadku gdy dwie funkcje
maj? identyczn? liter? pocz?tkow?, klawiszem wybieramy t? pierwsz?, drug?
za pomoc? myszy.
  Te wszystkie zalecenia odnosz? si? do wi?kszo?ci okien dialogowych za
wyj?tkiem okna edycyjnego. W tym oknie przyciski zatwierdzenia i zaniechania
mo?na wybra? tylko za pomoc? myszy lub ENTER to zatwierdzenia a ESC - zanie-
chanie (Alt s?u?y do wprowadzania "polskich" znak?w).


  IV. Edytor skrypt?w
  ~~~~~~~~~~~~~~~~~~~
  Program MSG wyposa?y?em w do?? prosty edytor. Nie jest on co prawda bardzo
wygodny (a taki mia? by? w za?o?eniach), ale pozwala poprawnie zdefiniowa?
zawarto?? skryptu do wykonania. Pomimo tego, ?e podam spis funkcji i spos?b
ich zapisu to zalecam tworzenie skrypt?w tym narz?dziem a ewentualne poprawki
robi? w zwyk?ym edytorze ASCII. Wynika to z tego, ?e tylko ten edytor pozwala
pami?ta? o wszystkich warunkach poprawno?ci skrypt?w.


  IV.A. Obs?uga
  ~~~~~~~~~~~~~
  Edytor obs?uguje si? za pomoc? klawiatury i myszy. Wyb?r czynno?ci obrazuj?
odpowiednie przyciski. Po samym skrypcie przesuwamy si? za pomoc? kursor?w.
W oknie informacyjnym znajduje si? opis czynno?ci jaka zostanie wykonana po
wci?ni?ciu przycisku myszy.

  Dost?pne klawisze:
    W, F2 - Zapis skryptu w pliku
    L, F3 - Wczytanie skryptu z pliku
    S - Opcje
    A - Logo programu
    F - Poszukiwanie okre?lonego tekstu w skrypcie
    N - Nast?pne wyst?pienie tekstu w skrypcie
    R, ESC - Powr?t do menu startowego
    ENTER - Edycja wskazanej linii

    F7 - Wstawienie rozkazu powrotu z podprogramu
    F8 - Wstawienie etykiety do skryptu
    F9 - Wstawienie rozkazu skoku do etykiety w skrypcie
    F10 - Wstawienie rozkazu wywo?ania podprogramu w skrypcie
    BackSpace - Zamiana komendy/komentarza na komentarz/komend?
    Insert - Wstawienie komentarza
    Del - Usuni?cie komentarza

    Alt+F - Wyb?r podmenu Files
    Alt+S - Wyb?r podmenu Search
    Alt+G - Wyb?r podmenu Go To
    Alt+R - Wyb?r podmenu Read
    Alt+W - Wyb?r podmenu Write
    Alt+C - Wyb?r podmenu Compare
    Alt+L - Wyb?r podmenu List
    Alt+A - Wyb?r podmenu Array
    Alt+M - Wyb?r podmenu More

    Alt+E - Menu edycji

    Ctrl+C - Skopiowanie linii
    Ctrl+C - Wstawienie skopiowanej linii
    Ctrl+X - Wyci?cie linii

  Aby utworzy? nowy skrypt nale?y w selektorze plik?w w mask? pliku wpisa?
??dan? przez u?ytkownika nazw?. Program po stwierdzeniu, ?e nie ma takiego
pliku spyta si? czy ma go utworzy?. Przy tworzeniu nale?y r?wnie? poda? nazw?
gry do jakiej jest przeznaczony skrypt. Nazwa ta wykorzystywana jest przez
selektor skrypt?w w module wykonawczym.


  IV.B. Konwencja opisu komendy skryptu
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Komenda skryptu posiada og?ln? budow? w postaci:

          NR_Komendy [Parametr(y)]

  Zapisywana jest ona w pliku tekstowym, bez znak?w formatuj?cych - czysty
kod ASCII.
  Nr_Komendy b?dzie opisywany przy poszczeg?lnych funkcjach. Natomiast
parametr(y) je?li wyst?puj? maj? nast?puj?c? konwencj?:

[Warto??|[<TEMP>]|[<?> [Min. Warto?ci [Max. Warto?ci]] [Label] [Tekst informacyjny]]]
   (1)      (2)    (3)      (4)            (5)           (7)       (6)

  Jest to og?lna posta? parametru. Nawiasy [] oznaczaj? opcjonalno?? wyst?-
pienia tego elementu (przy braku zostan? przyj?te standardowe warto?ci),
element | oznacza wyb?r jednego z tych element?w. W przypadku odst?pstw od
tej formy zapisu zostanie to om?wione przy opisywaniu danej funkcji.
  Numery w nawiasach () zostan? wykorzystane przy opisie funkcji.
  Zadawanie minimalnej i maksymalnej warto?ci zale?y od osoby pisz?cej
skrypt. Nie wszystkim wiadomo, ale podanie warto?ci maksymalnej wi?kszej
od maksymalnej warto?ci danego typu zmiennej zazwyczaj oznacza poprawno??
takiego zapisu. Wynika to z tego, ?e warto?? zawy?ona jest brana jako
modulo maksymalny zakres dla danego typu. Np. dla zmiennej typu Byte
maksymalny zakres to 255, je?li za? my podamy jako maksymalny zakres 256
to zostanie to potraktowane jako 1 (256 Mod 255 = 1). Nale?y o tym pami?ta?
przy pisaniu w?asnych skrypt?w.


  IV.C. Warto?ci
  ~~~~~~~~~~~~~~
  Program przyjmuje warto?ci podawane dziesi?tnie (dotyczy liczb). Jednak
czasami, gdy zajdzie potrzeba podania warto?ci szesnastkowo to liczb? (ale
nie znak liczby) nale?y poprzedzi? znakiem $, tzn. n.p.: $24, -$35. Nie
nale?y u?ywa? takiego zapisu do okre?lania komendy.
  Program nie rozr??nia ma?ych i du?ych liter. Przy szukaniu tekstu nale?y
zwr?ci? na to uwag?.


  IV.D. Zmienne
  ~~~~~~~~~~~~~
  Program operuje na zmiennych pomocniczych. Przypada po jednej zmiennej
na ka?dy typ danej. Dodatkowo jest jedna zmienna pomocnicza Point typu
Long Integer do sterowania prac? skryptu (p?tle). Nale?y uwa?a? na to
aby przypadkowo nie zmieni? ich zawarto?ci, gdy tego nie chcemy.


  IV.E. Funkcje
  ~~~~~~~~~~~~~
  Program pozwala na wykorzystanie w skryptach nast?puj?cych funkcji:
 __________________________________________________

 * Files - operacje plikowe.
   - Open File - otwarcie pliku. Podajemy bezpo?rednio nazw? pliku lub
                 znak ?, kt?ry wymusza spytanie si? u?ytkownika o nazw?
                 pliku do modyfikacji. Aby wszystko wygl?da?o jak chce
                 u?ytkownik to po znaku ? nale?y poda? pytanie z jakim
                 program si? zwr?ci do u?ytkownika. Brak tego pytanie
                 spowoduje wy?wietlenie standardowego pytania programu.

                 Parametry: (1) lub (3) i (6)
                 Nr komendy: 10
                 Dost?p: Alt+F, O

   - Select File - wyb?r pliku. Funkcja to powoduje otwarcie okna do
                   r?cznego, interaktywnego wyboru pliku. W celu wyboru
                   kryterium poszukiwania musimy poda? mask? przeszukiwania
...
Zgłoś jeśli naruszono regulamin