load_sample

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

Składnia

#include <allegro.h>

SAMPLE * load_sample(
const char * filename
);

Argumenty

Argument	Opis
const char * filename	Nazwa 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.4 ♦}destroy_sample. Zwalnianie nieużywanych zasobów zapobiega występowaniu wycieków pamięci.

Przykład

#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_sample	Usuwa 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

http://www.allegro.cc/manual/4/api/digital-sample-routines/load_sample

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.