summaryrefslogtreecommitdiff
path: root/apps/plugin.h
diff options
context:
space:
mode:
authorAidan MacDonald <amachronic@protonmail.com>2022-11-22 04:10:35 +0000
committerAidan MacDonald <amachronic@protonmail.com>2023-01-22 21:19:57 +0000
commit5b27e2255a8bbb8645f089b8e721343bba5bd396 (patch)
treebd29ddf9d2a0c07b1541ad4bace7ff4aedcb3c14 /apps/plugin.h
parent15c4447b6681cadba960aa9275592049afa96893 (diff)
downloadrockbox-5b27e2255a8bbb8645f089b8e721343bba5bd396.tar.gz
rockbox-5b27e2255a8bbb8645f089b8e721343bba5bd396.zip
Add perceptual volume adjustment
The perceived loudness change of a change in volume depends on the listening volume: at high volumes a 1 dB increment is noticeable, but at low volumes a larger increment is needed to get a comparable change in loudness. Perceptual volume adjustment accounts for this fact, and divides the hardware volume range into a number of steps. Each step changes the dB volume by a variable amount, with most of the steps concentrated at higher volumes. This makes it possible to sweep over the entire hardware volume range quickly, without losing the ability to finely adjust the volume at normal listening levels. Use "Volume Adjustment Mode" in the system settings menu to select perceptual volume mode. The number of steps used is controlled by "Number of Volume Steps". (Number of steps has no effect in direct adjustment mode.) It's still possible to set a specific dB volume level from the sound settings menu when perceptual volume is enabled, and perceptual volume does not affect the volume displayed by themes. Change-Id: I6f91fd3f7c5e2d323a914e47b5653033e92b4b3b
Diffstat (limited to 'apps/plugin.h')
-rw-r--r--apps/plugin.h3
1 files changed, 2 insertions, 1 deletions
diff --git a/apps/plugin.h b/apps/plugin.h
index 20df7e72f2..286a5e2794 100644
--- a/apps/plugin.h
+++ b/apps/plugin.h
@@ -158,7 +158,7 @@ int plugin_open(const char *plugin, const char *parameter);
158#define PLUGIN_MAGIC 0x526F634B /* RocK */ 158#define PLUGIN_MAGIC 0x526F634B /* RocK */
159 159
160/* increase this every time the api struct changes */ 160/* increase this every time the api struct changes */
161#define PLUGIN_API_VERSION 264 161#define PLUGIN_API_VERSION 265
162 162
163/* update this to latest version if a change to the api struct breaks 163/* update this to latest version if a change to the api struct breaks
164 backwards compatibility (and please take the opportunity to sort in any 164 backwards compatibility (and please take the opportunity to sort in any
@@ -954,6 +954,7 @@ struct plugin_api {
954#ifdef HAVE_TAGCACHE 954#ifdef HAVE_TAGCACHE
955 bool (*tagtree_subentries_do_action)(bool (*action_cb)(const char *file_name)); 955 bool (*tagtree_subentries_do_action)(bool (*action_cb)(const char *file_name));
956#endif 956#endif
957 void (*adjust_volume)(int steps);
957}; 958};
958 959
959/* plugin header */ 960/* plugin header */