2 * Copyright (C) 2004 Ronald Bultje <rbultje@ronald.bitfreak.net>
4 * audioconvert.h: audio format conversion library
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
22 #ifndef __AUDIO_CONVERT_H__
23 #define __AUDIO_CONVERT_H__
26 #include <gst/audio/audio.h>
28 GST_DEBUG_CATEGORY_EXTERN (audio_convert_debug);
29 #define GST_CAT_DEFAULT (audio_convert_debug)
32 * GstAudioConvertDithering:
33 * @DITHER_NONE: No dithering
34 * @DITHER_RPDF: Rectangular dithering
35 * @DITHER_TPDF: Triangular dithering (default)
36 * @DITHER_TPDF_HF: High frequency triangular dithering
38 * Set of available dithering methods when converting audio.
46 } GstAudioConvertDithering;
49 * GstAudioConvertNoiseShaping:
50 * @NOISE_SHAPING_NONE: No noise shaping (default)
51 * @NOISE_SHAPING_ERROR_FEEDBACK: Error feedback
52 * @NOISE_SHAPING_SIMPLE: Simple 2-pole noise shaping
53 * @NOISE_SHAPING_MEDIUM: Medium 5-pole noise shaping
54 * @NOISE_SHAPING_HIGH: High 8-pole noise shaping
56 * Set of available noise shaping methods
60 NOISE_SHAPING_NONE = 0,
61 NOISE_SHAPING_ERROR_FEEDBACK,
65 } GstAudioConvertNoiseShaping;
67 typedef struct _AudioConvertCtx AudioConvertCtx;
69 typedef struct _AudioConvertFmt AudioConvertFmt;
71 struct _AudioConvertFmt
79 GstAudioChannelPosition *pos;
80 gboolean unpositioned_layout;
90 typedef void (*AudioConvertUnpack) (gpointer src, gpointer dst, gint scale,
92 typedef void (*AudioConvertPack) (gpointer src, gpointer dst, gint scale,
95 typedef void (*AudioConvertMix) (AudioConvertCtx *, gpointer, gpointer, gint);
96 typedef void (*AudioConvertQuantize) (AudioConvertCtx * ctx, gpointer src,
97 gpointer dst, gint count);
99 struct _AudioConvertCtx
104 AudioConvertUnpack unpack;
105 AudioConvertPack pack;
107 /* channel conversion matrix, m[in_channels][out_channels].
108 * If identity matrix, passthrough applies. */
110 /* temp storage for channelmix */
114 gboolean mix_passthrough;
115 gboolean out_default;
123 AudioConvertMix channel_mix;
125 AudioConvertQuantize quantize;
127 GstAudioConvertDithering dither;
128 GstAudioConvertNoiseShaping ns;
129 /* last random number generated per channel for hifreq TPDF dither */
130 gpointer last_random;
131 /* contains the past quantization errors, error[out_channels][count] */
135 gboolean audio_convert_prepare_context (AudioConvertCtx * ctx,
136 GstAudioInfo * in, GstAudioInfo * out,
137 GstAudioConvertDithering dither, GstAudioConvertNoiseShaping ns);
138 gboolean audio_convert_get_sizes (AudioConvertCtx * ctx, gint samples,
139 gint * srcsize, gint * dstsize);
141 gboolean audio_convert_clean_context (AudioConvertCtx * ctx);
143 gboolean audio_convert_convert (AudioConvertCtx * ctx, gpointer src,
144 gpointer dst, gint samples, gboolean src_writable);
146 #endif /* __AUDIO_CONVERT_H__ */