===========================================================================
 Ljudstd
===========================================================================

Servern skickar en lista ver frstahands- och andrahandsljudmrken
till klienten fr vissa hndelser. Frstahandslmrkena r de som
ndringsuppsttningen i frga fredrar. Klienten behver inte ha dessa
ljud. Andrahandsmrkena ska hnvisa till standardljud som alla
installationer av Freeciv ska ha.

Mrkena nvnds fr att ge ett enkelt stt att byta ljud. En
beskrivningsfil nvnds fr att ange ljudfiler till mrkena. Ett byte
av beskrivningsfil ndrar sledes ljuden. Det grs med
kommandoradsargument enligt fljande:

  civclient --Sound minaljud.spec

D nvnds de ljudfiler som anges i filen "minaljud.spec". Man mste
se till att ljudfilerna finns dr det str att de ska finnas genom att
kopiera eller lnka dem dit, eller genom att ndra i
beskrivningsfilen. Alla skvgar r som standard relativa till
katalogen "data/". Ljuduppsttningar kan laddas ner i tar-format frn
Freecivs webserver. Man packar upp dem med kommandot
"tar zxvf stdsoundsX.tar.gz" (eller med WinZip fr Windows) och lgger
filerna i ovannmnda datakatalog.

CVS-versionen innehller varken ljudfiler eller beskrivningsfil. Man
kan hmta ljuduppsttningar (ljudfiler med beskrivningsfil) frn
<ftp://ftp.freeciv.org/freeciv/contrib/sounds/>. P denna adress kan
man ven hitta extra ljudfiler fr att ndra en befintlig
ljuduppsttning eller skapa en ny.

================================
 Insticksprogram
================================

Ljudutmatningen i klienten grs av insticksprogram. Vilka
insticksprogram som r tillgngliga avgrs av de bibliotek som hittas
p vrdsystemet. Man kan vlja vilket insticksprogram som ska anvndas
med kommandoradsargument:

  civclient --Plugin sdl

Man kan vlja "none" fr att tysta klienten. Freeciv stdjer fr
nrvarande fljande insticksprogram:
  - dummy (none)
  - Esound (esd)
  - SDL with SDL_mixer library (sdl)

Fr att lgga till std fr ett nytt insticksprogram ndrar man dessa
filer (dr "ngot" r namnet p det nya insticksprogrammet):
	configure.in			/* lgg till nytt prov */
	acconfig.h			/* lgg till ny konfigurationsmetavariabel */
	client/audio.c			/* lnka in nytt insticksprogram */
	client/Makefile.am		/* lgg till filerna nedan */
	client/audio_whatever.c		/* insticksprogram */
	client/audio_whatever.h		/* insticksprograms huvud */

================================
 Mrken
================================

Det fins 2 slags ljudmrken:
 - angivna i regeluppsttningarna
 - angivna i programkoden

Emedan det frsta kan vljas fritt, kan det andra inte ndras.

Ljudmrkena som hr till vrldsunder och stadsfrbttringar,
enhetsfrflyttningar och strid mste anges i regeluppsttningarna.
Freeciv skickar ver dessa ljudmrken till klienten, dr de verstts
till filnamn med hjlp av beskrivningsfilen. Varje beskrivningsfil ska
ha allmnna ljudmrken fr vrldsunder ("w_generic"),
stadsfrbttringar ("b_generic"), enhetsfrflyttningar ("m_generic")
och strid ("f_generic").

Ljudmrken som hr till vissa hndelser kommer frn freecivkoden och
kan inte ndras utifrn. Beskrivningsfilen tillordnar ven ljudfiler
fr dessa mrken. Mrkenas namn r upprkningsnamn (se
common/events.h) bestende av gemena bokstver. Sledes blir
"E_POLLUTION" mrket "e_pollution". Det finns ingen allmnt mrke och
ej heller ngra andrahandsmrken.

Det finns fr nrvarande endast ett musikstycke; inledningsstycket.
Det spelas tills spelet brjar. Mrket fr detta musikstycke r
"music_start".

================================
 ATT GRA
================================

Det finns ngra saker som kan gras fr att frbttra Freecivs
ljudstd:
  * lgg till fler insticksprogram (gstreamer, arts, windows, ...)
  * lgg till ett ljudmrke fr varje forskningsframsteg
  * lgg till std fr ogg-filer
  * lgg till fler hndelsemrken
  * hitta eller skapa bttre ljud och frbttra beskrivningsfilen

================================
 vrigt
================================

Ljudskapare; vnligen namnge ljudfilerna p ett intelligent stt.
Bifoga en informationsfil med namnet README. Den mste innehlla
licensvillkoren. Om ljuden r fria frn upphovsrttsansprk ska det
framg.

Skapare av ndringsuppsttnigar; vnligen gr andrahandsmrken som
hnvisar till standardmrken s att de som inte har laddat ner den
senaste och bsta ljuduppsttningen nd kan njuta av spelet.
