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

stop_sample

[funkcja] Zatrzymuje odtwarzanie dźwięku.

Składnia

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

void stop_sample(
const SAMPLE * spl
);

Argumenty

ArgumentOpis
const SAMPLE *splWskaźnik na załadowany dźwięk, którego odtwarzanie ma zostać zatrzymane.

Opis szczegółowy

Funkcja zatrzymuje wskazany dźwięk, który jest aktualnie odtwarzany.

Uwaga!
Jeżeli odtwarzanych jest kilka kopii tego samego dźwięku to funkcja zatrzyma je wszystkie.

Dodatkowe informacje

Pamiętaj, że funkcja stop_sample tylko zatrzymuje odtwarzanie dźwięku. Dźwięk, którego odtwarzanie zostało zatrzymane pozostaje nadal w pamięci. Pamiętaj o zwolnieniu dźwięku za pomocą funkcji » Allegro 4.4destroy_sample jeżeli dźwięk nie będzie więcej wykorzystywany w Twojej aplikacji. Zwalnianie nieużywanych zasobów zapobiega występowaniu wycieków pamięci.

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 );
    while( !key[ KEY_ESC ] )
    {
    }
   
    stop_sample( dzwiek ); //Przykład użycia funkcji stop_sample
   
    destroy_sample( dzwiek );
   
    allegro_exit();
    return 0;
}
END_OF_MAIN()

Zagadnienia powiązane

play_sampleUruchamia odtwarzanie podanego dźwięku. (funkcja)
adjust_sampleModyfikuje parametry aktualnie odtwarzanego dźwięku. (funkcja)

Linki zewnętrzne