Dodatek

void allegro_message(char *msg, ...);

která má formátování jako funkce printf. Je nutné ji použít pouze v textovém módu, kde má standardní výstup. Používá se s externí proměnou extern char allegro_error[ALLEGRO_ERROR_SIZE]; která v sobě nese informace o tom, ke které chybě došlo.

Malý příkládek

if (set_gfx_mode(GFX_SAFE, 320, 200, 0, 0) != 0) { set_gfx_mode(GFX_TEXT, 0, 0, 0, 0); allegro_message("Nelze nastavit grafický mód.\n%s\n", allegro_error); return 1; }

To by mělo stačit k allegro_message, abyste nebyli překvapeni jakou funkci to používám.

Hudba je důležitá...

V Allegru je to podobné...

int install_sound(int digi, int midi, const char *cfg_path);

a ta se nám postará o již zmiňovanou inicializaci. Některé instalační funkce mají parametry a některé ne. To není žádná vada. My se k jednotlivým parametrům hned dostaneme.

Jaké formáty Allegro umí?

Formát WAV a VOC

Definovám v hlav. souboru je takto:

typedef struct SAMPLE /* a sample */ { int bits; /* 8 or 16 */ int stereo; /* sample type flag */ int freq; /* sample frequency */ int priority; /* 0-255 */ unsigned long len; /* length (in samples) */ unsigned long loop_start; /* loop start position */ unsigned long loop_end; /* loop finish position */ unsigned long param; /*for internal use by the driver*/ void *data; /* sample data */ } SAMPLE;

Do vlastní struktury zasahovat přímo nebudeme, protože k tomu máme již funkce, ale je dobré vědět jak taková struktura SAMPLE vypadá. I když jsem ponechal anglické komentáře, myslím si, že není potřeba jednotlivé položky nějak představovat.

Nejlepší bude si vše vysvětlit na zdrojovém příkladě:

#include "allegro.h" int main(int argc, char *argv[]) { SAMPLE *the_sample; allegro_init(); install_keyboard(); if (argc != 2) { allegro_message( "Pouziti: 'allegro8_1.exe jmeno_souboru.[wav|voc]'\n"); return 1; } if (install_sound(DIGI_AUTODETECT, MIDI_NONE, argv[0]) != 0) { allegro_message("Chyba pri inicializaci hudby\n%s\n", allegro_error); return 1; } the_sample = load_sample(argv[1]); if (!the_sample) { allegro_message("Chyba pri nacitani '%s'\n", argv[1]); return 1; } play_sample(the_sample, 255, 128, 1000, TRUE); do { } while ((!key[KEY_ESC]) && (!key[KEY_ENTER])); destroy_sample(the_sample); return 0; } END_OF_MAIN();

Přejdu rovnou k věci. Jako první po spuštění programu si inicializujeme proměnnou the_sample, která je pointer na strukturu SAMPLE a do té později nahrajeme zvuk, se kterým můžeme manipulovat pomocí funkcí.

Funkce 

int install_sound(int digi, int midi, const char *cfg_path);

o které jsem se zmínil již na začátku článku má parametry. Nyní si povíme co jednotlivé parametry znamenají.
Parametr digi, ovládá tzv. digitální formát zvuku a midi ovládá midi soubory. Poslední parametr je zde pro kompatibilitu Allegra se staršími verzemi a můžeme ho tudíž dát NULL nebo např.: jméno našeho spustitelného souboru pomocí parametru argv[0]. První větu, která vyjadřuje použití proměnných jsem neřekl naprosto srozumitelně a je to taky z toho důvodu, že jsem se s tím nikdy neobtěžoval a moc dokumentace k tomu nenašel. A proto nám v našem případě bude stačit, když první parametr dáme DIGI_AUTODETECT a druhý buď MIDI_NONE pokud nebudeme používat midi soubory a nebo podobně MIDI_AUTODETECT pokud budeme chtít přehrávat midi soubory. Tyto dva parametry AUTODETECT nám zajistí, že Allegro si přečte nastavení hardwaru z konfiguračního souboru. Věřím, že tato informace Vám pro psaní programů v Allegru stačí neboť stačila i mne.

K návratovým hodnotám: Pokud vrací funkce 0 je vše v pořádku a -1 při chybě. Příčinu chyby najdete v proměnné allegro_error popsané opět na začátku článku.

Další důležitá funkce je funkce:

SAMPLE *load_sample(const char *filename);

Jako parametr bere jméno zvuk. souboru Wav nebo Voc a vrací pointer na SAMPLE nebo při chybě NULL. Je dobrým zvykem tedy otestovat nahraní zda proběhlo v pořádku či nikoliv. Umí nahrát zvuk Wav v 8 nebo 16 bitů a to bude stereo nebo mono a voc buď 8 nebo taky 16 bitů, ale pouze mono. Tedy takto je to napsáno v manuálu k Allegru a je možné, že to může být i docela jinak. Nejlepší je vše vyzkoušet a taky se rozhodnout co vlastně očekáváte od Vaší hry ;-).

A nyní přichází čas si hudbu nebo zvuk přehrát. A k tomu slouží funkce:

int play_sample(const SAMPLE *spl, int vol, int pan, int freq, int loop);

První parametr netřeba představovat. Jedná se o naší naplněnou strukturu nějakým zvukem.vol je hlasitost přehrávání souboru, která může být v rozmezí 0-255. pan je něco jako balanc u rádia.  Opět nabývá hodnot 0-255, přičemž 128 je rovnoměrně vyvážené a tedy stereo. Předposlední parametr freq, znamená tzv. frekvenci poslechu. Při hodnotě 1000 hraje zvuk tak jak je nahrán. Když dáme 500 máme 2x pomalejší poslech a 2000 je naopak 2x rychlejší poslech apod. Poslední parametr je tzv. příznakový - Může nabývat hodnot TRUE nebo FALSE. FALSE znamená, že se zvuk přehraje "pouze" 1x. TRUE znamená, že se zvuk bude přehrávat pořád dokola. Tedy od toho název proměnné loop. 
A v této souvislosti se ještě seznámíme s funkcí 

void stop_sample(const SAMPLE *spl);

která nám pomůže ten nekonečný cyklus, bez ukončení programu, zastavit. A šoupneme ji naši strukturu SAMPLE! Musíme tedy stejnou, aby nezastavila jiný zvuk než chceme my!

Pokud chcete měnit při nekonečném přehrávání zvuku balanc, hlasitost, frekvenci apod. A nechcete zvuk zastavit a pouštět ho znovu od začátku poslouží Vám dobře funkce:

void adjust_sample(const SAMPLE *spl, int vol, int pan, int freq, int loop);

kterou zavoláte s novými parametry tedy např.: třeba s menší hlasitostí a balancem pouze na levý reproduktor.

Jako poslední bych představil 

void destroy_sample(SAMPLE *spl);

ale na druhou stranu ani nemusím představovat, protože každý čtenář jistě ví o co jde...

Dneska už bych ale raději doporučil použít formát MP3 vzhledem k velikosti a jeho kompresi. A i když to Allegro standardně neumí tak se pokusím Vás někdy příště seznámit s knihovnou AllegrMP3.

Doporučuji si prostudovat příklad exsample v podadresáři examples.

Komentáře k článku -- Žádné příspěvky -- Přidat příspěvek