← Back to branch summary

~ubuntu-branches/debian/sid/flightgear/sid

« back to all changes in this revision

Viewing changes to 3rdparty/iaxclient/lib/portaudio/src/common/pa_converters.h

  • Committer: Package Import Robot
  • Author(s): Markus Wanner, Markus Wanner, Rebecca Palmer
  • Date: 2014-01-21 22:31:02 UTC
  • mfrom: (1.3.1) (15.1.2 experimental)
  • Revision ID: package-import@ubuntu.com-20140121223102-cjw7g9le25acd119
Tags: 3.0.0~git20140204+c99ea4-1
http://bugs.debian.org/724686
http://bugs.debian.org/556362
http://bugs.debian.org/698308
http://bugs.debian.org/574173
http://bugs.debian.org/738436
http://bugs.debian.org/682947
http://bugs.debian.org/713924
http://bugs.debian.org/252899
[ Markus Wanner ]
* Upload to unstable.
* Adjust B-D to allow building on kfreebsd-*. Closes: #724686.
* Add a lintian-overrides on autotools; we use cmake.
* Upstream corrected the fgfs manpage. Closes: #556362.
* Drop unnecessary man page for gl-info. Closes: #698308.
* Drop README.Linux: it's outdated to the point of uselessness.
  Closes: #574173.
* Add an upper limit of libsimgear-dev versions that flightgear can be
  built with. Closes: #738436.
* Drop the libsvn-dev dependency, neither flightgear nor simgear depend
  on libsvn, anymore. Closes: #682947.
* List icons in debian/install rather than copying around from rules.
* Update menu entry for flightgear, add one for fgcom; add .xpm icons.
  Closes: #713924.
* flightgear.desktop: add German translation
* Bump Standards-Version to 3.9.5; no changes needed.

