Opasarkisto: SDL 1.2: Osa 4 - Lisäkirjastot

Tähän mennessä olemme tutustuneet perus-SDL:n ominaisuuksiin. Vaikka emme olekkaan käyneet niitä mitenkään syvällisesti läpi, kannattaa jo tutustua lisäkirjastoihin, joiden avulla on mahdollista tehdä monia asioita, mihin perus-SDL ei taivu. Tässä oppaassa käsittelemme muutaman yleisesti käytössä olevan SDL:n lisäkirjaston asennusta ja käyttöä.

SDL_gfx

SDL_gfx on SDL:n lisäkirjasto, jolla onnistuu mm. bittikarttojen monipuolinen käsittely ja nk. alkeiskuvioiden (ympyrä, viiva jne.) piirtäminen.

Asennus

SDL_gfx on saatavilla sekä lähdekoodipakettina että RPM-pakettina. Paketit löytyvät SDL_gfx:n koitsivuilta osoitteesta http://www.ferzkopp.net/Software/SDL_gfx-2.00. Ne Linux-käyttäjät, joiden koneeseen on asennettuna RPM-paketinhallintaohjelma, voivat ladata RPM-paketin. Paketit saattavat löytyä myös muiden distrojen (ainakin Debianin ja Gentoon) paketinhallinnasta. Muiden käyttäjien, myös Windowsia käyttävien, on ladattava .tar.gz pakattu lähdekoodipaketti (SDL_gfx-x.x.xx.tar.gz). Linuxissa purkuohjelma on valmiina (tar -xvzf paketinnimi.tar.gz), Windowssia käyttävät voivat purkaa paketin esim. WinRar-nimisellä ohjelmalla.

Lähdekoodista asentamiseen on INSTALL nimisessä tiedostossa selkeät ohjeet, joita noudattamalla kirjaston saa asennettua. Windowsissa kääntäminen hoidetaan joko VisualC++:n nmake-ohjelmalla tai MinGW-kääntäjällä (tulee mm. Dev-C++:n mukana). Linuxissa (ja muissa UNIX:eissa) kääntäminen sujuu tuttuun tapaan:

./configure
make
su
make install

Samoilta sivuilta löytyy myös kaikkien SDL_gfx:n funktioiden kuvaukset.

Visual C++:n käyttäjien on kirjaston kääntämisen jälkeen kerrottava kääntäjälläe missä uudet otsikkotiedostot (.h) ja kirjastotiedostot (.lib) sijaitsevat. Otsikkotiedostot täytyy kopioida samaan kansioon johon olet perus-SDL:n asennuksessa otsikkotiedostot kopioinut. (esim. C:SDLincludeSDL). Huomaa, että sinun on lisättävä projektiisi SDL_gfx:n .lib-tiedosto (SDL_gfx.lib) samaan tapaan kuin lisäät SDL:n lib-tiedostot. GCC:tä käytettäessä on kääntäjälle annettava lisäoptio -lSDL_gfx.

Itse Visual C++:lla tekemäni käännöksen voit kopioida ohjelmointiputkasta.

Käyttö

Yksi tärkeimmistä ominaisuuksista SDL_gfx:ssä on kuvapintojen zoomailu ja pyörittely. Otetaanpa esimerkki:

#include <SDL/SDL.h>
#include <SDL/SDL_rotozoom.h>		// kuvapintojen pyörittely ja zoomailu

//Aliohjelma, jota olemme käyttäneet 2. osassa (en viitsinyt kopioida tähän tilaa viemään)
void NaytaKuva(SDL_Surface *kuva, SDL_Surface *naytto, int x, int y);

int main( int argc, char* argv[] )
{

	SDL_Surface *naytto;
	SDL_Surface *kuva;


	if ( SDL_Init(SDL_INIT_VIDEO) < 0 ) {
		fprintf(stderr, "SDL:n alustus ei onnistunut: %s",SDL_GetError());
		return 1;
	}
	atexit(SDL_Quit);

	// vaihdetaan reso
	naytto = SDL_SetVideoMode (800, 600, 32, SDL_HWSURFACE | SDL_DOUBLEBUF);
	// SDL_FULLSCREEN-flagi puuttuu joten ohjelma näkyy ikkunassa

	// ladataan bittikartta
	kuva = SDL_LoadBMP("jee.bmp");

	// pyöritetään kuvaa 90-astetta ja kaksinkertaistetaan sen koko
	SDL_Surface * temp; // Väliaikainen pinta johon tallennetaan pyöritetty kuva
	temp = rotozoomSurface(kuva, 90, 2, 1);
	SDL_FreeSurface(kuva);   // Vapautetaan kuvan muisti koska sitä ei enää tarvita
	NaytaKuva(temp, naytto, 0,0);

	SDL_Flip(naytto);

	SDL_Delay(5000);   // odotetaan 5s

	SDL_FreeSurface(temp);     // Vapautetaan vielä pyöritetty ja suurennettu kuvapinta
	return(0);
}

