; ASCII LAT2


                                 
        Ŀ  Ŀ          Ā       Ŀ  Ŀ
                                          
                                     
        Ĵ                            
                       Ā                  
                                      



==============================================================================
                            Hra AGENT programtor 7
==============================================================================
fze 1 : Hern systm alfa 7  BOMI software  Miroslav Hajda 20.2.1999 Zdchov

 Obsah tohoto textu:
 -------------------

1. vod
 1.1 Nrok na pota
 1.2 Autoi
 1.3 Vvoj a rozdly verz

2. Ovldn
 2.1 Volby ve he

3. Editovn
 3.1 Sloen souboru
 3.2 Vysvtlen jednotlivch pkaz
 3.3 Chybov hlen

  Č
   1.  VOD  
  

 Hra se skld ze dvou st :

 Interpretr pkaz
 ------------------
 Je  to  vkonavateln program, kter podle obsahu zdrojovho souboru vypisuje
text  a  nabz  monosti  dalho  vvoje  dj.  Je  to tedy hlavn soubor a
umouje  i  vyuit  pro  tvorbu  vlastnch djovch lini. Program pracuje v
textovm  reimu  80  znak  na  25  dk  pi  pouit  16 barev na barevnm
monitoru.

 Zdrojov soubor
 ---------------
 Soubor  obsahujc  text  hry  a  pkazy  pro  interpretr. Soubor by ml mt
pponu  *.TXG  a  prvn dek souboru by ml znt "; BOMI TXG PROCEDING FILE"
(dvojrky uvozuj text a do vlastnho souboru by se pst nemly).


 1.1 Nrok na pota

 Program poaduje minimln
 --------------------------
 Procesor               :  286
 Pam؜                  :  200 kb RAM
 Operan systm        :  DOS 5.0 nebo vy
                           WIN 3.1 nebo vy (WIN 95 / 98)
 Zvukov karta          :  ?
 Grafick karta         :  jakkoli zvldjc reim 80x25 v 16 barvch


 1.2 Autoi

 Hlavnm  autorem  a  inicitorem celho programu je spolenost BOMI software,
kter  navzala  kontakt  s  tmito lidmy, kte se z sti podlej na tvorb
zdrojovch text : Ji Hlav, Luk Hrbek, Radek Folta, Ji Hajda

