Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Opracował: McAffey
Udoskonalił: Piotr DejaVu Szawdyński
Biblioteki C/C++

adjust_sample

[funkcja] Modyfikuje parametry aktualnie odtwarzanego dźwięku.

Składnia

C/C++
#include <allegro.h>

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

Argumenty

ArgumentOpis
const SAMPLE *splWskaźnik na obecnie odtwarzany dźwięk.
int volGłośność dźwięku. Ten argument uzupełniamy wartością z zakresu 0-255.
int panNatężenie dźwięku. Argument ten decyduje o tym na który głośnik zostanie przekazane więcej mocy. Przy wartości 0 cała moc zostanie przekazana na lewy głośnik, przy wartości 255 cała moc zostanie przekazana na prawy głośnik. Przy wartości 127 moc zostanie rozdzielona po równo na oba głośniki.
int freqCzęstotliwość dźwięku. Ten argument decyduje o prędkości odtwarzanego dźwięku. Przy wartości 500 dźwięk jest odtwarzany 2 razy wolniej. Przy wartości 1000 dźwięk leci z normalną prędkością. Przy wartości 2000 dźwięk jest odtwarzany 2 razy szybciej.
int loopZapętlenie dźwięku. Przy wartości 0 dźwięk zostanie odegrany tylko raz. Przy wartości 1 będzie odgrywany w kółko. Jeżeli dźwięk był wcześniej zapętlony, to ustawienie tego argumentu na wartość 0 spowoduje, że dźwięk zostanie zatrzymany po odtworzeniu jego do samego końca.

Opis szczegółowy

Funkcja modyfikuje parametry aktualnie odtwarzanego dźwięku, który został uruchomiony przy pomocy funkcji » Allegro 4.4play_sample. Funkcja umożliwia wyłączenie trybu zapętlania dźwięku poprzez nadanie wartości 0 dla argumentu loop. Jeżeli dźwięk nie jest odtwarzany to wywołanie niniejszej funkcji nie odnosi żadnego efektu.

Jeżeli odtwarzanych jest kilka kopii tego samego dźwięku to funkcja będzie modyfikować ustawienia pierwszego jaki napotka.

Przykład

C/C++
#include <allegro.h>

int main()
{
    allegro_init();
    install_keyboard();
   
    set_color_depth( 16 );
    set_gfx_mode( GFX_AUTODETECT_WINDOWED, 240, 27, 0, 0 );
   
    install_sound( DIGI_AUTODETECT, MIDI_AUTODETECT, "" );
    set_volume( 255, 255 );
   
    SAMPLE * dzwiek = load_sample( "dzwiek.wav" );
    if( !dzwiek )
    {
        set_gfx_mode( GFX_TEXT, 0, 0, 0, 0 );
        allegro_message( "Nie mogę załadować dźwięku!" );
        allegro_exit();
        return 0;
    }
   
    textprintf_ex( screen, font, 10, 10, makecol( 255, 255, 255 ), - 1, "[ESC] - wyjscie z programu" );
   
    play_sample( dzwiek, 255, 127, 1000, 1 );
   
    rest( 2000 );
   
    adjust_sample( dzwiek, 255, 127, 500, 1 ); //Przykład użycia funkcji adjust_sample
   
    rest( 3000 );
   
    stop_sample( dzwiek );
    destroy_sample( dzwiek );
   
    allegro_exit();
    return 0;
}
END_OF_MAIN()

Zagadnienia powiązane

play_sampleUruchamia odtwarzanie podanego dźwięku. (funkcja)
stop_sampleZatrzymuje odtwarzanie dźwięku. (funkcja)

Linki zewnętrzne