
                        WORW (War Of Robot Worms)
                        ^^^^^^^^^^^^^^^^^^^^^^^^^
                                           (dokumentci)

1. Lers:

  Kt robotfreg tekereg egy kzdtren - melyet arnnak neveznk -
  kincsek s falak kztt. Cljuk, hogy minl tbb kincset ssze-
  gyjtsenek s ekzben ne haljanak meg. Halluk akkor kvetkezik be
  ha falnak, sajat maguknak vagy a msik freg testnek tkznek.
  A robotfrgeket programok irnytjk, melyeket a jtkosok elre
  elksztettek. Ezek a programok robotfreg-nyelven rodnak, egy
  .rwl kiterjeszts fileban trolodnak s a worw.exe program
  paramtereiknt adhatk meg (kldhetk az arnba).

  Jtk vge: Ha valamelyik freg meghal (ez esetben az letben maradt
  gyz). Ha elfogynak a kincsek vagy 1.000 lps ta egyik freg sem
  szedett ssze kincset (s nem is halt meg) (ebben az esetben az a freg
  nyer, amelyik tbb kincset szedett ssze).


2. Robotfreg-nyelv (RWL):

  BASIC szer s szint nyelv. Nincs deklarci, minden vltoz automatikusan
  deklarldik, csak hasznlni kell ket. Milyen vltozkat lehet hasznlni?

2.1. vltozk:
           10db real tipus    R0,R1,...,R9
           10db integer tip    I0,I1,...,I9
           10db boolean tip    B0,B1,...,B9

  A programsorok ugyan gy nznek ki, mint pascalban vagy basicben, csak
  nem kell sorszmot rni a sorok elejre s nem kell pontosvessz a sorok
  vgre. Viszont egy sorban csak egy utasits llhat s a sor hossz maximum
  254 karakter lehet.
  Nzzk most sorra a hasznlhat utastsokat szintaktikjukkal:

2.2. utastsok:

   rtkads:         LET R1:=[kifejezs]

   ciklus:
     {szmll}       FOR I0:=[kifejezs1] TO [kifejezs2]
                        ...
                      ENDFOR

     {ell tesztel}  WHILE ([logikai kifejezs])
                        ...
                      ENDWHILE

     {vgtelen}       LOOP
                        ...
                      ENDLOOP

   elgazs:          IF ([logikai kifejezs])
                        ...
                      ENDIF

                    vagy

                      IF ([logikai kifejezs])
                        ...
                      ELSE
                        ...
                      ENDIF

   megjegyzs:        REM megjegyzs

   irnyit:          LEFT
                      {A kukac balra fordul.}

                      RIGHT
                      {A kukac jobbra fordul.}

   vezrlstads:    STEP
                      {A vegrehajtst tadjuk az ellenseg programjnak.}

   zenetklds:      MESS (szveg)
                      {Kirja szveget a kpernyre. A szveg hossza nem
                      lehet tbb mint 70 karakter.}


  A ciklusoknl lthattunk egy vgtelenciklus utastst (LOOP)... Az RWL
  programjainkat _mindig_ ilyen vgtelen ciklusba foglalva rjuk meg, hiszen
  ha nem ezt tesszk, akkor, amint lefutott, a frgnk kontrollatlanul rohan
  - nyl egyenesen - a vesztbe.
  Milyenek lehetnek az utasitsoknl szgletes zrjelben lv kifejezsek?
  A kifejezsekben konstansok s vltozk illetve fggvnyek szerepelhetnek
  mveletekkel sszektve:

2.3. mveletek:

   aritmetika:      +,-,*,/,div,mod
   logikai:         and,or,xor,not

2.4. fggvnyek:
                    RND(x): Egy vletlen egsz szmot ad vissza, mely >=0
                            s <x.

                    SIN(x),
                    COS(x): rtelemszeren, x radinban rtend.

                    SQR(x): x ngyzete
                    SQRT(x):x ngyzetgyke

