2001-12-22 23:27:17 +00:00
|
|
|
/* -*- c-basic-offset: 2 -*-
|
2005-08-22 09:35:57 +00:00
|
|
|
* vi:si:et:sw=2:sts=8:ts=8:expandtab
|
|
|
|
*
|
2001-12-22 23:27:17 +00:00
|
|
|
* GStreamer
|
|
|
|
* Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
|
2010-02-17 18:18:29 +00:00
|
|
|
* Copyright (C) 2010 Sebastian Dröge <sebastian.droege@collabora.co.uk>
|
2001-12-22 23:27:17 +00:00
|
|
|
*
|
|
|
|
* 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
|
2012-11-03 23:05:09 +00:00
|
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
|
|
* Boston, MA 02110-1301, USA.
|
2001-12-22 23:27:17 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __GST_VOLUME_H__
|
|
|
|
#define __GST_VOLUME_H__
|
|
|
|
|
|
|
|
#include <gst/gst.h>
|
2005-08-23 18:19:10 +00:00
|
|
|
#include <gst/base/gstbasetransform.h>
|
2011-11-30 06:57:02 +00:00
|
|
|
#include <gst/audio/streamvolume.h>
|
2008-01-03 20:33:58 +00:00
|
|
|
#include <gst/audio/audio.h>
|
|
|
|
#include <gst/audio/gstaudiofilter.h>
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2005-05-09 21:37:17 +00:00
|
|
|
G_BEGIN_DECLS
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2020-03-12 12:32:23 +00:00
|
|
|
#define GST_TYPE_VOLUME (gst_volume_get_type())
|
|
|
|
G_DECLARE_FINAL_TYPE (GstVolume, gst_volume, GST, VOLUME, GstAudioFilter)
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2006-03-01 17:39:28 +00:00
|
|
|
/**
|
|
|
|
* GstVolume:
|
|
|
|
*
|
|
|
|
* Opaque data structure.
|
|
|
|
*/
|
2004-03-15 16:32:55 +00:00
|
|
|
struct _GstVolume {
|
2008-01-03 20:33:58 +00:00
|
|
|
GstAudioFilter element;
|
2005-05-09 21:37:17 +00:00
|
|
|
|
gst/volume/gstvolume.*: Extend float audio support (double) and some int->uint cleanups.
Original commit message from CVS:
* gst/volume/gstvolume.c: (volume_choose_func),
(volume_update_real_volume), (gst_volume_set_volume),
(gst_volume_init), (volume_process_double), (volume_process_float),
(volume_process_int16), (volume_process_int16_clamp),
(volume_set_caps), (volume_transform_ip), (volume_update_volume):
* gst/volume/gstvolume.h:
Extend float audio support (double) and some int->uint cleanups.
2007-02-21 13:08:51 +00:00
|
|
|
void (*process)(GstVolume*, gpointer, guint);
|
2010-02-17 18:18:29 +00:00
|
|
|
void (*process_controlled)(GstVolume*, gpointer, gdouble *, guint, guint);
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2004-03-15 16:32:55 +00:00
|
|
|
gboolean mute;
|
gst/volume/gstvolume.*: Cleanup volume, define and use default values.
Original commit message from CVS:
* gst/volume/gstvolume.c: (volume_choose_func),
(volume_update_volume), (gst_volume_set_volume),
(gst_volume_get_volume), (gst_volume_set_mute),
(gst_volume_class_init), (gst_volume_init),
(volume_process_double), (volume_process_float),
(volume_process_int32), (volume_process_int32_clamp),
(volume_process_int24), (volume_process_int24_clamp),
(volume_process_int16), (volume_process_int16_clamp),
(volume_process_int8), (volume_process_int8_clamp), (volume_setup),
(volume_transform_ip), (volume_set_property),
(volume_get_property):
* gst/volume/gstvolume.h:
Cleanup volume, define and use default values.
Recalculate new volume and mute setup before processing. Fixes #561789.
* tests/check/elements/volume.c: (GST_START_TEST), (volume_suite):
Add controller unit test. Patch by: Jonathan Matthew
Fix bogus test that messed with basetransform's internal state.
2008-11-24 12:03:11 +00:00
|
|
|
gfloat volume;
|
|
|
|
|
|
|
|
gboolean current_mute;
|
2017-04-11 08:16:33 +00:00
|
|
|
gdouble current_volume;
|
gst/volume/gstvolume.*: Cleanup volume, define and use default values.
Original commit message from CVS:
* gst/volume/gstvolume.c: (volume_choose_func),
(volume_update_volume), (gst_volume_set_volume),
(gst_volume_get_volume), (gst_volume_set_mute),
(gst_volume_class_init), (gst_volume_init),
(volume_process_double), (volume_process_float),
(volume_process_int32), (volume_process_int32_clamp),
(volume_process_int24), (volume_process_int24_clamp),
(volume_process_int16), (volume_process_int16_clamp),
(volume_process_int8), (volume_process_int8_clamp), (volume_setup),
(volume_transform_ip), (volume_set_property),
(volume_get_property):
* gst/volume/gstvolume.h:
Cleanup volume, define and use default values.
Recalculate new volume and mute setup before processing. Fixes #561789.
* tests/check/elements/volume.c: (GST_START_TEST), (volume_suite):
Add controller unit test. Patch by: Jonathan Matthew
Fix bogus test that messed with basetransform's internal state.
2008-11-24 12:03:11 +00:00
|
|
|
|
volume: support arbitrarily-large positive gains
The current limit is `x10`, which allows just `+20 dB` of gain.
While it may seem sufficient, this came up as a problem
in a real-world, non-specially-engineered situation,
in strawberry's EBU R 128 loudness normalization.
(https://github.com/strawberrymusicplayer/strawberry/pull/1216)
There is an audio track (that was not intentionally engineered that way),
that has integrated loudness of `-38 LUFS`,
and if we want to normalize it's loudness to e.g. `-16 LUFS`,
which is a very reasonable thing to do,
we need to apply gain of `+22 dB`,
which is larger than `+20 dB`, and we fail...
I think it should allow at least `+96 dB` of gain,
and therefore should be at `10^(96/20) ~= 63096`.
But, i don't see why we need to put any specific restriction
on that parameter in the first place, other than the fact
that the fixed-point multiplication scheme does not support volume
larger than 15x-ish.
So let's just implement a floating-point fall-back path
that does not involve fixed-point multiplication
and lift the restriction altogether?
Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/5063>
2023-07-19 00:11:52 +00:00
|
|
|
gint64 current_vol_i32;
|
|
|
|
gint64 current_vol_i24; /* the _i(nt) values get synchronized with the */
|
|
|
|
gint64 current_vol_i16; /* the _i(nt) values get synchronized with the */
|
|
|
|
gint64 current_vol_i8; /* the _i(nt) values get synchronized with the */
|
|
|
|
|
2004-03-15 16:32:55 +00:00
|
|
|
GList *tracklist;
|
2008-11-05 19:18:25 +00:00
|
|
|
gboolean negotiated;
|
2010-02-17 18:18:29 +00:00
|
|
|
|
|
|
|
gboolean *mutes;
|
|
|
|
guint mutes_count;
|
|
|
|
gdouble *volumes;
|
|
|
|
guint volumes_count;
|
2004-03-15 16:32:55 +00:00
|
|
|
};
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2021-02-11 10:15:10 +00:00
|
|
|
GST_ELEMENT_REGISTER_DECLARE (volume);
|
|
|
|
|
2005-05-09 21:37:17 +00:00
|
|
|
G_END_DECLS
|
2001-12-22 23:27:17 +00:00
|
|
|
|
2004-03-15 16:32:55 +00:00
|
|
|
#endif /* __GST_VOLUME_H__ */
|