[ Rebecca Palmer ]
* New upstream release.
* Install the icons (based on code by Saikrishna Arcot).  (Not a
  complete fix for LP908153 as it only sets the menu/Dash icon, not the
  running window's icon, but better than nothing).
* Disable screensaver while running. Closes: LP#793599. Add required
  libdbus-1-dev dependency.
* Remove outdated README.Debian.
* Terrasync now works after just ticking the box. Closes: #252899.
* Always set Terrasync directory.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3rdparty/iaxclient/lib/portaudio/src/common/pa_converters.h
 
1
#ifndef PA_CONVERTERS_H
 
2
#define PA_CONVERTERS_H
 
3
/*
 
4
 * $Id: pa_converters.h,v 1.1 2006/06/10 21:30:55 dmazzoni Exp $
 
5
 * Portable Audio I/O Library sample conversion mechanism
 
6
 *
 
7
 * Based on the Open Source API proposed by Ross Bencina
 
8
 * Copyright (c) 1999-2002 Phil Burk, Ross Bencina
 
9
 *
 
10
 * Permission is hereby granted, free of charge, to any person obtaining
 
11
 * a copy of this software and associated documentation files
 
12
 * (the "Software"), to deal in the Software without restriction,
 
13
 * including without limitation the rights to use, copy, modify, merge,
 
14
 * publish, distribute, sublicense, and/or sell copies of the Software,
 
15
 * and to permit persons to whom the Software is furnished to do so,
 
16
 * subject to the following conditions:
 
17
 *
 
18
 * The above copyright notice and this permission notice shall be
 
19
 * included in all copies or substantial portions of the Software.
 
20
 *
 
21
 * Any person wishing to distribute modifications to the Software is
 
22
 * requested to send the modifications to the original developer so that
 
23
 * they can be incorporated into the canonical version.
 
24
 *
 
25
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 
26
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
27
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
28
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
 
29
 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
 
30
 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 
31
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
32
 */
 
33
 
 
34
/** @file
 
35
 @brief Conversion functions used to convert buffers of samples from one
 
36
 format to another.
 
37
*/
 
38
 
 
39
 
 
40
#include "portaudio.h"  /* for PaSampleFormat */
 
41
 
 
42
#ifdef __cplusplus
 
43
extern "C"
 
44
{
 
45
#endif /* __cplusplus */
 
46
 
 
47
 
 
48
struct PaUtilTriangularDitherGenerator;
 
49
 
 
50
 
 
51
/** Choose an available sample format which is most appropriate for
 
52
 representing the requested format. If the requested format is not available
 
53
 higher quality formats are considered before lower quality formates.
 
54
 @param availableFormats A variable containing the logical OR of all available
 
55
 formats.
 
56
 @param format The desired format.
 
57
 @return The most appropriate available format for representing the requested
 
58
 format.
 
59
*/
 
60
PaSampleFormat PaUtil_SelectClosestAvailableFormat(
 
61
        PaSampleFormat availableFormats, PaSampleFormat format );
 
62
 
 
63
 
 
64
/* high level conversions functions for use by implementations */
 
65
 
 
66
 
 
67
/** The generic sample converter prototype. Sample converters convert count
 
68
    samples from sourceBuffer to destinationBuffer. The actual type of the data
 
69
    pointed to by these parameters varys for different converter functions.
 
70
    @param destinationBuffer A pointer to the first sample of the destination.
 
71
    @param destinationStride An offset between successive destination samples
 
72
    expressed in samples (not bytes.) It may be negative.
 
73
    @param sourceBuffer A pointer to the first sample of the source.
 
74
    @param sourceStride An offset between successive source samples
 
75
    expressed in samples (not bytes.) It may be negative.
 
76
    @param count The number of samples to convert.
 
77
    @param ditherState State information used to calculate dither. Converters
 
78
    that do not perform dithering will ignore this parameter, in which case
 
79
    NULL or invalid dither state may be passed.
 
80
*/
 
81
typedef void PaUtilConverter(
 
82
    void *destinationBuffer, signed int destinationStride,
 
83
    void *sourceBuffer, signed int sourceStride,
 
84
    unsigned int count, struct PaUtilTriangularDitherGenerator *ditherGenerator );
 
85
 
 
86
 
 
87
/** Find a sample converter function for the given source and destinations
 
88
    formats and flags (clip and dither.)
 
89
    @return
 
90
    A pointer to a PaUtilConverter which will perform the requested
 
91
    conversion, or NULL if the given format conversion is not supported.
 
92
    For conversions where clipping or dithering is not necessary, the
 
93
    clip and dither flags are ignored and a non-clipping or dithering
 
94
    version is returned.
 
95
    If the source and destination formats are the same, a function which
 
96
    copies data of the appropriate size will be returned.
 
97
*/
 
98
PaUtilConverter* PaUtil_SelectConverter( PaSampleFormat sourceFormat,
 
99
        PaSampleFormat destinationFormat, PaStreamFlags flags );
 
100
 
 
101
 
 
102
/** The generic buffer zeroer prototype. Buffer zeroers copy count zeros to
 
103
    destinationBuffer. The actual type of the data pointed to varys for
 
104
    different zeroer functions.
 
105
    @param destinationBuffer A pointer to the first sample of the destination.
 
106
    @param destinationStride An offset between successive destination samples
 
107
    expressed in samples (not bytes.) It may be negative.
 
108
    @param count The number of samples to zero.
 
109
*/
 
110
typedef void PaUtilZeroer(
 
111
    void *destinationBuffer, signed int destinationStride, unsigned int count );
 
112
 
 
113
    
 
114
/** Find a buffer zeroer function for the given destination format.
 
115
    @return
 
116
    A pointer to a PaUtilZeroer which will perform the requested
 
117
    zeroing.
 
118
*/
 
119
PaUtilZeroer* PaUtil_SelectZeroer( PaSampleFormat destinationFormat );
 
120
 
 
121
/*----------------------------------------------------------------------------*/
 
122
/* low level functions and data structures which may be used for
 
123
    substituting conversion functions */
 
124
 
 
125
 
 
126
/** The type used to store all sample conversion functions.
 
127
    @see paConverters;
 
128
*/
 
129
typedef struct{
 
130
    PaUtilConverter *Float32_To_Int32;
 
131
    PaUtilConverter *Float32_To_Int32_Dither;
 
132
    PaUtilConverter *Float32_To_Int32_Clip;
 
133
    PaUtilConverter *Float32_To_Int32_DitherClip;
 
134
 
 
135
    PaUtilConverter *Float32_To_Int24;
 
136
    PaUtilConverter *Float32_To_Int24_Dither;
 
137
    PaUtilConverter *Float32_To_Int24_Clip;
 
138
    PaUtilConverter *Float32_To_Int24_DitherClip;
 
139
    
 
140
    PaUtilConverter *Float32_To_Int16;
 
141
    PaUtilConverter *Float32_To_Int16_Dither;
 
142
    PaUtilConverter *Float32_To_Int16_Clip;
 
143
    PaUtilConverter *Float32_To_Int16_DitherClip;
 
144
 
 
145
    PaUtilConverter *Float32_To_Int8;
 
146
    PaUtilConverter *Float32_To_Int8_Dither;
 
147
    PaUtilConverter *Float32_To_Int8_Clip;
 
148
    PaUtilConverter *Float32_To_Int8_DitherClip;
 
149
 
 
150
    PaUtilConverter *Float32_To_UInt8;
 
151
    PaUtilConverter *Float32_To_UInt8_Dither;
 
152
    PaUtilConverter *Float32_To_UInt8_Clip;
 
153
    PaUtilConverter *Float32_To_UInt8_DitherClip;
 
154
 
 
155
    PaUtilConverter *Int32_To_Float32;
 
156
    PaUtilConverter *Int32_To_Int24;
 
157
    PaUtilConverter *Int32_To_Int24_Dither;
 
158
    PaUtilConverter *Int32_To_Int16;
 
159
    PaUtilConverter *Int32_To_Int16_Dither;
 
160
    PaUtilConverter *Int32_To_Int8;
 
161
    PaUtilConverter *Int32_To_Int8_Dither;
 
162
    PaUtilConverter *Int32_To_UInt8;
 
163
    PaUtilConverter *Int32_To_UInt8_Dither;
 
164
 
 
165
    PaUtilConverter *Int24_To_Float32;
 
166
    PaUtilConverter *Int24_To_Int32;
 
167
    PaUtilConverter *Int24_To_Int16;
 
168
    PaUtilConverter *Int24_To_Int16_Dither;
 
169
    PaUtilConverter *Int24_To_Int8;
 
170
    PaUtilConverter *Int24_To_Int8_Dither;
 
171
    PaUtilConverter *Int24_To_UInt8;
 
172
    PaUtilConverter *Int24_To_UInt8_Dither;
 
173
 
 
174
    PaUtilConverter *Int16_To_Float32;
 
175
    PaUtilConverter *Int16_To_Int32;
 
176
    PaUtilConverter *Int16_To_Int24;
 
177
    PaUtilConverter *Int16_To_Int8;
 
178
    PaUtilConverter *Int16_To_Int8_Dither;
 
179
    PaUtilConverter *Int16_To_UInt8;
 
180
    PaUtilConverter *Int16_To_UInt8_Dither;
 
181
 
 
182
    PaUtilConverter *Int8_To_Float32;
 
183
    PaUtilConverter *Int8_To_Int32;
 
184
    PaUtilConverter *Int8_To_Int24;
 
185
    PaUtilConverter *Int8_To_Int16;
 
186
    PaUtilConverter *Int8_To_UInt8;
 
187
    
 
188
    PaUtilConverter *UInt8_To_Float32;
 
189
    PaUtilConverter *UInt8_To_Int32;
 
190
    PaUtilConverter *UInt8_To_Int24;
 
191
    PaUtilConverter *UInt8_To_Int16;
 
192
    PaUtilConverter *UInt8_To_Int8;
 
193
 
 
194
    PaUtilConverter *Copy_8_To_8;       /* copy without any conversion */
 
195
    PaUtilConverter *Copy_16_To_16;     /* copy without any conversion */
 
196
    PaUtilConverter *Copy_24_To_24;     /* copy without any conversion */
 
197
    PaUtilConverter *Copy_32_To_32;     /* copy without any conversion */
 
198
} PaUtilConverterTable;
 
199
 
 
200
 
 
201
/** A table of pointers to all required converter functions.
 
202
    PaUtil_SelectConverter() uses this table to lookup the appropriate
 
203
    conversion functions. The fields of this structure are initialized
 
204
    with default conversion functions. Fields may be NULL, indicating that
 
205
    no conversion function is available. User code may substitue optimised
 
206
    conversion functions by assigning different function pointers to
 
207
    these fields.
 
208
 
 
209
    @note
 
210
    If the PA_NO_STANDARD_CONVERTERS preprocessor variable is defined,
 
211
    PortAudio's standard converters will not be compiled, and all fields
 
212
    of this structure will be initialized to NULL. In such cases, users
 
213
    should supply their own conversion functions if the require PortAudio
 
214
    to open a stream that requires sample conversion.
 
215
 
 
216
    @see PaUtilConverterTable, PaUtilConverter, PaUtil_SelectConverter
 
217
*/
 
218
extern PaUtilConverterTable paConverters;
 
219
 
 
220
 
 
221
/** The type used to store all buffer zeroing functions.
 
222
    @see paZeroers;
 
223
*/
 
224
typedef struct{
 
225
    PaUtilZeroer *ZeroU8; /* unsigned 8 bit, zero == 128 */
 
226
    PaUtilZeroer *Zero8;
 
227
    PaUtilZeroer *Zero16;
 
228
    PaUtilZeroer *Zero24;
 
229
    PaUtilZeroer *Zero32;
 
230
} PaUtilZeroerTable;
 
231
 
 
232
 
 
233
/** A table of pointers to all required zeroer functions.
 
234
    PaUtil_SelectZeroer() uses this table to lookup the appropriate
 
235
    conversion functions. The fields of this structure are initialized
 
236
    with default conversion functions. User code may substitue optimised
 
237
    conversion functions by assigning different function pointers to
 
238
    these fields.
 
239
 
 
240
    @note
 
241
    If the PA_NO_STANDARD_ZEROERS preprocessor variable is defined,
 
242
    PortAudio's standard zeroers will not be compiled, and all fields
 
243
    of this structure will be initialized to NULL. In such cases, users
 
244
    should supply their own zeroing functions for the sample sizes which
 
245
    they intend to use.
 
246
 
 
247
    @see PaUtilZeroerTable, PaUtilZeroer, PaUtil_SelectZeroer
 
248
*/
 
249
extern PaUtilZeroerTable paZeroers;
 
250
 
 
251
#ifdef __cplusplus
 
252
}
 
253
#endif /* __cplusplus */
 
254
#endif /* PA_CONVERTERS_H */