VOICE ROUTINES - czyli rozwiniecie SAMPLE ROUTINESDo podstawowych funkcji/metod pozwalajacych nam na uzywanie dzwiekow w aplikacjach napisanych w bibliotece allegro naleza te operujace na strukturach SAMPLE. Jesli juz je poznales, a oczekujesz nieco wiekszej kontroli nad dzwiekiem, polecam zapoznanie sie z
VOICE ROUTINES, czyli funkcje kontroli dzwieku nizszego poziomu - czyt. o wiekszych mozliwosciach ingerencji :)
a wiec do dziela.
Skupie sie tutaj jedynie na samych funkcjach, w razie potrzeby na pewno wiesz, jak uruchomic allegro i odpowiednio wkomponowac te funkcje do swojego kodu:)
po pierwsze, po staremu, czyli:
SAMPLE * muzyczka = load_sample( "dzwiek.wav" );
if( !muzyczka )
{
set_gfx_mode( GFX_TEXT, 0, 0, 0, 0 );
allegro_message( "nie mogę załadować dzwieku muzyczka!" );
allegro_exit();
return 0;
}
czyli ladujemy do SAMPLE jakis dzwiek z dysku, sprawdzamy czy zaladowany.
drugim krokiem jest:
allocate_voice( muzyczka );
tutaj przypisujemy do voice nasz dzwiek. warto wiedziec, ze kazdy zaladowany dzwiek jest numerowany, ten pierwszy ma nr 0, chcac sie do niego odwolac w kolejnych funkcjach, bedziemy to robili podajac wlasnie ta cyfre (kolejny mialby 1). po drugie warto wiedziec, ze allegro zapewnia nam obsluge max 255 takich voice'ów, przy czy nie gwarantuje, ze ta liczba jest optymalna - to zalezy od sprzetu, wiec raczej nie nalezy przesadzac :)
a wiec mamy przypisany dzwiek do voice nr 0.
mozemy go teraz zaczac odtwarzac, ewentualnie najpierw ustalic pewne parametry.
spowoduje odtwarzanie dzwieku z domyslnymi parametrami(ustawione na poczatku przez allocate_voice, a wiec max glosnosc, moc rozlozona L50%/P50%, bez zmiany tempa odtwarzania, bez petli odtwarzania-czyli jednorazowe)
jesli chcielibysmy jednak cos zmienic, skorzystamy z funkcji:
void voice_set_volume( int voice, int volume );
voice_set_volume( 0, 100 );
zmiana balansu/rozlozenia mocy na glosniki:
void voice_set_pan( int voice, int pan );
void voice_sweep_pan( int voice, int time, int endpan );
void voice_stop_pan_sweep( int voice );
poza tym ustalamy sobie, czy dzwiek bedzie odtworzony jednokrotnie, czy tez w petli, mozemy tez ustalic, czy bedzie odtworzony od przodu do tylu, czy tez w rewersie
void voice_set_playmode( int voice, int playmode );
za playmode wybieramy:
PLAYMODE_PLAY
domyslny tryb, gra jednorazowo od poczatku do konca
* PLAYMODE_LOOP
granie z powtarzaniem, czyli w petli
* PLAYMODE_FORWARD
granie od poczatku do konca, przeciwienstwo nastepnej mozliwosci:
* PLAYMODE_BACKWARD
rewers, czyli odwrocenie kierunku odtwarzania
* PLAYMODE_BIDIR
kombinacja dwoch powyzszych, czyli gra od poczatku do konca, po czym zmienia kierunek odtwarzania na od konca do poczatku
zatrzymujemy odtwarzanie dzwieku, ale trzeba pamietac, ze ta funkcja zapamietuje pozycje, w jakiej dzwiek jest zatrzymany, wiec ponowne uruchomienie go nastapi od miejsca, w ktorym go zatrzymalismy - mozna samemu ustalic pozycje odtwarzania, ale to pozniej
inna przydatna funkcja moze byc:
int voice_get_position( int voice );
if( voice_get_position( 0 ) < 0 )
{
voice_start( 0 );
}
funkcja zwraca pozycje w odtwarzanym utworze, jesli odtwarzanie zakonczone, zwraca -1, dzieki temu mozemy np zablokowac zalaczanie sie tego samego utworu, dopoki jest odtwarzany.
mozemy tez ustalic pozycje odtwarzania w dzwieku, np dlatego, ze po jego zatrzymaniu, ustawic odtwarzanie od poczatku(przypominam, ze voice_stop zapamietuje pozycje odtwarzania i jej nie zmienia)
void voice_set_position( int voice, int position );
teraz kolejna ciekawa funkcja:
void voice_ramp_volume( int voice, int time, int endvol );
voice - nr dzwieku, time - czas w milisekundach, endvol - zadana glosnosc.
funkcja ta sluzy do zmiany glosnosci w ciagu zadanego czasu, czyli:
voice_ramp_volume( 0, 1000, 255 )
spowoduje zglosnienie sie naszego dzwieku (glos ustawilismy na 100 na poczatku), wiec program przekreci pokretlo glosnosci ze 100 na 255 w ciagu 1 sekundy, operacje ta mozna przerwac przez
void voice_stop_volumeramp( int voice );
na koniec pracy z dzwiekiem, nalezy zwolnic pamiec, w tym celu uzyjemy
void release_voice( int voice );
void deallocate_voice( int voice );
Funkcje maja te samo zadanie, roznia sie jednak tym, ze pierwsza pozwala dzwiekowi dograc do konca, druga go zatrzymuje - wiec wybor, z ktorej skorzystamy, zalezy od potrzeb. Nie zapominajmy, ze SAMPLE tez trzeba zwolnic z pamieci przez
destroy_sample( muzyczka );
jesli chcemy, aby nasz zaalokowany voice wskazywal na inny dzwiek, nie musimy tworzyc nowego, jesli stary na nic juz nie wskazuje, mozemy go realokowac, czyli:
void reallocate_voice( int voice, const SAMPLE * spl );
deallocate_voice( muzyczka );
voice = allocate_voice( nowy_sample );
tutaj tez warto pamietac o zwolnieniu pamieci przez SAMPLE, ktory juz nie jest przypisany do voice, a jest juz nieuzywany
SAMPLE * voice_check( int voice );
w ten sposob sprawdzamy, czy voice wskazuje na jakis dzwiek, jesli nie, zwroci false.
funkcja ponizej sluzy do ustawienia priorytetu dla voice
void voice_set_priority( int voice, int priority );
po co? a po to, ze jesli nasz sprzet nie bedzie mogl obsluzyc wiecej dzwiekow, te z najnizszym priorytetem zostana odrzucone
void voice_set_frequency( int voice, int frequency );
ta funkcja pozwala ustalic czestotliwosc odtwarzania, frequency podajemu w Hz
void voice_sweep_frequency( int voice, int time, int endfreq );
void voice_stop_frequency_sweep( int voice );
cos jak z samozglasnianiem, tutaj ustalamy zadana czestotliwosc i czas, w jakim ma sie zmienic od obecnej do zadanej, oraz funkcja przerywajaca dzialanie tej pierwszej
poza tym sa funkcje pobierajace wartosci, takie jak glosnosc, balans, czestotliwosc
int voice_get_volume( int voice );
int voice_get_frequency( int voice );
int voice_get_pan( int voice );
chcac zaladowac wiecej dzwiekow, postepujemy podobnie, jak na poczatku, czyli
SAMPLE * kroki = load_sample( "dzwiek42.wav" );
SAMPLE * podskok = load_sample( "dzwiek76.wav" );
allocate_voice( kroki );
allocate_voice( podskok );
teraz dostep do tych dzwiekow mamy poprzez :
voice_start( 1 );
if( get_voice_position( 1 ) < 0 )
{
voice_start( 2 );
}
Mam nadzieje, ze chociaz troche przyblizylem temat wykorzystania tych funkcji i ze komus sie one przydadza, to moj pierwszy post tego typu, wiec mam nadzieje, ze moj jezyk pisania jest w miare czytelny, w razie czego prosze o uwagi, oraz oczywscie o poprawienie, jesli cos napisalem blednie, dzieki :)