Nejvt  podkovn  nle  Jimu  Hlavovi,  kter  se dlouhodob vnoval
tvorb vlastnch zdrojovch text a testoval alfa verze.


 1.3 Vvoj a rozdly verz

 Vysvtlivky :

  [ ] Dleit poznmka
  [+] Nov funkce
  [*] Vylepen funkce
  [-] Odstrann chyba

 Verze 1.0 alfa 1
 
  [ ] Program  pracoval  na naprosto rozdlnm principu, kdy zdrojov text byl
      zakomponovm   ve   vlastnm   programu.   To   znemoovalo   vytven
      rozshlejch text, nebo se tm mrn zvtovala dlka programu a tm
      i  jeho  nronost  na pam؜. Proto se spolenost BOMI software rozhodla
      pejt na systm, kdy text a pkazy jsou uloeny ve vnjm souboru

 Verze 1.0 alfa 2
 
  [ ] Prvn  pokusn  verze,  kdy  program poaduje zadn jmna souboru a pak
      jeho obsah zobraz do jednoduchho okna, ani by jakkoli dbal na obsah a
      pkazy

 Verze 1.0 alfa 3
 
  [ ] V tto verzi ji pracuje ten ze souboru
  [-] Nezobrazovn obsahu do okna
  [+] Vykonvn pkaz
  [+] Chybov  hlen  s  potkem  "FILE:",  nebo  "LOAD:"  (  cel  hlen
      anglicky)
  [+] Informace o innosti v dolnm dku
  [+] Uren  potu  dk  ped  kadm blokem textu ve tvaru "; x", kde x je
      poet dk a pkaz nsledujcch za tmto nvstm a patc k tomuto
      bloku
  [+] Pokud  pi  zobrazovn  peshne  poet  zobrazench  dk  obrazovku,
      program pod o stisk klvesy a dky zobrazuje od hornho okraje
  [+] Pkaz  "SELECT x1 x2 x3 .. xn"  :  uruje,  kolik monost volby nle
      bloku po vypsn jeho celho obsahu
  [+] Pkaz "NORMALCOLOR x y" : uruje, jakou barvou bude zobrazovn normln
      text. Parametr "x" uruje barvu textu a parametr "y" barvu pozad.
  [+] Pkaz  "COLOR x y"  : uruje, jakou barvou bude zobrazovn text v rmci
      dk, to znamen, e neuruje jakou barvou se bude obrazovka mazat

 Verze 1.0 alfa 4
 
  [*] Zatek  bloku nyn me bt libovoln slo, nebo nen potebn vdt,
      kolik dk bloku pat - bloku pat vechny dky a do zatku novho
      bloku.  Pro  lep  orietaci  v textu doporuujeme jako slo pst slo
      bloku, kter mu v posloupnosti nle
  [*] Zmizen kurzoru pomoc edho znaku v levm hornm rohu obrazovky
  [-] Mazn dku a do konce vdy
  [+] Pkaz "REM x1 x2 .. xn" : poznmka, text se nevypisuje na obrazovku
  [+] Pkaz "GOTO x" : okamit skok na zadan blok
  [+] Pkaz "GOSUB x"  :  skok  na  zadan blok s nvratem po celm zobrazen
      bloku
  [+] Pkaz   "IF x x1 x2 .. xn THEN"  :  vtven  programu  podle  podmnky,
      parametry mohou bt bu relace, nebo logick opertory
  [+] Pkaz "ELSE" : alternativn vtev po pkazu IF
  [+] Pkaz "END" : konec vtven pkaz IF a ELSE
  [*] Parametr  skoku  me bt hodnota [+|-]x, kter uruje zvisl skok, kdy
      slo bloku je rovno <slo aktulnho bloku>+ x
  [+] Pkaz "VAR x1 x2" : definovn promnn, hodnoty jsou typu longint
  [+] Pkaz  "LET x1=x2 x3 x4 .. xn" : zmna hodnoty promnn, x3 a xn mohou
      bt opertory + a -
  [+] Chybov hlen pi pekroen potu promnnch
  [+] Hldn potu parametr u pkaz
  [+] Posledn pkaz me bt "; END OF FILE"
  [+] Definovn promnnch VERZE SAVE SELECTOR GOSUBNUM

 Verze 1.0 alfa 5
 
  [*] Hlen chyb esky
  [+] Pidn hornho menu po stisku <F10>
  [+] Parametry z pkazov dky
  [+] Pekldac ascii tabulky pro zobrazen textu
  [+] Npovda po zvolen parametru "/?"
  [*] Ukryt kurzoru pomoc biosu
  [+] Ukonen po stisku <ESC>
  [+] Zobrazen autorova textu po skonen programu
  [+] Ukldn a natn pozice <F2> <F3>
  [+] Napsn neptomnosti npovdy po stisku <F1>
  [+] Parametry Kamenickch, Latin II, Cesky - uruj aktivn Ascii tabulku
  [+] Parametr /P - po ukonen se ek na stisk klvesy
  [+] Parametr /S - pi chyb program ppne
  [-] peskakovn dku pi pokraujcm zobrazovn

 Verze 1.0 alfa 6
 
  [+] pidn kurzoru myi
  [-] natn neexistujc uloen pozice
  [*] Zobrazen okna pro npovdu a jeho znovusmazn
  [*] Pidn promnn ASCII

 Verze 1.0 alfa 7
 
  [+] Nov zobrazovn chyb
  [+] Pidny pekladac ascii tabulky
  [*] Pekldn i zdrojovch text, nejenom textu menu
  [-] Odstrann chyba pi zptnm ten
  [+] Spoutn modul
  [*] Podn dosti DOSu o reim CO80

 Verze 1.0 alfa 8
 
  [ ] Cel program byl pepracovn do Borland Turbo Vision
  [+] Okno About
  [+] Menu Soubor|Otevt, Nastaven|etina

  Č
   2.  OVLDN  
  

 Ovldn lze rozdlit na ovldn menu a vlastn ovldn hry

 2.1 Volby ve he

 V tto verzi jsou 4 monosti ovldn vypisovn textu
 
 - Poadavek na stisk libovoln klvesy k vypsn dalho textu v rmci bloku
 - Poadavek na stisk klvesy pro pechod na dal blok
 - Poadavek volby pokraovn dje hry v rmci klves A - Z
 - Poadavek  na  stisk  klvesy  pro  ukonen  dje  s  nslednm dotazem na
  znovusputn od zatku

  Č
   3.  EDITOVN  
  

 V  tto  sti  nalezne  pokyny  pro  tvorbu vlastnch originlnch text, to
znamen, e jsou zde vysvtleny jednotliv funkce INTERPRETRU tto hry.


 3.1 Sloen souboru

 Popis verze 1.0
 
 Interpretr  zskv  pkazy  z  textovho  souboru, kter by ml mt pponu
