diff options
author | William Wilgus <me.theuser@yahoo.com> | 2016-11-22 06:21:31 +0100 |
---|---|---|
committer | William Wilgus <me.theuser@yahoo.com> | 2017-01-17 23:06:17 +0100 |
commit | dc87e9e9f3c383b63c3cb3713886a6c93b6a79d1 (patch) | |
tree | 47a6c0d49e7741f91fa74d7230b1267f60617902 /manual/configure_rockbox/system_options.tex | |
parent | 16a9f84571276a13f4cfd5c66db8cd63ce4e2e7f (diff) | |
download | rockbox-dc87e9e9f3c383b63c3cb3713886a6c93b6a79d1.tar.gz rockbox-dc87e9e9f3c383b63c3cb3713886a6c93b6a79d1.zip |
Selective Backlight/Advanced Softlock - Selective actions based on context
Selective backlight allows the user to choose actions that will not
enable the backlight when pressed.
Advanced softlock allows user to choose actions that will not be
blocked by screenlock on devices without a hold button.
Both only occur in FM and WPS Contexts.
Update:
Back from the dead
-Cleaned up code, removed unnecessary calls, re-arranged last filter action
timeout conditional to work in case last_filtered_action_tick was never set
-Added entries to the manual
-Fixed back button on some menus not activating backlight
-Made menus more intuitive, no actions selected now changes menu item to off.
-Added talk fuctionality.
-Added option to disable selective backlight while on external power.
-Rewrote backlight and softlock handling code to fix issue with scrollwheels
-Menu changed to have toggle(yes/no) and settings
-Optimized selective actions lookup
-Added option to disable notification of 'buttons locked' while softlocked
-Removed uneeded code, consolidated action lookup to single function
-Fixed incorrect name on selective softlock menu
-Added option to disable touch on touchscreen devices
-Fixed backlight on original screenlock without selective screenlock active
-Added text selection in mask_select for when show_icons is off
-Fixed voice in mask_select to speak if voice is defined instead of spelling
-Added more lang defines (play skip seek)
-Added option to disable unknown keys turning on backlight
-Fixed Conditional argument In wrong place causing players without
backlight to fail to build
-Fixed Disable Unknown blocking detection of context change
-Fixed canceling menu didn't update new settings
-Added Autolock on backlight off
-Removed backlight_on_force from backlight.c, Now sets ignore next to false
and uses backlight_on
-Cleaned up autolock code added strings to lang file
-Fixed issue where rapid presses would bypass softlock
-Removed old softlock code, Cleaned selective actions code
-Changed menu to match existing RB menus
-Fixed Backlight_on_Hold blocked by backlight_ignore_next
-Fixed ignore_next for ipod
-Fixed bug allowing context with softlock to bypass selective backlight
-Changed mask_select to no longer prompt for changes to be saved
-Changed menu names
-Added ignore timeout to allow ipod scroll wheel to work properly and other
players to still work properly, removed some previous code including
ignore_event
-Increased ignore timeout to prevent sd card accesses from interrupting action
code and turning on backlight
-Changed Unknown action to unmapped action in menu, changed handling code
-Removed unneeded logic and variables for handling unfiltered actions
-Reverted unmapped action code to previous functionality
-Added manual entries (thanks JohnB)
-Removed elusive unhandled unicode character from manual, changed formatting slightly
Actions:
Volume,Play,Seek,Skip
Extras:
Disable unmapped actions
Disable selective backlight on external power
Disable touch during softlock on touchscreen devices
Disable softlock notifications (power button still notifies)
Autolock on backlight off
Method:
Adds a function to ignore backlight on next call
If selected action occurs backlight is forced on,
Filter_first_keypress stays intact.
Selective softlock allows selected actions through, bypasses the normal
softlock routine.
ToDo:
DONE
previous commit (#1) has attribution for folder_select.c which mask_select
is based from.
Change-Id: I08132ddcfd64c81751ef23b720f3ec6d68695fe4
Diffstat (limited to 'manual/configure_rockbox/system_options.tex')
-rwxr-xr-x[-rw-r--r--] | manual/configure_rockbox/system_options.tex | 71 |
1 files changed, 63 insertions, 8 deletions
diff --git a/manual/configure_rockbox/system_options.tex b/manual/configure_rockbox/system_options.tex index b505175a68..ff2967cec7 100644..100755 --- a/manual/configure_rockbox/system_options.tex +++ b/manual/configure_rockbox/system_options.tex | |||
@@ -167,11 +167,11 @@ this option \setting{On}. If it is not required, then turning this setting | |||
167 | 167 | ||
168 | \opt{lineout_poweroff}{ | 168 | \opt{lineout_poweroff}{ |
169 | \subsection{\label{ref:LineoutOnOff}Line Out} | 169 | \subsection{\label{ref:LineoutOnOff}Line Out} |
170 | This option turns the \dap{}'s line-out \setting{On} and \setting{Off}. On some | 170 | This option turns the \dap{}'s line-out \setting{On} and \setting{Off}. On some |
171 | devices an enabled line-out will consume some power even if not used. If it is | 171 | devices an enabled line-out will consume some power even if not used. If it is |
172 | not required, then turning this setting \setting{Off} will save battery and | 172 | not required, then turning this setting \setting{Off} will save battery and |
173 | therefore result in better runtime. | 173 | therefore result in better runtime. |
174 | } | 174 | } |
175 | 175 | ||
176 | \opt{HAVE_BUTTON_LIGHTS}{ | 176 | \opt{HAVE_BUTTON_LIGHTS}{ |
177 | \opt{e200,e200v2}{ | 177 | \opt{e200,e200v2}{ |
@@ -243,6 +243,61 @@ therefore result in better runtime. | |||
243 | 243 | ||
244 | 244 | ||
245 | 245 | ||
246 | |||
247 | \nopt{HAS_BUTTON_HOLD}{ | ||
248 | \subsection{Advanced Key Lock} | ||
249 | This option allows users to select actions that when within WPS or FMS will \emph{not} be | ||
250 | blocked by the key lock (software hold switch). | ||
251 | |||
252 | |||
253 | \begin{description} | ||
254 | \item[Enabled.] | ||
255 | Enables/disables the feature. | ||
256 | |||
257 | \item[Settings.] | ||
258 | Allows to select actions that will \emph{not} be blocked by the key lock. | ||
259 | \begin{itemize} | ||
260 | \item[Volume.] | ||
261 | Volume up/down. | ||
262 | \item[Play.] | ||
263 | Toggling Play/Pause. | ||
264 | \item[Seek.] | ||
265 | Seeking in a track. | ||
266 | \item[Skip.] | ||
267 | Skipping of a track. | ||
268 | \opt{HAVE_BACKLIGHT}{ | ||
269 | \item[Autolock On.] | ||
270 | When the backlight turns off, softlock will lock the screen, | ||
271 | activates when you press the lock key and if you manually lock | ||
272 | again, while active it then disables autolock. | ||
273 | \begin{itemize} | ||
274 | \item | ||
275 | (Lock Button Pressed \#1) >Auto Lock On | ||
276 | (device still unlocked till backlight timeout). | ||
277 | \item | ||
278 | (Lock Button Pressed \#2) >Auto Lock Off (device locked). | ||
279 | \item | ||
280 | (Lock Button Pressed \#3) >(device unlocked). | ||
281 | \end{itemize} | ||
282 | } %\opt{HAVE_BACKLIGHT} | ||
283 | \opt{touchpad}{ | ||
284 | \item[Disable Touch.] | ||
285 | Blocks touch screen buttons like the original. | ||
286 | } | ||
287 | \item[Disable Notify.] | ||
288 | Suppresses the notification 'Buttons Locked' | ||
289 | (still will if power button is pressed). | ||
290 | \note{This is a pre-requisite for \setting{selectivebacklight} | ||
291 | \reference{ref:selectivebacklight} to work also during key lock.} | ||
292 | |||
293 | \end{itemize} | ||
294 | Selected actions are indicated by a leading +. | ||
295 | Note: If all options get de-selected, the entire feature is disabled. | ||
296 | |||
297 | \end{description} | ||
298 | } %\nopt{HAS_BUTTON_HOLD} | ||
299 | |||
300 | |||
246 | \opt{usb_hid}{ | 301 | \opt{usb_hid}{ |
247 | \subsection{\label{ref:USB_HID}USB HID} | 302 | \subsection{\label{ref:USB_HID}USB HID} |
248 | This option turns the USB HID feature \setting{On} and \setting{Off}. | 303 | This option turns the USB HID feature \setting{On} and \setting{Off}. |
@@ -550,7 +605,7 @@ therefore result in better runtime. | |||
550 | \\ | 605 | \\ |
551 | \end{btnmap} | 606 | \end{btnmap} |
552 | 607 | ||
553 | \item [Browser.] This mode lets you control a web browser (e.g. | 608 | \item [Browser.] This mode lets you control a web browser (e.g. |
554 | Firefox). It uses the \dap{}'s keys to navigate through the web page | 609 | Firefox). It uses the \dap{}'s keys to navigate through the web page |
555 | and different tabs, navigate through history, and to control zoom. | 610 | and different tabs, navigate through history, and to control zoom. |
556 | 611 | ||
@@ -592,7 +647,7 @@ therefore result in better runtime. | |||
592 | \\ | 647 | \\ |
593 | } | 648 | } |
594 | 649 | ||
595 | % Zoom in / out | 650 | % Zoom in / out |
596 | \opt{SANSA_FUZEPLUS_PAD}{Long \ButtonBottomRight} | 651 | \opt{SANSA_FUZEPLUS_PAD}{Long \ButtonBottomRight} |
597 | \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD} | 652 | \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD} |
598 | {Long \ButtonUp / Long \ButtonDown} | 653 | {Long \ButtonUp / Long \ButtonDown} |
@@ -707,13 +762,13 @@ therefore result in better runtime. | |||
707 | ,SANSA_CLIP_PAD,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% | 762 | ,SANSA_CLIP_PAD,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% |
708 | ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD} | 763 | ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD} |
709 | {\ButtonUp / \ButtonDown / \ButtonLeft / \ButtonRight} | 764 | {\ButtonUp / \ButtonDown / \ButtonLeft / \ButtonRight} |
710 | \opt{IRIVER_H10_PAD}{\ButtonScrollUp / \ButtonScrollDown / | 765 | \opt{IRIVER_H10_PAD}{\ButtonScrollUp / \ButtonScrollDown / |
711 | \ButtonLeft / \ButtonRight} | 766 | \ButtonLeft / \ButtonRight} |
712 | \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD} | 767 | \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD} |
713 | {\ButtonMenu / \ButtonPlay / \ButtonLeft / \ButtonRight} | 768 | {\ButtonMenu / \ButtonPlay / \ButtonLeft / \ButtonRight} |
714 | & | 769 | & |
715 | \opt{HAVEREMOTEKEYMAP}{ | 770 | \opt{HAVEREMOTEKEYMAP}{ |
716 | \opt{MROBE100_RC_PAD}{\ButtonRCPlay / \ButtonRCDisplay / | 771 | \opt{MROBE100_RC_PAD}{\ButtonRCPlay / \ButtonRCDisplay / |
717 | \ButtonRCRew / \ButtonRCFF}% | 772 | \ButtonRCRew / \ButtonRCFF}% |
718 | &} | 773 | &} |
719 | Cursor move up / down / left / right, respectively | 774 | Cursor move up / down / left / right, respectively |