Kopioi esimerkkiohjelma

Rivillä 27 kutsutaan rotozoomSurface-funktiota, jolla onnistuu kuvapintojen pyörittely ja zoomailu. Jotta voisit käyttää rotozoom-funktiota, sinun on sisällytettävä projektiisi rotozoom.h-kirjasto.
rotozoomSurface-funktio ottaa parametreina osoittimen lähdepintaan, double-tyyppiset liukuluvut, jotka kertovat paljonko kuvaa käännetään (asteina) ja paljonko zoomataan. Viimeisen parametrin ollessa 1 paluuarvona oleva 32-bittinen pinta on anti-aliasoitu.
Funktio osaa käsitellä vain 8- tai 32-bittisiä pintoja. Jos sille annetaan jokin muu kuin 8- tai 32-bittinen pinta parametrina, se muuttaa sen 32-bittiseksi. Funktion esittely:
SDL_Surface * rotozoomSurface (SDL_Surface *src, double angle, double zoom, int smooth);

SDL_gfx tuo mukanaan myös toisenlaisen zoomailufunktion, jolla voi zoomata x- ja y- akseleita erikseen. Funktio zoomSurface ottaa parametreina osoittimen lähdepintaan, double-tyyppiset tiedot siitä, paljonko x- ja y- akseleilla zoomataan. Viimeinen parametri on sama kuin rotozoomSurface:ssa. Tässä vielä zoomSurface-funktion esittely:
SDL_Surface * zoomSurface (SDL_Surface *src, double zoomx, double zoomy, int smooth);

Nyt kävimme läpi SDL_gfx:n ominaisuuksia hyvin pinnallisesti. Kirjaston kotisivuilta löytyy kuvaus kaikista SDL_gfx:n funktioista, joihin kannattaa ehdottomasti tutustua.

SDL_Mixer

Vaikka SDL:ssä itsessään on jonkinlaisia äänitoimintoja, on olemassa parempiakin vaihtoehtoja.
SDL_Mixer sisältää funktioita erimuotoisten äänitiedostoiden käyttämiseen.

Asennus

Lataa aluksi kehityspaketti SDL_Mixerin sivuilta ja asenna se. Asennus on yksinkertainen: Linuxilla asennetaan joko RPM-paketti tai lähdekoodipaketti samaan tapaan kuin SDL_gfx:n tapauksessa, Windowssille on saatavilla valmis binääripaketti samassa osoitteessa. Kääntäjän asetukset tehdään samalla tavalla kuin SDL_gfx:n ja perus-SDL:n kanssa. Muista kopioida otsikkotiedostot SDL:n kansioon kuten SDL_gfx:n tapauksessa.

Käännettäessä SDL_Mixeriä käyttävää ohjelmaa GCC:llä, on käytettävä -lSDL_mixer -lippua.

Käyttö

Ensiksi SDL_Mixeriä käytettäessä on tietysti sisällytettävä sen otsikkotiedostot:

#include <SDL/SDL_mixer.h>

Lisäksi SDL:ää alustettaessa on käytettävä SDL_INIT_AUDIO-lippua.

// alustetaan SDL, käytettävä SDL_INIT_AUDIO -flagia
if( SDL_Init(SDL_INIT_AUDIO|SDL_INIT_VIDEO) < 0 ) {
	fprintf(stderr, "SDL:n alustus ei onnistunut: %s", SDL_GetError());
	return 1;
}

Tämän jälkeen meidän on alustettava SDL_Mixer.

// 44,1 khz, perusmuoto, 2 kaiutinta
if(Mix_OpenAudio(44100, MIX_DEFAULT_FORMAT, 2, 1024)==-1) {
	fprintf(stderr, "SDL_Mixerin alustus ei onnistunut.");
}

Mix_OpenAudio alustaa SDL_Mixerin. Funktio ottaa parametreiksi äänen taajuuden, muodon, kaiuttimien lukumäärän ja bittitaajuuden. Tarkka kuvaus funktiosta löytyy täältä

Vastaavasti ohjelman lopussa on kutsuttava Mix_CloseAudio-funktiota.

Ääntä peliin!

Noniin, nyt olemme alustaneet SDL:n ja SDL_Mixerin, joten on aika soittaa musiikkia. Esittelen nyt yksinkertaisen tavan äänitiedoston toistamiseen, myös muita funktioita tähän tarkoitukseen on olemassa. Katso lisätietoja dokumentaatiosta

Aluksi ladataan äänitiedosto Mix_LoadWAV-funktiolla. Äänidata tallennetaan Mix_Chunk tyyppiseen tietueeseen.

