include/share/replaygain_synthesis.h

   1 /* replaygain_synthesis - Routines for applying ReplayGain to a signal
   2  * Copyright (C) 2002-2009  Josh Coalson
   3  * Copyright (C) 2011-2013  Xiph.Org Foundation
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  18  */
  19
  20 #ifndef FLAC__SHARE__REPLAYGAIN_SYNTHESIS_H
  21 #define FLAC__SHARE__REPLAYGAIN_SYNTHESIS_H
  22
  23 #include <stdlib.h> /* for size_t */
  24 #include "FLAC/ordinals.h"
  25
  26 #define FLAC_SHARE__MAX_SUPPORTED_CHANNELS 2
  27
  28 typedef enum {
  29         NOISE_SHAPING_NONE = 0,
  30         NOISE_SHAPING_LOW = 1,
  31         NOISE_SHAPING_MEDIUM = 2,
  32         NOISE_SHAPING_HIGH = 3
  33 } NoiseShaping;
  34
  35 typedef struct {
  36         const float*  FilterCoeff;
  37         FLAC__uint64  Mask;
  38         double        Add;
  39         float         Dither;
  40         float         ErrorHistory     [FLAC_SHARE__MAX_SUPPORTED_CHANNELS] [16];  /* 16th order Noise shaping */
  41         float         DitherHistory    [FLAC_SHARE__MAX_SUPPORTED_CHANNELS] [16];
  42         int           LastRandomNumber [FLAC_SHARE__MAX_SUPPORTED_CHANNELS];
  43         unsigned      LastHistoryIndex;
  44         NoiseShaping  ShapingType;
  45 } DitherContext;
  46
  47 void FLAC__replaygain_synthesis__init_dither_context(DitherContext *dither, int bits, int shapingtype);
  48
  49 /* scale = (float) pow(10., (double)replaygain * 0.05); */
  50 size_t FLAC__replaygain_synthesis__apply_gain(FLAC__byte *data_out, FLAC__bool little_endian_data_out, FLAC__bool unsigned_data_out, const FLAC__int32 * const input[], unsigned wide_samples, unsigned channels, const unsigned source_bps, const unsigned target_bps, const double scale, const FLAC__bool hard_limit, FLAC__bool do_dithering, DitherContext *dither_context);
  51
  52 #endif