----------------------------------------------------------------------
Freecivs bilder och bildbeskrivningsfiler
----------------------------------------------------------------------

Att anvnda bilder:
-------------------

Fr att anvnda andra bilder n standardbilderna med Freeciv ger man
"--tiles" som kommandoradsargument till freecivklienten. Fr att till
exempel andnva "Engels"-bilderna kr man ageten med:

  civclient --tiles engels

Vad Freeciv gr d r att leta efter en fil med namnet
"engels.tilespec" ngonstans i Freecivs dataskvg. (Se filen INSTALL
fr information om Freecivs dataskvg.) Denna beskrivningsfil
innehller information om vilka bildfiler som ska anvndas och vad de
innehller.

Det r allt som man behver veta fr att anvnda andra
bilduppsttningar som fljer med Freeciv eller sprids fr sig av
tredje part. Resten av denna fil beskriver (dock inte fullstndigt)
innehllet i beskrivningsfilen och andra filer i sammanhanget. Detta
r tnkt som utvecklarhandledning och fr folk som vill
skapa/sammanstlla alternativa bilduppsttningar och
ndringsuppsttningar fr Freeciv.

----------------------------------------------------------------------
versikt:
---------

Syftet med beskrivningsfilen "tilespec" och andra beskrivningsfiler i
sammanhanget r att beskriva hur de olika bilderna r lagrade i
bildfilerna s att denna information inte behver vara hrdkodad i
Freeciv. Drfr r det enkelt att erbjuda ytterligare bilder som
tillgg.

Det r tv lager i beskrivningsfilerna:

Filen med det vre lagret har till exempel namnet "trident.tilespec".
Filens grundnamn, i detta fall "trident", motsvarar det
kommandoradsargument som skrivs efter "--tiles" p freecivklientens
kommandorad, ssom beskrivet ovan.

Den filen innehller allmn information om hela bilduppsttningen och
en lista ver filer som ger information om de ensilda bildfilerna.
Dessa filer mste finnas ngonstans i dataskvgen, men inte
ndvndigtvis p samma stlle som det vre lagrets beskrivningsfil.
Lgg mrke till att de hnvisade filernas antal och innehll r helt
anpasningsbart.

Ett undantag r att inledningsbilderna mste vara i enskilda filer,
ssom det beskrivs i beskrivningsfilen, ty Freeciv srbehandlar dessa:
de tas bort ur arbetsminnet nr spelet brjar och lses in igen om det
behvs.

----------------------------------------------------------------------
Enskilda beskrivningsfiler:
---------------------------

Varje beskrivningsfil beskriver en bildfil (fr nrvarande endast i
xpm-format) ssom det anges i beskrivningsfilen. Bildfilen mste
finnas i Freecivs dataskvg, men inte ndvndigtvis nra
beskrivningsfilen. (Drfr man man ha flera beskrivningsfiler som
anvnder samma bildfil p olika stt.)

Huvudinformationen som beskrivs i beskrivningsfilen str i stycken som
heter [grid_*], dr * r ngot godtyckligt mrke (men entydigt inom
varje fil). Ett rutnt motsvarar en vanlig tabell av rutor. I
allmnhet kan man ha flera rutnt i varje fil, men
standardbilduppsttningarna har vanligtvis bara ett i varje fil.
(Flera rutnt i samma fil vore anvndbart fr att ha olika
rutstorlekar i samma fil.) Varje rutnt anger ett utgngslge (vre
vnstra) och rutavstnd, bda i bildpunkter, och hnvisar sedan till
ensilda rutor i rutntet med hjlp av rad och kolumn. Rader och
kolumner rknas med (0, 0) som vre vnstra.

Enskilda rutor ges ett mrke som r en strng som det hnvisas
till i koden eller frn regeluppsttningsfilerna. Ett rutnt kan vara
glest, med tomma rutor (deras koordinater nmns helt enkelt inte), och
en enda ruta kan ha flera mrken (fr att anvnda samma bild fr flera
syften i spelet), ange helt enkelt en lista med kommateckenskilda
strngar.

Om ett givet mrke frekommer flera gnger i en beskrivningsfil s
anvnds den sista frekomsten. (Allts i den ordning som filerna r
nmnda i det vre lagrets beskrivningsfil och ordningen i varje
ensild fil.) Detta tillter att valda bilder erstts genom att ange en
ersttningsbeskrivningsfil nra slutet av fillistan i det vre lagrets
beskrivningsfil lagret utan att ndra tidigare filer i listan.

----------------------------------------------------------------------
Mrkesfrstavelser:
-------------------

Fr att hlla ordning p mrkena finns det ett grovt frstavelsesystem
som anvnds fr vanliga mrken:

  f.	        nationsflaggor
  r.	        vg/jrnvg
  s.	        allmnt liten
  u.	        enhetsbilder
  t.	        grundlandskapsslag (med _n0s0e0w0 to _n1s1e1w1)
  ts.	        srskilda tillgngar i landskapet
  tx.	        ytterligare landskapsegenskaper
  gov.	      regeringsformer
  unit.	      ytterligare enhetsinformation: trffpunkter, stack,
              sysslor (g till, befst med mera)
  upkeep.     enhetsunderhll och lycklighet
  city.	      stadsinformation (stad, storlek, tillverkning i ruta,
              upplopp, upptagen)
  cd.	        standardvrden fr stad
  citizen.    stadsinvnare, ven fackmn
  explode.    explosionsbilder (krnvapen, enheter)
  spaceship.  rymdskeppsdelar
  treaty.     avtalstummar
  user.	      hrkors (i allmnhet: anvndargrnssnitt?)

I allmnhet mste bildmrken som r hrdkodade i Freeciv
tillhandahllas i beskrivningsfilerna, annars vgrar klienten att g
igng. Bildmrken som ges av regeluppsttningarna (tminstone
standardregeluppsttningarna) ska ocks tillhandahllas, men i
allmnhet gr klienten igng nd, men d kan klientens bildvisning
bli alltfr bristfllig fr anvndaren. Fr att fungera ordentligt ska
mrkena hnvisa till bilder med lmplig storlek. (Grundstorleken kan
variera, ssom anges i det vre lagrets beskrivningsfil, men de
ensilda rutbilderna ska stmma verens med dessa storlekar eller
anvndningen av dessa bilder.)

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