From f449a553a76846c27a5cd229a197070e7059071f Mon Sep 17 00:00:00 2001 From: Matthieu De Beule Date: Sun, 25 Oct 2020 16:39:48 +0000 Subject: Tell programmers that set_volume uses linear scale (fixes https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/issues/1439) Part-of: --- gst-libs/gst/player/gstplayer.c | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'gst-libs/gst') diff --git a/gst-libs/gst/player/gstplayer.c b/gst-libs/gst/player/gstplayer.c index a1eea9f58..23a99ae9a 100644 --- a/gst-libs/gst/player/gstplayer.c +++ b/gst-libs/gst/player/gstplayer.c @@ -859,6 +859,10 @@ gst_player_get_volume (GstPlayer * self) * @val: the new volume level, as a percentage between 0 and 1 * * Sets the volume level of the stream as a percentage between 0 and 1. + * + * This volume is a linear factor. For showing the volume in a GUI it + * might make sense to first convert from a different format. Volume sliders + * should usually use a cubic volume. See gst_stream_volume_convert_volume(). */ void gst_player_set_volume (GstPlayer * self, gdouble val) -- cgit v1.2.1