Mix_Chunk *aani;
aani = Mix_LoadWAV("polkumusiikkitiedostoon.wav");

Tuo koodi lataa aani-nimiseen tietueeseen polkumusiikkifiluun.wav-nimisen äänitiedoston. Tiedosto voi olla jossakin seuraavista muodoista: WAV, AIFF, RIFF, OGG ja VOC.

Nyt kun olemme ladanneet äänitiedoston, voimme pistää sen soimaan Mix_PlayChannel-funktiolla. Ja pistetäänpä taas esimerkkiä peliin:

// olemme jo ladanneet äänitiedoston
if (Mix_PlayChannel(0, aani, 0) < 0)
		fprintf(stderr, "Virhe : %s ", Mix_GetError());   // virhe

Funktion esittely:
int Mix_PlayChannel(int kanava, Mix_Chunk *aani, int toistokerrat)

Funktio ottaa siis parametreina kanavan äänen toistamiseen, osoittimen äänidataan ja äänen toistokertojen lukumäärän (0 = soitetaan kerran, 1 = soitetaan kahdesti, -1 = toistetaan loputtomasti). Tämän jälkeen musiikki soi taustalla, kunnes ohjelma lopetetaan tai musiikin toistaminen pysäytetään. Mikäli halutaan toistaa ääntä teitty aika, käytetään Mix_PlayChannelTimed-funktiota. Funktion esittely:
int Mix_PlayChannelTimed(int kanava, Mix_Chunk *aani, int toistokerrat, int toistoaika)

Funktio toistaa ääntä niin kauan, kunnes toistoaika on kulunut tai kunnes ääntä on soitettu riittävän monta kertaa. -1 tarkoittaa loputonta toistamista.

Esimerkistä käy myös ilmi, miten SDL_Mixerillä haetaan virheitä. Mix_GetError palauttaa kuvauksen virheestä.

Taustalla soivan äänen pysäyttäminen onnistuu seuraavalla koodilla:

Mix_HaltChannel(kanava);

Funktiolla annetaan parametrina pysäytettävän kanavan numero.

Käydäänpä vielä pari asiaa SDL_Mixeristä. Ensin äänenvoimakkuuden säätäminen, joka onnistuu Mix_VolumeChunk-funktiolla. Funktion esittely:

int Mix_VolumeChunk(Mix_Chunk *aani, int voimakkuus);

Funktio ottaa parametrina osoittimen äänidataan, jonka voimakkuutta muutetaan. Toinen parametri on äänenvoimakkuus. Sen on oltava väliltä 0-128.
Funktio palauttaa alkuperäisen äänenvoimakkuuden.

Ja sitten viimeinen asia (vihdoinkin): äänidatan poistaminen muistista. Tämä onnistuu näin yksinkertaisella funktiolla:

Mix_FreeChunk(aani);
aani = NULL; //varmuuden vuoksi

Se on siinä!

Kävimme nyt pikakurssin muutamasta hyödyllisestä SDL:n lisäkirjastosta. Tämän oppaan tarkoitus on kertoa sinulle sekä SDL_gfx:n että SDL_Mixerin käytöstä, ja samalla kertoa yleisesti siitä, miten SDL:n lisäkirjastot asennetaan. Yleensä asennus on kaikissa lähes samanlainen, ja käyttökin on aina lähes samanlaista.

Tämän oppaan ei ollutkaan tarkoitus kertoa kaikkea tässä esitellyistä SDL:n lisäkirjastoista. Kävimme ne läpi vain pintapuoleisesti. Kannattaa tutustua seuraaviin sivuihin:

• SDL_gfx:n dokumentaatio ja lataussivu.
• SDL_Mixerin dokumentaatio
• Lähettämäni koodivinkki SDL_Mixeriin liittyen
• Lista SDL:n lisäkirjastoista. Kirjoitushetkellä listalla on 110 lisäkirjastoa!
• SDL:n dokumentaatio

Mitä sitten?

Jos olet ymmärtänyt kaikki asiat tästä opassarjasta, olet oppinut SDL:n ja sen lisäkirjastojen käytön perusteet. Toivon että tämä opassarja on auttanut sinut alkuun SDL:n käyttämisessä.

Oppaaseen liittyvää kritiikkiä/korjauksia/tietoja asiavirheistä yms. otan vastaan sähköpostilla tai oppaan kommenteissa. Koska minullakin on jonkinlainen elämä (oikeastikko?), niin joten SDL:ää (tai ohjelmointia yleensä) käsitteleviin kysymyksiin en luultavasti vastaa sähköpostilla. Näissä asioissa kannattaa käyttää putkan foorumia.

Koodailemisiin!

Viimeksi muokattu 18.5.2007