2.4.1. specilis:
                    LOOKAT (irny,mennyit):mit
                    {Visszaadja, hogy irny-ban mennyit kocknnyira mit lt.
                    irny:0-elre, 1-jobbra, 2-balra, 3-htra
                    (vagy:FW-elre, RT-jobbra, LT-balra, BK-htra (konstansok))
                    mennyit:hny cellnnyit nzzen arra.
                    mit:0-semmi, 1-kincs, 2-nmaga, 3-fal, 4-ellensg}

                    LOOK(x,y):mit
                    {x,y egy -5..5 kztti szm, amellyel egy, a kukac
                    fejhez illesztett, menetirnynak megfelel relatv
                    koordinta rendszerben adjuk meg, hogy hova nz a
                    kukacunk.
                    Azaz (0,0) maga a kukac feje - nem rdemes lekrdezni.
                    (0,1) ugyan az, mint a LOOKAT(FW,1), (-3,0) ugyan az
                    mint LOOKAT(LT,3), (5,0) ugyan az, mint LOOKAT(RT,5).
                    Vissza pedig azt adja, hogy mit ltott ott:
                    mit:0-semmi, 1-kincs, 2-nmaga, 3-fal, 4-ellensg}

                    FEEL:irny
                    {Visszaadja, hogy melyik irnyban van fal vagy ellensg
                    t celln bell. Ha tbb is van, a kzelebbit adja
                    vissza.
                    irany:0-elre, 1-jobbra, 2-balra, 3-htra, 4-semerre}
                    (vagy:FW-elre, RT-jobbra, LT-balra, BK-htra, NT-semerre)

                    LENGTH:szm
                    {Visszaadja, hogy milyen hossz a kukacunk.}

                    DIRECTION:szm
                    {Visszaadja, hogy merre megy a kukacunk.}

                    GETX:szm
                    {Visszaadja a kukacunk fejnek X (vzszintesen,
                    balrl jobbra) koordintjt a kzdtren}

                    GETY:szm
                    {Visszaadja a kukacunk fejnek Y (fgglegesen,
                    fentrl lefel) koordintjt a kzdtren}


  Logikai kifejezsekben termszetesen a kvetkez relcikat is hasznlhatjuk:

2.5. relcik:
                    =,>,<,<>,<=,>=


2.6. Plda:
  lljon itt pldaknt egy nagyon egyszer RWL program:

    REM els plda neve: BALRA T!
    REM
    REM vgtelenciklus
    LOOP
      REM ha maga eltt 3-mal falat, nmagt vagy az ellensget ltja...
      IF (LOOKAT(FW,3)>=2)
        REM akkor balra fordul.
        LEFT
      ENDIF
    ENDLOOP


3. Vezrls megoszts a kt freg programja kztt:

  A jtkosok programjait az arna felvltva hajtja vgre, de nem soronknt
  ugrl a vezrlstads, hanem hrom "lnyeges" soronknt. (Lnyeges sor
  pl az IF, LET stb... Lnyegtelen pedig az ENDIF, ENDWHILE, REM, stb..)
  Teht valamelyik programban vgrehajt hrom lnyeges utasitst, aztn a
  msik programbl is vgrehajt hrom lnyeges utasitst s aztn mindkt
  freg lp egyet.
  Ezt a hrmassgot csak a LEFT, RIGHT s STEP parancsok trik meg, amik
  utn mindenkppen a msik program vgrehajtsa kvetkezik.

  Lnyeges utasitsok, amik nvelik a program lpsszmt:

LET, FOR, IF, ENDLOOP, WHILE, LEFT, RIGHT, STEP.

  Lnyegtelen utasitsok, amik nem nvelik a program lpsszmt:

REM, ENDFOR, ELSE, ENDIF, LOOP, ENDWHILE.


4. Az Arna (worw.exe) hasznlata:

  A jtkban rsztvev RWL programokat paramterknt kell megadni.
  Az indts gy trtnik (a legegyszerbb esetben):


C:\WORW> worw elso.rwl masodik.rwl

  Ekkor az informcik jelennek meg a kpernyn, hogy melyik sznnel
  melyik freg fog futni, aztn - egy billenty megnyomsa utn -
  kt dolog trtnhet:
  1., Ha valamelyik program nem megfelel szintaktikailag akkor
      kirja a hiba okt s helyt majd vget r a futs.
  2., Ha minden rendben van, akkor megjelenik az arna s kezdett
      veszi a harc a kt freg kztt.


