src/audio/SDL_audio_c.h
author Ryan C. Gordon
Mon, 23 Jan 2017 12:06:10 -0500
changeset 10837 c2f241c2f6ad
parent 10815 71bbe3233508
child 10849 bc671e6906ae
permissions -rw-r--r--
audio: Fix same bug as last commit, but for _mm_bslli_si128 vs _mm_slli_si128.
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2017 Sam Lantinga <slouken@libsdl.org>
     4 
     5   This software is provided 'as-is', without any express or implied
     6   warranty.  In no event will the authors be held liable for any damages
     7   arising from the use of this software.
     8 
     9   Permission is granted to anyone to use this software for any purpose,
    10   including commercial applications, and to alter it and redistribute it
    11   freely, subject to the following restrictions:
    12 
    13   1. The origin of this software must not be misrepresented; you must not
    14      claim that you wrote the original software. If you use this software
    15      in a product, an acknowledgment in the product documentation would be
    16      appreciated but is not required.
    17   2. Altered source versions must be plainly marked as such, and must not be
    18      misrepresented as being the original software.
    19   3. This notice may not be removed or altered from any source distribution.
    20 */
    21 
    22 #ifndef SDL_audio_c_h_
    23 #define SDL_audio_c_h_
    24 
    25 #include "../SDL_internal.h"
    26 
    27 #ifndef DEBUG_CONVERT
    28 #define DEBUG_CONVERT 0
    29 #endif
    30 
    31 #if DEBUG_CONVERT
    32 #define LOG_DEBUG_CONVERT(from, to) fprintf(stderr, "Converting %s to %s.\n", from, to);
    33 #else
    34 #define LOG_DEBUG_CONVERT(from, to)
    35 #endif
    36 
    37 /* Functions and variables exported from SDL_audio.c for SDL_sysaudio.c */
    38 
    39 #ifdef HAVE_LIBSAMPLERATE_H
    40 #include "samplerate.h"
    41 extern SDL_bool SRC_available;
    42 extern SRC_STATE* (*SRC_src_new)(int converter_type, int channels, int *error);
    43 extern int (*SRC_src_process)(SRC_STATE *state, SRC_DATA *data);
    44 extern int (*SRC_src_reset)(SRC_STATE *state);
    45 extern SRC_STATE* (*SRC_src_delete)(SRC_STATE *state);
    46 extern const char* (*SRC_src_strerror)(int error);
    47 #endif
    48 
    49 /* Functions to get a list of "close" audio formats */
    50 extern SDL_AudioFormat SDL_FirstAudioFormat(SDL_AudioFormat format);
    51 extern SDL_AudioFormat SDL_NextAudioFormat(void);
    52 
    53 /* Function to calculate the size and silence for a SDL_AudioSpec */
    54 extern void SDL_CalculateAudioSpec(SDL_AudioSpec * spec);
    55 
    56 /* These pointers get set during init to various SIMD implementations. */
    57 extern SDL_AudioFilter SDL_Convert_S8_to_F32;
    58 extern SDL_AudioFilter SDL_Convert_U8_to_F32;
    59 extern SDL_AudioFilter SDL_Convert_S16_to_F32;
    60 extern SDL_AudioFilter SDL_Convert_U16_to_F32;
    61 extern SDL_AudioFilter SDL_Convert_S32_to_F32;
    62 extern SDL_AudioFilter SDL_Convert_F32_to_S8;
    63 extern SDL_AudioFilter SDL_Convert_F32_to_U8;
    64 extern SDL_AudioFilter SDL_Convert_F32_to_S16;
    65 extern SDL_AudioFilter SDL_Convert_F32_to_U16;
    66 extern SDL_AudioFilter SDL_Convert_F32_to_S32;
    67 
    68 
    69 /* SDL_AudioStream is a new audio conversion interface. It
    70     might eventually become a public API.
    71    The benefits vs SDL_AudioCVT:
    72     - it can handle resampling data in chunks without generating
    73       artifacts, when it doesn't have the complete buffer available.
    74     - it can handle incoming data in any variable size.
    75     - You push data as you have it, and pull it when you need it
    76 
    77     (Note that currently this converts as data is put into the stream, so
    78     you need to push more than a handful of bytes if you want decent
    79     resampling. This can be changed later.)
    80  */
    81 
    82 /* this is opaque to the outside world. */
    83 typedef struct SDL_AudioStream SDL_AudioStream;
    84 
    85 /* create a new stream */
    86 SDL_AudioStream *SDL_NewAudioStream(const SDL_AudioFormat src_format,
    87                                     const Uint8 src_channels,
    88                                     const int src_rate,
    89                                     const SDL_AudioFormat dst_format,
    90                                     const Uint8 dst_channels,
    91                                     const int dst_rate);
    92 
    93 /* add data to be converted/resampled to the stream */
    94 int SDL_AudioStreamPut(SDL_AudioStream *stream, const void *buf, const Uint32 len);
    95 
    96 /* get converted/resampled data from the stream */
    97 int SDL_AudioStreamGet(SDL_AudioStream *stream, void *buf, const Uint32 len);
    98 
    99 /* clear any pending data in the stream without converting it. */
   100 void SDL_AudioStreamClear(SDL_AudioStream *stream);
   101 
   102 /* number of converted/resampled bytes available */
   103 int SDL_AudioStreamAvailable(SDL_AudioStream *stream);
   104 
   105 /* dispose of a stream */
   106 void SDL_FreeAudioStream(SDL_AudioStream *stream);
   107 
   108 #endif
   109 
   110 /* vi: set ts=4 sw=4 expandtab: */