.TXG,  co  vak  nen  povinn. Textov soubor se skld z jednotlivch dk
ukonench  znaky  CR  a  LF (#10 #13), kter se v bاnch textovch editorech
vytvej  stiskem  klvesy  ENTER  (""). Maximln dlka dku je 80 znak.
Prvn  dek mus bt "; BOMI TEXTGAME FILE" (psan bez dvojrek). Kad nov
blok  textu mus zanat "; x" ,kde x je libovoln cel slo (doporuuji pst
slo  bloku). Kad dal pkaz nachzejc se v bloku mus bt uvozen "; ".
Krom  textu  mus  navc  obsahovat  kad blok pkaz SELECT, nebo GOTO (viz
dle), existuje vak vyjmka, kterou je pkaz GOSUB. Zkladnm principem jsou
tzv.  nestrukturovan  skoky mezi jednotlivmy bloky textu (podobn jako jazyk
BASIC    na    starch   potach).  Posledn  dek  souboru  by  ml  bt
"; END OF FILE".


 3.2 Vysvtlen jednotlivch pkaz

SELECT [+|-]<slo dku> [[+|-]<slo dku2> [.. [[+|-]<slo dku n>]]]
-  za tmto pkazem "skok dle volby hre" se mus nachzet minimln jeden a
maximln  19  sel  podmnnch  voleb  skoku. Jednotliv sla jsou od sebe
oddleny  mezerou  " " (space). slo skoku bez znamnka udv slo bloku, na
kter  se  volba  odkazuje,  piem slo bloku se pot od zatku souboru.
Tato  metoda je dosti nepehledn a proto lze s vhodou pout prstku, nebo
bytku od aktulnho bloku pomoc znamnek "+" a "-". Pokud zadte pouze jedno
slo, potom budete pouze vyzvn ke stisknut klvesy. Pokud bude slo skoku
rovno  0  oznm  interpretr pi tto volb prohru. Pokud je poet voleb vt
ne 1 bude hr pi he interpretrem vyzvni ke stisku klvesy "A" a n, kde n
je  psmeno abecedy odpovdajc posledn volb. Vysvtlen jednotlivch voleb
je nutn uvst v textu.

GOTO [+|-]<slo dku>
-  tento  pkaz  automaticky  pejde  na  blok  podle  sla skoku a stejnch
pravidel pro toto slo, jako u SELECT.

NORMALCOLOR <barva textu> <barva pozad>
-  tento  pkaz  uruje,  jakou barvou bude smazna obrazovka ped zobrazenm
textu,  a proto by ml bt uveden ped prvnm dkem, jinak bude platit a pro
dal blok (ppadn dal smazn obrazovky).

COLOR <barva textu> <barva pozad>
-  tento  pkaz uruje barvu textu kter po nm nsleduje. Pkaz plat a po
pedefinovn dalm pkazem COLOR, nebo po konec bloku.

REM <text 1>[ <text 2>[ ..[ <text n]]]
-  "poznmka".  Text za tmto pkazem nebude zobrazovn na obrazovce. Me si
jej  prohlet  pouze  ten,  kdo  si  zobraz  zdrojov text - slou k popisu
zdrojovho souboru.

VAR <promnn> <poten_hodnota>
- deklarace promnnch. Promnn je zastoupena identifiktorem o maximln dlce
10 znak piem prvn znak mus bt psmeno. Poten hodnota je celoselnho
typu longint.

LET <promnn>=<vpoet>
-  zmna hodnoty promnn. Ve vpotu jsou povoleny dal promnn a opertory
"+" a "-", vechny seln hodnoty vak mus bt typu longint (ne s desetinnou
rkou).

IF <podmnka1> [<opertor1> <podmnka2> [[.. <opertor n> <vpoet n+1>]]][THEN]
-  vtven  programu. Vechny pkazy a texty za tmto pkazem jsou provdny
pouze  v  ppad,  e  podmnka za pkazem IF je pravdiv. Podmnka je vraz
<vpoet><relace><vpoet>  a plat pro ni stejn pravidla jako u pkazu LET.
Povolen  opertory  jsou AND OR a XOR a povolen relace "=" "<" ">" "<>" "<="
a ">=".

ELSE
- alternativn vtev programu. Jsou-li dky ped ELSE vykonvny pak dky za
IF vykonvny nebudou a naopak.

END
-  konec vtve programu. Tento pkaz ukonuje platnost pedchozho pkazu IF
a ELSE v rmci bloku.

GOSUB [+|-]<slo dku>
-  pechod  na  "subblok".  Odpovd  podprogramu v Basicu. Pejde stejn jako
GOTO  na  blok  zadanho sla, ale po proveden celho bloku se vrt zpt na
msto v bloku, ze kterho byl tento pkaz voln.

EXEC <pkaz Dosu>
- provede zvolen pkaz DOSu

 3.3 Chybov hlen

 Chybov hlen lze rozdlit podle dvou hledisek
 

- Chyba pi natn souboru :
  - Vnitn chyba jednotky Load
  - Soubor Nenalezen
  - dek je moc dlouh
  - Pokus o ten za koncem souboru

- Chyby syntaxe
  - Soubor nen podporovanho typu
  - Chyb SELECT, nebo GOTO v bloku n
  - Neznm pkaz na dce n
  - Chybn formt pkazu na dce n
  - Pli mnoho parametr pro pkaz na dce n
  - Shodn jmno dvou promnnch pi deklaraci na dce n
  - Nen msto pro rezervaci nov promnn na dce n

Konec dokumentu