4.1. beavatkozsok:

  A kzdelem sebessgt llthatjuk az F2-tl az F10-ig terjed
  funkcibillentykkel. Az F1 gombbal pedig ki-be kapcsolhatjuk
  a hangot.
  Az Escape billenty megnyomsval megszakthatjuk a harcot.


5. ini_file:

  Ltrehozhatunk egy worw.ini nev filet a neknk megfelel sebessg s
  hang belltsokkal, amiben a kvetkez szekcikat llthatjuk be:

  [SPEED]
  szm

  A szm 1-tl 9-ig terjedhet s az alaprtelmezett sebessget llthatjuk be.
  (1 a leggyorsabb, 9 a leglassabb.)

  [VOICE]
  sz

  A sz vagy a YES vagy a NO szavak lehetnek, attl fggen, hogy
  szeretnnk-e hangot vagy sem.
  (YES van hang, NO nincs hang)

  [MIXING]
  szm

  A szm 8000-tl 30000-ig terjedhet s a keversi frekvencit lltja be.
  Igazbl csak akkor lnyeges, ha 386DX40-nl lassabb gpnk van; akkor
  a sebessg nvelse (de a hangminsg romlsa) cljbl levehetjk az
  alaprtelmezett 22050 Hz-et mondjuk 11025 Hz-re - ekkor mr spols
  hallhat.

  Plda worw.ini-re:
[VOICE]
YES
[SPEED]
3
[MIXING]
22050


6. Verseny:

  Kt program sszeeresztse knyes dolog, mert egyetlen kzdelem nem tkrzi
  tkletesen egy-egy program elnyeit a vletlenl bekvetkez esemnyek
  miatt, ezrt rdemes egy versenyen kt programot tbbszr is sszeereszteni
  s ezek eredmnyeibl eldnteni, hogy melyik a jobb.

  Ekkor kell a kt program neve mell a -c kapcsolt megadni, s utna egy
  szmot: ennyiszer fogja sszeereszteni a kt programot az Arna.
  pl. worw elso.rwl masodik.rwl -c 21

  A menetek lefutsa utn sszesti a pontokat s az eredmnyt kirja
  a kpernyre. A menetek kzben nem vr billentyletst, mint egybknt.
  Gyzelemrt vagy dntetlenrt 1 pont jr, veresgrt 0 (egybirnt
  meglehetsen ritka a dntetlen).


7. Egyb paramterek:

  Lehet ms ini file-t hasznlni, pl. versenyhez gyorstunk, vagy ahhoz nem
  kell hang. Ekkor
    -i <file>

  Az Arna minden menet eredmnyt egy file-ba rgzti, alaprtelmezsben
  ez a worw.log. Ez tartalmazza az rwl-ek nevt, az egyes menetek eredmnyt
  s a vgeredmnyt (amennyiben 1-nl tbb menet volt). De ez a file minden
  futtatskor fellrja az elzt. Ennek megelzsre tirnythatjuk a logot
  mshova:
    -l <file>

  Klnsen verseny mdban lehet szksges, hogy valakit nem rdekel a harc
  menete, csak az, hogy ki hnyszor gyztt. Ezrt kikapcsolhatja a grafikt
  (ezzel egytt a hangot is), ekkor csak a pillanatnyi lls ltszik:
	-q

  A -k kapcsolval azt rhetjk el, hogy nincs billentyre vrs az elejn
  meg a vgn. Ez alaprtelmezett, ha verseny mdban vagyunk (ld. a -c
  kapcsolt az elz fejezetben).

  Ha lass a gpnk, de nem akarunk a WORW.INIvel szrakozni, gyengthetjk
  a hangminsget a -s kapcsolval.


8. Jkivnsgok:

  A jtkhoz sok rmet kvnnak a program kszti:

                               v. Brdosy Lack
                               ^^^^^^^^^^^^^^^^
                       (tlet, nyelv definci, interpreter)
                                      s
                             Tarjn Dnes Sopnka
                             ^^^^^^^^^^^^^^^^^^^^
                      (hang, kifejezs kirtkels, aprsgok)

(c)1996-97

http://webspn.hit.bme.hu/~bardosy/worw/
