alutCreateBufferHelloWorld
Inhaltsverzeichnis
alutCreateBufferHelloWorld
Name
alutCreateBufferHelloWorld - Erzeugt einen Puffer mit einem "Hello, world!"-Sound.
Delphi-Spezifikation
function alutCreateBufferHelloWorld: TALuint;
Parameter
Diese Funktion hat keine Parameter.
Beschreibung
Die Funktion alutCreateBufferHelloWorld erzeugt einen OpenAL-Puffer, welcher Audiodaten enthält, wie jemand "Hello, world!" sagt. Im Erfolgsfall wird der Name des Puffers zurückgegeben, bei Fehlschlag ist der Rückgabewert AL_NONE.
Hinweise
Falls bei der Ausführung ein Fehler auftritt, kann dieser mit alutGetError erfragt werden.
Fehlermeldungen
ALUT_ERROR_AL_ERROR_ON_ENTRY wird generiert, sofern beim Aufruf der Funktion bereits ein AL-Fehlerstatus vorhanden war. (Siehe auch alGetError.)
ALUT_ERROR_ALC_ERROR_ON_ENTRY wird generiert, wenn beim Aufruf der Funktion bereits ein ALC-Fehlerstatus vorhanden war. (Siehe auch alcGetError.)
ALUT_ERROR_BUFFER_DATA wird generiert, falls beim Befüllen eines AL-Puffers mit Audiodaten ein Fehler auftrat.
ALUT_ERROR_GEN_BUFFERS wird generiert, wenn beim Erzeugen des Puffers ein Fehler auftrat.
ALUT_ERROR_INVALID_OPERATION wird generiert, falls die ALUT nicht initialisiert wurde. (Siehe alutInit.)
ALUT_ERROR_NO_CURRENT_CONTEXT wird generiert, wenn es keinen aktuellen AL-Kontext gibt. (Siehe alcMakeContextCurrent.)
ALUT_ERROR_OUT_OF_MEMORY wird generiert, sofern nicht genügend Speicher zur Verfügung steht.
Beispiel
Als Beispiel sei hier eines dieser traditionellen "Hello world!"-Programme angeführt, wie es sie für viele Programmiersprachen oder Bibliotheken gibt, jedoch besteht der wesentliche Unterschied darin, dass diesmal nicht ein einfacher Schriftzug auf den Bildschirm geschrieben wird, sondern dass jemand tatsächlich "Hello, world!" sagt.
#include <stdlib.h>
#include <AL/alut.h>
int main (int argc, char **argv)
{
//Variablen fuer Name des Puffers und des Source-Objektes
ALuint helloBuffer, helloSource;
//Initialisierung von ALUT
alutInit (&argc, argv);
//Puffer anlegen und Puffername speichern
helloBuffer = alutCreateBufferHelloWorld();
//ein Source-Objekt erzeugen
alGenSources(1, &helloSource);
//Puffer dem erstellten Source-Objekt zuweisen
alSourcei(helloSource, AL_BUFFER, helloBuffer);
//Sound abspielen
alSourcePlay(helloSource);
//eine Sekunde warten, damit der Klang abgespielt werden kann
alutSleep(1.0);
//ALUT beenden
alutExit();
return 0;
}
In dem Programm fehlen jegliche Fehlerabfragen, um es einfach zu halten.
