From 8e34037dcd1d4fc1bd266ccbdfc117985ee4ef03 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Tue, 18 Apr 2023 13:52:49 +1000 Subject: doc/user: add a section on natural scrolling Just for completeness, turns out we were missing that one. Signed-off-by: Peter Hutterer --- doc/user/scrolling.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/user/scrolling.rst b/doc/user/scrolling.rst index e568755d..2adec76f 100644 --- a/doc/user/scrolling.rst +++ b/doc/user/scrolling.rst @@ -150,3 +150,23 @@ See the **libinput_event_pointer_get_axis_source()** for details on the behavior of each scroll source. See also http://who-t.blogspot.com.au/2015/03/libinput-scroll-sources.html + +.. _natural_scrolling: + +------------------------------------------------------------------------------ +Natural scrolling vs. traditional scrolling +------------------------------------------------------------------------------ + +Natural scrolling is the term (probably) coined by Apple for matching +the motion of the scroll device with the direction of the **content**. + +In traditional scrolling, moving the wheel down causes the scroll bar +indicators to move down and the content to move up. In natural scrolling, +moving the wheel down causes the content to move down and the scroll bar +indicators to move up. This method of scrolling matches the interaction +with content on touch screens where a movement down also moves the content +down. + +libinput supports natural scrolling for all its scroll methods; it can +be enabled with the +**libinput_device_config_scroll_set_natural_scroll_enabled()** function. -- cgit v1.2.1