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

load_sample

[funkcja] Wczytuje dźwięk z pliku.

Składnia

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

SAMPLE * load_sample(
const char * filename
);

Argumenty

ArgumentOpis
const char * filenameNazwa pliku z którego ma zostać wczytany dźwięk.

Zwracana wartość

Zwraca wskaźnik na załadowany dźwięk w przypadku sukcesu. W przeciwnym przypadku funkcja zwraca wartość NULL.

Opis szczegółowy

Funkcja wczytuje dźwięk z pliku. Biblioteka Allegro domyślnie wspiera obsługę plików w formacie .wav i .voc. Dla formatu plików .wav zapewnione jest wsparcie 8 i 16 bitowego zapisu  zarówno w trybie mono jak i stereo. W przypadku pliku w formacie .voc wsparcie zostało zapewnione dla trybu mono. Dodatkowe formaty plików dźwiękowych, które mają być obsługiwane mogą zostać zarejestrowane za pomocą funkcji register_sample_file_type.

Dodatkowe informacje

Dźwięk, który został załadowany należy zwolnić po zakończeniu z nim pracy. Do zwalniania załadowanego dźwieku służy funkcja » Allegro 4.4destroy_sample. 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" ); //Przykład użycia funkcji load_sample
   
    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 );
    destroy_sample( dzwiek );
   
    allegro_exit();
    return 0;
}
END_OF_MAIN()

Zagadnienia powiązane

destroy_sampleUsuwa dźwięk z pamięci. (funkcja)
load_wavŁaduje dźwięk z pliku WAV. (funkcja)
load_vocŁaduje dźwięk z pliku VOC. (funkcja)

Linki zewnętrzne