mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-22 16:26:39 +00:00
ef5004e56e
Original commit message from CVS: * gst/audioconvert/audioconvert.h: * gst/audioconvert/gstaudioquantize.c: (gst_audio_quantize_setup_dither), (gst_audio_quantize_free_dither): * gst/audioconvert/gstfastrandom.h: Implement a linear congruential generator as pseudo random number generator for the dither noise. This is about 2 times faster than using GLib's mersenne twister. Also this uses only integer math for generating integers while GLib internally uses floating point math.
143 lines
3.9 KiB
C
143 lines
3.9 KiB
C
/* GStreamer
|
|
* Copyright (C) 2004 Ronald Bultje <rbultje@ronald.bitfreak.net>
|
|
*
|
|
* audioconvert.h: audio format conversion library
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef __AUDIO_CONVERT_H__
|
|
#define __AUDIO_CONVERT_H__
|
|
|
|
#include <gst/gst.h>
|
|
#include <gst/audio/multichannel.h>
|
|
|
|
/**
|
|
* GstAudioConvertDithering:
|
|
* @DITHER_NONE: No dithering
|
|
* @DITHER_RPDF: Rectangular dithering
|
|
* @DITHER_TPDF: Triangular dithering (default)
|
|
* @DITHER_TPDF_HF: High frequency triangular dithering
|
|
*
|
|
* Set of available dithering methods when converting audio.
|
|
*/
|
|
typedef enum
|
|
{
|
|
DITHER_NONE = 0,
|
|
DITHER_RPDF,
|
|
DITHER_TPDF,
|
|
DITHER_TPDF_HF
|
|
} GstAudioConvertDithering;
|
|
|
|
/**
|
|
* GstAudioConvertNoiseShaping:
|
|
* @NOISE_SHAPING_NONE: No noise shaping (default)
|
|
* @NOISE_SHAPING_ERROR_FEEDBACK: Error feedback
|
|
* @NOISE_SHAPING_SIMPLE: Simple 2-pole noise shaping
|
|
* @NOISE_SHAPING_MEDIUM: Medium 5-pole noise shaping
|
|
* @NOISE_SHAPING_HIGH: High 8-pole noise shaping
|
|
*
|
|
* Set of available noise shaping methods
|
|
*/
|
|
typedef enum
|
|
{
|
|
NOISE_SHAPING_NONE = 0,
|
|
NOISE_SHAPING_ERROR_FEEDBACK,
|
|
NOISE_SHAPING_SIMPLE,
|
|
NOISE_SHAPING_MEDIUM,
|
|
NOISE_SHAPING_HIGH
|
|
} GstAudioConvertNoiseShaping;
|
|
|
|
typedef struct _AudioConvertCtx AudioConvertCtx;
|
|
typedef struct _AudioConvertFmt AudioConvertFmt;
|
|
|
|
struct _AudioConvertFmt
|
|
{
|
|
/* general caps */
|
|
gboolean is_int;
|
|
gint endianness;
|
|
gint width;
|
|
gint rate;
|
|
gint channels;
|
|
GstAudioChannelPosition *pos;
|
|
gboolean unpositioned_layout;
|
|
|
|
/* int audio caps */
|
|
gboolean sign;
|
|
gint depth;
|
|
|
|
gint unit_size;
|
|
};
|
|
|
|
typedef void (*AudioConvertUnpack) (gpointer src, gpointer dst, gint scale,
|
|
gint count);
|
|
typedef void (*AudioConvertPack) (gpointer src, gpointer dst, gint scale,
|
|
gint count);
|
|
|
|
typedef void (*AudioConvertMix) (AudioConvertCtx *, gpointer, gpointer, gint);
|
|
typedef void (*AudioConvertQuantize) (AudioConvertCtx * ctx, gpointer src,
|
|
gpointer dst, gint count);
|
|
|
|
struct _AudioConvertCtx
|
|
{
|
|
AudioConvertFmt in;
|
|
AudioConvertFmt out;
|
|
|
|
AudioConvertUnpack unpack;
|
|
AudioConvertPack pack;
|
|
|
|
/* channel conversion matrix, m[in_channels][out_channels].
|
|
* If identity matrix, passthrough applies. */
|
|
gfloat **matrix;
|
|
/* temp storage for channelmix */
|
|
gpointer tmp;
|
|
|
|
gboolean in_default;
|
|
gboolean mix_passthrough;
|
|
gboolean out_default;
|
|
|
|
gpointer tmpbuf;
|
|
gint tmpbufsize;
|
|
|
|
gint in_scale;
|
|
gint out_scale;
|
|
|
|
AudioConvertMix channel_mix;
|
|
|
|
AudioConvertQuantize quantize;
|
|
|
|
GstAudioConvertDithering dither;
|
|
GstAudioConvertNoiseShaping ns;
|
|
/* last random number generated per channel for hifreq TPDF dither */
|
|
gpointer last_random;
|
|
/* contains the past quantization errors, error[out_channels][count] */
|
|
gdouble *error_buf;
|
|
};
|
|
|
|
gboolean audio_convert_clean_fmt (AudioConvertFmt * fmt);
|
|
|
|
gboolean audio_convert_prepare_context (AudioConvertCtx * ctx,
|
|
AudioConvertFmt * in, AudioConvertFmt * out,
|
|
GstAudioConvertDithering dither, GstAudioConvertNoiseShaping ns);
|
|
gboolean audio_convert_get_sizes (AudioConvertCtx * ctx, gint samples,
|
|
gint * srcsize, gint * dstsize);
|
|
|
|
gboolean audio_convert_clean_context (AudioConvertCtx * ctx);
|
|
|
|
gboolean audio_convert_convert (AudioConvertCtx * ctx, gpointer src,
|
|
gpointer dst, gint samples, gboolean src_writable);
|
|
|
|
#endif /* __AUDIO_CONVERT_H__ */
|