Lord Horazont: /* Beschreibung */

2007-02-19T17:53:42Z

‎Beschreibung

Lord Horazont am 19. Februar 2007 um 17:05 Uhr

2007-02-19T17:05:38Z

Neue Seite

= Mix_OpenAudio =

== Name ==
'''Mix_OpenAudio''' - Initialisiert die SDL_Mixer Bibliothek

== Delphi-Spezifikation ==
function '''Mix_OpenAudio'''( ''frequency'' : Integer; ''format'' : UInt16; ''channels'' : Integer; ''chunksize'' : Integer ) : Integer;

== Parameter ==

{| border="1" rules="all"
! ''frequency''
| Ausgabe-Sample-Frequenz in Samples pro Sekunde (Hz). [[MIX_DEFAULT_FREQUENCY]](22050 Hz) kann für die meisten Spiele als guter Wert verwendet werden.
|-
! ''format''
| Ausgabeformat
|-
! ''channels''
| Anzahl der Ausgabekanäle. Dieser Wert hat nichts mit den Mixer-Kanälen zu tun. 2 entspricht hier Stereo, 1 Mono.
|-
! ''chunksize''
| Bytes pro Ausgabesample.
|}

== Beschreibung ==
Diese Funktion muss vor der Benutzung von anderen SDL_Mixer-Funktionen aufgerufen werden.
SDL ''muss'' mit SDL_INIT_AUDIO initialisiert werden vor dem Aufruf dieser Funktion. ''frequency'' auf 44100, also 44.1KHz, zu setzen, würde der Standardrate für CD's entsprechen. Die meisten Spiele kommen mit 22050 aus, vorallem, da 44100 auf älteren PC's zu viel CPU-Leistung ziehen würde. ''chunksize'' ist die Größe jedes Samples. Je kleiner der Wert ist, desto öfter werden die Hook-Funktionen (beispielsweise für Effekte) aufgerufen. Wenn diese Wert zu klein ist, kann der Sound auf älteren Systemen abreißen, ist er zu hoch, hinken die Effekte teilweise hinterher. Der Wert 4096 oder ein größerer ist gut geeignet, wenn man einfach nur Musik abspielt. Dieser Aufruf kann mehere Male hintereinander getätigt werden, aber das Format wird erst geändert, wenn vorher [[Mix_CloseAudio]] sooft aufgerufen wurde, wie davor Mix_OpenAudio, erst dann wird das Gerät geschlossen und dann kann das neue Format verwendet werden. Es werden Standardmäßig 8 Mixerkanäle reserviert.

''format'' basiert auf der Standard-SDL-Audiounterstützung (siehe SDL_audio.pas). Hier noch einmal die Werte:

{| border="1" rules="all"
| ''AUDIO_U8''
| Vorzeichenlose 8-bit Samples
|-
| ''AUDIO_S8''
| Vorzeichenbehaftete 8-bit Samples
|-
| ''AUDIO_U16LSB''
| Vorzeichenlose 16-bit Samples, in Little-Endian Byte-Reihenfolge ([http://de.wikipedia.org/wiki/Byte-Reihenfolge|Byte-Reihenfolge])
|-
| ''AUDIO_S16LSB''
| Vorzeichenbehaftete 16-bit Samples, in Little-Endian Byte-Reihenfolge
|-
| ''AUDIO_U16MSB''
| Vorzeichenlose 16-bit Samples, in Big-Endian Byte-Reihenfolge
|-
| ''AUDIO_S16MSB''
| Vorzeichenbehaftete 16-bit Samples, in Big-Endian Byte-Reihenfolge
|-
| ''AUDIO_U16''
| Entspricht AUDIO_U16LSB (für Abwärtskompatiblitäty)
|-
| ''AUDIO_S16''
| Entspricht AUDIO_S16LSB (für Abwärtskompatiblität)
|-
| ''AUDIO_U16SYS''
| Vorzeichenlose 16-bit Samples, in der Byte-Reihenfolge des Systems
|-
| ''AUDIO_S16SYS''
| Vorzeichenbehaftete 16-bit Samples, in der Byte-Reihenfolge des Systems
|}

MIX_DEFAULT_FORMAT entspricht AUDIO_S16SYS.

== Rückgabewert ==
0 bei Erfolg, -1 bei Fehlern

== Siehe auch ==
[[Mix_CloseAudio]], [[Mix_QuerySpec]], [[Mix_AllocateChannels]]

[[Kategorie:SDLMixer|OpenAudio]]

@@ Zeile 41: / Zeile 41: @@
 |-
 | ''AUDIO_U16LSB''
-| Vorzeichenlose 16-bit Samples, in Little-Endian Byte-Reihenfolge ([http://de.wikipedia.org/wiki/Byte-Reihenfolge|Byte-Reihenfolge])
+| Vorzeichenlose 16-bit Samples, in Little-Endian Byte-Reihenfolge ([http://de.wikipedia.org/wiki/Byte-Reihenfolge Byte-Reihenfolge bei Wikipedia])
 |-
 | ''AUDIO_S16LSB''
@@ Zeile 66: / Zeile 66: @@
 MIX_DEFAULT_FORMAT entspricht AUDIO_S16SYS.
 ==  Rückgabewert ==

Mix OpenAudio - Versionsgeschichte

Lord Horazont: /* Beschreibung */

Lord Horazont am 19. Februar 2007 um 17:05 Uhr