[Allegro, C++] Zaawansowana obsługa dźwięku

VOICE ROUTINES - czyli rozwinięcie SAMPLE ROUTINES

Do podstawowych funkcji pozwalających nam na używanie dźwieków w aplikacjach napisanych w bibliotece Allegro należą te, które operują na strukturach SAMPLE. Jeśli już je poznałeś, a oczekujesz nieco większej kontroli nad dzwiękiem to polecam zapoznanie się z VOICE ROUTINES, czyli z funkcjami do obsługi dźwięku niższego poziomu - czytaj: dających większe możliwości ingerencji w dźwięk oraz większą kontrolę nad tym co się z nim dzieje :)

Wiesz już czym się zajmiemy? No to do dzieła!

W niniejszym artykule skupię się jedynie na samych funkcjach. Zakładam bowiem, że wiesz, jak uruchomić Allegro i odpowiednio wkomponowac poniższe funkcje do swojego kodu :)

Po pierwsze, po staremu, czyli:
Czyli ładujemy do SAMPLE jakiś dźwięk z dysku i sprawdzamy czy został załadowany.

Drugim krokiem jest:
Tutaj przypisujemy do voice nasz dźwięk. Warto wiedzieć, że każdy załadowany dźwięk jest numerowany - pierwszy ma numer 0. Chcąc się dostać do dźwięku w kolejnych funkcjach, będziemy podawali numer dźwięku, który otrzymaliśmy (kolejny dźwięk miałby wartość 1). Po drugie warto wiedzieć, że Allegro zapewnia nam obsługę do 255 takich voice'ów oraz nie gwarantuje, że ta liczba jest wspierana przez posiadany sprzęt, więc raczej nie należy przesadzać :)

Odtwarzanie dźwięku

Mamy teraz przypisany dźwiek do voice nr 0. Możemy go teraz zacząc odtwarzać, ewentualnie najpierw ustalić pewne parametry.
Powyższe wywołanie spowoduje odtwarzanie dźwięku z domyślnymi parametrami(ustawione na początku przez allocate_voice, a więc max glośność, moc rozłożona L50%/P50%, bez zmiany tempa odtwarzania, bez pętli odtwarzania - czyli jednorazowe). Jeśli chcielibyśmy jednak coś zmienić, skorzystamy z innych funkcji, jakie są dostępne w bibliotece Allegro.

Głośność dźwięku

Balansowanie mocy dźwięku na głośniki

Zmiana balansu/rozlozenia mocy na glosniki:

Odtwarzanie jednokrotne i wielokrotne

Funkcja, która umożliwia zadecydowanie, czy dźwięk będzie odtworzony jeden raz czy ma być on powtarzany również istnieje i jest nią voice_set_playmode. Za pomocą tej funkcji możemy również ustalić, czy dźwięk będzie odtworzany od przodu do tyłu, czy też w rewersie.
Za playmode wybieramy:

• PLAYMODE_PLAY - domyślny tryb, gra jednorazowo od początku do końca
• PLAYMODE_LOOP - granie z powtarzaniem, czyli w pętli
• PLAYMODE_FORWARD - granie od początku do końca, przeciwieństwo PLAYMODE_BACKWARD
• PLAYMODE_BACKWARD - rewers, czyli odwrócenie kierunku odtwarzania
• PLAYMODE_BIDIR - kombinacja dwóch powyższych, czyli gra od początku do końca, po czym zmienia kierunek odtwarzania na od końca do początku

Zatrzymanie dźwięku

Zatrzymujemy odtwarzanie dźwięku, ale trzeba pamietać, ze ta funkcja zapamiętuje pozycję, w jakiej dźwięk jest zatrzymany, więc ponowne uruchomienie go nastąpi od miejsca, w którym go zatrzymalismy - można samemu ustalić pozycję odtwarzania, ale to poźniej.

Obecna pozycja odtwarzanego dźwięku

Inną przydatną funkcją może być:
Funkcja zwraca pozycję w odtwarzanym utworze. Jeśli odtwarzanie zostało zakończone funkcja zwraca -1, dzięki czemu możemy np zablokować wielokrotne odtwarzanie samego utworu jeżeli jest on odtwarzany.

Ustawienie pozycji odtwarzania dźwięku

Możemy też ustalić pozycję od której ma nastąpić odtwarzanie dźwięku. Przykładowo po jego zatrzymaniu można ustawić odtwarzanie od początku (przypominam, że voice_stop zapamiętuje pozycję odtwarzania i jej nie zmienia).

Efekty dźwiękowe

Teraz kolejna ciekawa funkcja:
voice - nr dzwieku, time - czas w milisekundach, endvol - zadana glosnosc.
funkcja ta sluzy do zmiany glosnosci w ciagu zadanego czasu, czyli:
Powyższe wywołanie spowoduje zgłośnienie się naszego dźwięku (głos ustawiliśmy na 100 na początku), więc program przekręci pokretło głośności ze 100 na 255 w ciągu 1 sekundy. Operację tą można przerwać przez

Zwalnianie zasobów po dźwięku

Na koniec pracy z dźwiękiem, należy zwolnić pamięć. W tym celu użyjemy
Funkcje mają to samo zadanie - różnią się jednak tym, że pierwsza pozwala dźwiękowi dograć do końca, druga go zatrzymuje. To z której funkcji skorzystamy będzie więc zależne od naszych potrzeb. Nie zapominajmy, ze SAMPLE również trzeba zwolnić z pamięci przez:

Ponowne wykorzystanie tego samego zasobu

Jeśli chcemy, aby nasz zaalokowany voice wskazywał na inny dźwięk, nie musimy tworzyć nowego, jeśli stary na nic juz nie wskazuje. Możemy go realokowac, czyli:
Warto tutaj pamiętać o zwolnieniu pamięci przez SAMPLE, który już nie jest przypisany do voice, a jest już nieużywany.

Sprawdzenie czy dźwięk posiada przypisaną ścieżkę dźwiękową

W ten sposób sprawdzamy, czy voice wskazuje na jakiś dźwięk. Jeśli funkcja nie używa żadnego sampla to funkcja zwróci NULL.

Priorytet dźwięku

Funkcja poniżej służy do ustawienia priorytetu dla voice:
Po co? a po to, że jeśli nasz sprzęt nie będzie mógł obsłużyć więcej dźwięków to te z najniższym priorytetem zostaną odrzucone.

Częstotliwość odtwarzania dźwięku

Ta funkcja pozwala ustalić częstotliwość odtwarzania. Frequency podajemy w Hz.

Efekty związane z częstotliwością dźwięku

Cos jak z samozgłaśnianiem. Tutaj ustalamy żadaną częstotliwość i czas, w jakim ma się zmienić od obecnej do żądanej, oraz funkcja przerywająca działanie te pierwszej.

Funkcje odczytujące informacje o dźwięku

Poza tym są funkcje pobierające wartości, takie jak głośność, balans, częstotliwość

Obsługa kilku dźwięków

Chcąc załadować więcej dźwięków, postępujemy podobnie, jak na początku, czyli:

Teraz dostęp do tych dźwięków mamy poprzez:
Mam nadzieję, że chociaż trochę przybliżyłem temat wykorzystania tych funkcji i ze komuś się one przydadzą, to mój pierwszy artykuł tego typu, więc mam nadzieję, że mój język pisania jest w miarę czytelny, dzięki :)