Sv:Graphics

=Freecivs bilder och bildbeskrivningsfiler=
==Att använda bilder==
För att använda andra bilder än standardbilderna med Freeciv ger man
"--tiles" som kommandoradsargument till freecivklienten. För att till
exempel andänva "Engels"-bilderna kör man ageten med:
 civclient --tiles engels
Vad Freeciv gör då är att leta efter en fil med namnet
"engels.tilespec" någonstans i Freecivs datasökväg. (Se filen INSTALL
för information om Freecivs datasökväg.) Denna beskrivningsfil
innehåller information om vilka bildfiler som ska användas och vad de
innehåller.
Det är allt som man behöver veta för att använda andra
bilduppsättningar som följer med Freeciv eller sprids för sig av
tredje part. Resten av denna fil beskriver (dock inte fullständigt)
innehållet i beskrivningsfilen och andra filer i sammanhanget. Detta
är tänkt som utvecklarhandledning och för folk som vill
skapa/sammanställa alternativa bilduppsättningar och
ändringsuppsättningar för 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 behöver vara hårdkodad i
Freeciv. Därför är det enkelt att erbjuda ytterligare bilder som
tillägg.
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, såsom beskrivet ovan.
Den filen innehåller allmän information om hela bilduppsättningen och
en lista över filer som ger information om de ensilda bildfilerna.
Dessa filer måste finnas någonstans i datasökvägen, men inte
nödvändigtvis på samma ställe som det övre lagrets beskrivningsfil.
Lägg märke till att de hänvisade filernas antal och innehåll är helt
anpasningsbart.
Ett undantag är att inledningsbilderna måste vara i enskilda filer,
såsom det beskrivs i beskrivningsfilen, ty Freeciv särbehandlar dessa:
de tas bort ur arbetsminnet när spelet börjar och läses in igen om det
behövs.
==Enskilda beskrivningsfiler==
Varje beskrivningsfil beskriver en bildfil (för närvarande endast i
xpm-format) såsom det anges i beskrivningsfilen. Bildfilen måste
finnas i Freecivs datasökväg, men inte nödvändigtvis nära
beskrivningsfilen. (Därför man man ha flera beskrivningsfiler som
använder samma bildfil på olika sätt.)
Huvudinformationen som beskrivs i beskrivningsfilen står i stycken som
heter [grid_*], där * är något godtyckligt märke (men entydigt inom
varje fil). Ett rutnät motsvarar en vanlig tabell av rutor. I
allmänhet kan man ha flera rutnät i varje fil, men
standardbilduppsättningarna har vanligtvis bara ett i varje fil.
(Flera rutnät i samma fil vore användbart för att ha olika
rutstorlekar i samma fil.) Varje rutnät anger ett utgångsläge (övre
vänstra) och rutavstånd, båda i bildpunkter, och hänvisar sedan till
ensilda rutor i rutnätet med hjälp av rad och kolumn. Rader och
kolumner räknas med (0, 0) som övre vänstra.
Enskilda rutor ges ett märke som är en sträng som det hänvisas
till i koden eller från regeluppsättningsfilerna. Ett rutnät kan vara
glest, med tomma rutor (deras koordinater nämns helt enkelt inte), och
en enda ruta kan ha flera märken (för att använda samma bild för flera
syften i spelet), ange helt enkelt en lista med kommateckenskilda
strängar.
Om ett givet märke förekommer flera gånger i en beskrivningsfil så
används den sista förekomsten. (Alltså i den ordning som filerna är
nämnda i det övre lagrets beskrivningsfil och ordningen i varje
ensild fil.) Detta tillåter att valda bilder ersätts genom att ange en
ersättningsbeskrivningsfil nära slutet av fillistan i det övre lagrets
beskrivningsfil lagret utan att ändra tidigare filer i listan.
==Märkesförstavelser==
För att hålla ordning på märkena finns det ett grovt förstavelsesystem
som används för vanliga märken:
 f.	 nationsflaggor
 r.	 väg/järnväg
 s.	 allmänt liten
 u.	 enhetsbilder
 t.	 grundlandskapsslag (med _n0s0e0w0 to _n1s1e1w1)
 ts.	 särskilda tillgångar i landskapet
 tx.	 ytterligare landskapsegenskaper
 gov.	 regeringsformer
 unit.	 ytterligare enhetsinformation: träffpunkter, stack,
 sysslor (gå till, befäst med mera)
 upkeep. enhetsunderhåll och lycklighet
 city.	 stadsinformation (stad, storlek, tillverkning i ruta,
 upplopp, upptagen)
 cd.	 standardvärden för stad
 citizen. stadsinvånare, även fackmän
 explode. explosionsbilder (kärnvapen, enheter)
 spaceship. rymdskeppsdelar
 treaty. avtalstummar
 user.	 hårkors (i allmänhet: användargränssnitt?)
I allmänhet måste bildmärken som är hårdkodade i Freeciv
tillhandahållas i beskrivningsfilerna, annars vägrar klienten att gå
igång. Bildmärken som ges av regeluppsättningarna (åtminstone
standardregeluppsättningarna) ska också tillhandahållas, men i
allmänhet går klienten igång ändå, men då kan klientens bildvisning
bli alltför bristfällig för användaren. För att fungera ordentligt ska
märkena hänvisa till bilder med lämplig storlek. (Grundstorleken kan
variera, såsom anges i det övre lagrets beskrivningsfil, men de
ensilda rutbilderna ska stämma överens med dessa storlekar eller
användningen av dessa bilder.)
Category:svenska