Added keyboard shortcuts.

This commit is contained in:
Marat Fayzullin 2024-08-19 20:27:24 -04:00
parent 331aecdcf3
commit 9464760b6c
7 changed files with 484 additions and 7 deletions

1
htdocs/css/keyboard.min.css vendored Normal file

File diff suppressed because one or more lines are too long

79
htdocs/css/shortcuts.css Normal file
View File

@ -0,0 +1,79 @@
/* import keyboard-css for keys in help */
@import url("keyboard.min.css");
#ks-overlay {
position: fixed;
top: 5vh;
left: calc((100vw - 800px) / 2);
max-height: 90vh;
width: 800px;
color: white;
background-color: #000;
opacity: 0.8;
z-index: 10000;
border: 3px solid white;
border-radius: 20px;
display: flex;
align-items: center;
flex-direction: column;
padding: 0.5rem;
}
.ks-title {
font-weight: bold;
font-size: 1.5rem;
margin-top: 1rem;
}
.ks-subtitle {
font-size: 0.8rem;
margin-top: 0.25rem;
}
.ks-separator {
border-top: 1px dotted white;
align-self: stretch;
margin: 1rem;
}
.ks-content {
padding: 0 0.75rem;
font-size: 1rem;
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: space-between;
align-items: center;
overflow-y: auto;
}
.ks-item {
width: 240px;
padding: 0.25rem;
border: 1px dashed #444;
margin-bottom: 0.25rem;
display: flex;
justify-content: space-between;
flex-wrap: nowrap;
align-items: center;
flex-direction: column;
/* flex-direction: row; */
}
.ks-item-txt {
color: silver;
}
.ks-item-kbd {
text-wrap: nowrap;
color: silver;
}
a.kbc-button-xs, button.kbc-button-xs {
padding: 0.02rem 0.25rem;
}
a.kbc-button-sm, button.kbc-button-sm {
padding: 0 0.5rem;
font-size: .85rem;
}

View File

@ -35,6 +35,7 @@
<script src="compiled/receiver.js"></script> <script src="compiled/receiver.js"></script>
<link rel="stylesheet" type="text/css" href="static/lib/nanoscroller.css" /> <link rel="stylesheet" type="text/css" href="static/lib/nanoscroller.css" />
<link rel="stylesheet" type="text/css" href="static/css/openwebrx.css" /> <link rel="stylesheet" type="text/css" href="static/css/openwebrx.css" />
<link rel="stylesheet" type="text/css" href="static/css/shortcuts.css" />
<link rel="stylesheet" type="text/css" href="static/css/themes.css" /> <link rel="stylesheet" type="text/css" href="static/css/themes.css" />
<meta charset="utf-8"> <meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9, minimum-scale=0.9, shrink-to-fit=no, user-scalable=no, interactive-widget=overlays-content" /> <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9, minimum-scale=0.9, shrink-to-fit=no, user-scalable=no, interactive-widget=overlays-content" />
@ -42,6 +43,7 @@
<script src="static/plugins.js"></script> <script src="static/plugins.js"></script>
</head> </head>
<body onload="openwebrx_init();"> <body onload="openwebrx_init();">
<div id="webrx-page-container"> <div id="webrx-page-container">
${header} ${header}
<div class="openwebrx-waterfall-container"> <div class="openwebrx-waterfall-container">

389
htdocs/lib/Shortcuts.js Normal file
View File

@ -0,0 +1,389 @@
//
// Handle keyboard shortcuts
//
function Shortcuts() {}
Shortcuts.init = function(target) {
var that = this;
target.addEventListener('keydown', function(e) { that.handleKey(e); });
this.overlay = jQuery('<div id="ks-overlay"></div>');
this.overlay.hide();
this.overlay.appendTo(target);
this.overlay.html(`
<div class="ks-title">Keyboard Shortcuts</div>
<div class="ks-subtitle">Hide this help with '?'.</div>
<div class="ks-separator"></div>
<div class="ks-content">
<div class="ks-item">
<div class="ks-item-txt">tune frequency</div>
<div class="ks-item-kbd">${this.keycap('ArrowLeft')}|${this.keycap('ArrowRight')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">zoom waterfall</div>
<div class="ks-item-kbd">${this.keycap('ArrowUp')}|${this.keycap('ArrowDown')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">select modulation</div>
<div class="ks-item-kbd">(${this.keycap('Control')}+)&nbsp;${this.keycap('0')}..${this.keycap('9')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">change tuning step</div>
<div class="ks-item-kbd">${this.keycap('[')}|${this.keycap(']')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">change volume</div>
<div class="ks-item-kbd">${this.keycap('Control')}+${this.keycap('ArrowUp')}|${this.keycap('ArrowDown')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">mute/unumte sound</div>
<div class="ks-item-kbd">${this.keycap('Space')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">auto-set squelch</div>
<div class="ks-item-kbd">${this.keycap('A')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">change squelch level</div>
<div class="ks-item-kbd">${this.keycap('Control')}+${this.keycap('ArrowLeft')}|${this.keycap('ArrowRight')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">disable squelch</div>
<div class="ks-item-kbd">${this.keycap('D')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">toggle noise reduction</div>
<div class="ks-item-kbd">${this.keycap('N')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">adjust bandpass offset</div>
<div class="ks-item-kbd">${this.keycap('Shift')}+${this.keycap('ArrowLeft')}|${this.keycap('ArrowRight')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">adjust bandpass width</div>
<div class="ks-item-kbd">${this.keycap('Shift')}+${this.keycap('ArrowUp')}|${this.keycap('ArrowDown')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">toggle scanner</div>
<div class="ks-item-kbd">${this.keycap('S')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">adjust waterfall min level</div>
<div class="ks-item-kbd">${this.keycap(',')}|${this.keycap('.')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">adjust waterfall max level</div>
<div class="ks-item-kbd">${this.keycap('<')}|${this.keycap('>')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">auto-set colors once</div>
<div class="ks-item-kbd">${this.keycap('Z')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">auto-set colors</div>
<div class="ks-item-kbd">${this.keycap('X')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">set default colors</div>
<div class="ks-item-kbd">${this.keycap('C')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">toggle recorder</div>
<div class="ks-item-kbd">${this.keycap('R')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">toggle spectrum</div>
<div class="ks-item-kbd">${this.keycap('V')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">toggle bandplan</div>
<div class="ks-item-kbd">${this.keycap('B')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">open map</div>
<div class="ks-item-kbd">${this.keycap('M')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">open files browser</div>
<div class="ks-item-kbd">${this.keycap('F')}</div>
</div>
<div class="ks-item">
<div class="ks-item-txt">open documentation</div>
<div class="ks-item-kbd">${this.keycap('H')}</div>
</div>
</div>
`);
};
Shortcuts.moveSlider = function(slider, delta) {
var $control = $(slider);
if (!$control.prop('disabled')) {
$control.val(parseInt($control.val()) + delta).change();
}
};
Shortcuts.moveSelector = function(selector, steps) {
var $control = $(selector);
if (!$control.prop('disabled')) {
var max = $(selector + ' option').length;
var n = $control.prop('selectedIndex') + steps;
n = n < 0? n + max : n >= max? n - max : n;
$control.prop('selectedIndex', n).change();
}
};
Shortcuts.handleKey = function(event) {
// Do not handle shortcuts when focused on a text or numeric input
var on_input = !!($('input:focus').length && ($('input:focus')[0].type === 'text' || $('input:focus')[0].type === 'number'));
if (on_input) return;
// Leave CTRL+<LETTER> combinations to the browser
if (event.ctrlKey && event.key.match(/^[a-z]$/i)) return;
switch (event.key) {
case 'ArrowLeft':
if (event.ctrlKey) {
// CTRL+LEFT: Decrease squelch
this.moveSlider('#openwebrx-panel-receiver .openwebrx-squelch-slider', -1);
} else if (event.shiftKey) {
// SHIFT+LEFT: Shift bandpass left
var demodulators = getDemodulators();
for (var i = 0; i < demodulators.length; i++) {
demodulators[i].moveBandpass(
demodulators[i].low_cut - 50,
demodulators[i].high_cut - 50
);
}
} else {
// LEFT: Tune down
tuneBySteps(-1);
}
break;
case 'ArrowRight':
if (event.ctrlKey) {
// CTRL+RIGHT: Increase squelch
this.moveSlider('#openwebrx-panel-receiver .openwebrx-squelch-slider', 1);
} else if (event.shiftKey) {
// SHIFT+RIGHT: Shift bandpass right
var demodulators = getDemodulators();
for (var i = 0; i < demodulators.length; i++) {
demodulators[i].moveBandpass(
demodulators[i].low_cut + 50,
demodulators[i].high_cut + 50
);
}
} else {
// RIGHT: Tune up
tuneBySteps(1);
}
break;
case 'ArrowUp':
if (event.ctrlKey) {
// CTRL+UP: Increase volume
this.moveSlider('#openwebrx-panel-volume', 1);
} else if (event.shiftKey) {
// SHIFT+UP: Make bandpass wider
var demodulators = getDemodulators();
for (var i = 0; i < demodulators.length; i++) {
demodulators[i].moveBandpass(
demodulators[i].low_cut - 50,
demodulators[i].high_cut + 50
);
}
} else {
// UP: Zoom in
zoomInOneStep();
}
break;
case 'ArrowDown':
if (event.ctrlKey) {
// CTRL+DOWN: Decrease volume
this.moveSlider('#openwebrx-panel-volume', -1);
} else if (event.shiftKey) {
// SHIFT+DOWN: Make bandpass narrower
var demodulators = getDemodulators();
for (var i = 0; i < demodulators.length; i++) {
demodulators[i].moveBandpass(
demodulators[i].low_cut + 50,
demodulators[i].high_cut - 50
);
}
} else {
// DOWN: Zoom out
zoomOutOneStep();
}
break;
case '1': case '2': case '3': case '4': case '5':
case '6': case '7': case '8': case '9': case '0':
// [CTRL+]0-9: Select modulation
var $modes = $('.openwebrx-demodulator-button');
var n = parseInt(event.key);
n = n > 0? n - 1 : 9;
if (event.ctrlKey) n += 10;
if (n < $modes.length) $modes[n].click();
break;
case '[': case '{':
// [: Decrease tuning step
this.moveSelector('#openwebrx-tuning-step-listbox', -1);
break;
case ']': case '}':
// ]: Increase tuning step
this.moveSelector('#openwebrx-tuning-step-listbox', 1);
break;
case 'a':
// A: Set squelch automatically
$('.openwebrx-squelch-auto').click();
break;
case 's':
// S: Toggle scanner
toggleScanner();
break;
case 'd':
// D: Turn off squelch
var $squelchControl = $('#openwebrx-panel-receiver .openwebrx-squelch-slider');
if (!$squelchControl.prop('disabled')) {
$squelchControl.val($squelchControl.attr('min')).change();
}
break;
case 'z':
// Z: Set waterfall colors automatically
$('#openwebrx-waterfall-colors-auto').click();
break;
case 'x':
// X: Continuously auto-set waterfall colors
$('#openwebrx-waterfall-colors-auto').triggerHandler('contextmenu');
break;
case 'c':
// C: Set default waterfall colors
$('#openwebrx-waterfall-colors-default').click();
break;
case 'v':
// V: Toggle spectrum display
UI.toggleSpectrum();
break;
case 'b':
// B: Toggle bandplan display
UI.toggleBandplan();
break;
case ' ':
// SPACE: Mute/unmute sound
UI.toggleMute();
break;
case 'n':
// N: Toggle noise reduction
UI.toggleNR();
break;
case 'r':
// R: Toggle recorder
UI.toggleRecording();
break;
case '<':
// SHIFT+<: Decrease waterfall max level
this.moveSlider('#openwebrx-waterfall-color-max', -1);
break;
case ',':
// <: Decrease waterfall min level
this.moveSlider('#openwebrx-waterfall-color-min', -1);
break;
case '>':
// SHIFT+>: Increase waterfall max level
this.moveSlider('#openwebrx-waterfall-color-max', 1);
break;
case '.':
// >: Increase waterfall min level
this.moveSlider('#openwebrx-waterfall-color-min', 1);
break;
case 'f':
// F: Open file browser
$('a.button[target="openwebrx-files"]')[0].click();
break;
case 'h':
// H: Open documentation
$('a.button[target="openwebrx-help"]')[0].click();
break;
case 'm':
// M: Open map
$('a.button[target="openwebrx-map"]')[0].click();
break;
case '/': case '?':
Shortcuts.overlay.slideToggle(100);
break;
default:
// Key not handled, pass it on
return;
}
// Key handled, prevent default operation
event.preventDefault();
};
Shortcuts.keycap = function(key) {
var keymap = {
',': ', <b style="font-size: 0.7rem">comma</b>',
'.': '. <b style="font-size: 0.7rem">dot</b>',
';': '; <b style="font-size: 0.7rem">semicolon</b>',
'\'': '\' <b style="font-size: 0.7rem">apostrophe</b>',
'SHIFT': '&#8679; Shift',
'CONTROL': '&#8963; Ctrl',
'COMMAND': '&#8984; Cmd',
'META': '&#8984; Meta',
'ALT': '&#8997; Alt',
'OPTION': '&#8997; Opt',
'ENTER': '&crarr; Enter',
'RETURN': '&crarr; Enter',
'DELETE': '&#8998; Del',
'BACKSPACE': '&#9003; BS',
'ESCAPE': '&#9099; ESC',
'ARROWRIGHT': '&rarr;',
'ARROWLEFT': '&larr;',
'ARROWUP': '&uarr;',
'ARROWDOWN': '&darr;',
'PAGEUP': '&#8670; PgUp',
'PAGEDOWN': '&#8671; PgDn',
'HOME': '&#8598; Home',
'END': '&#8600; End',
'TAB': '&#8677; Tab',
'SPACE': '&#9251; Space',
'INTERVAL': '&#9251; Space',
};
var k = keymap[key.toUpperCase()] || key.toUpperCase();
return `<button class="kbc-button kbc-button-sm" title="${key}"><b>${k}</b></button>`;
};

View File

@ -72,7 +72,7 @@ UI.loadSettings = function() {
// Set audio volume in 0..150 range. // Set audio volume in 0..150 range.
UI.setVolume = function(x) { UI.setVolume = function(x) {
x = Math.round(parseFloat(x)); x = Math.min(150, Math.max(0, Math.round(parseFloat(x))));
if (this.volume != x) { if (this.volume != x) {
this.volume = x; this.volume = x;
LS.save('volume', x); LS.save('volume', x);
@ -155,6 +155,7 @@ UI.toggleRecording = function(on) {
var $recButton = $('.openwebrx-record-button'); var $recButton = $('.openwebrx-record-button');
if ($recButton.is(':visible')) {
if (audioEngine.recording && (toggle || !on)) { if (audioEngine.recording && (toggle || !on)) {
audioEngine.stopRecording(); audioEngine.stopRecording();
$recButton.css('animation-name', ''); $recButton.css('animation-name', '');
@ -162,6 +163,7 @@ UI.toggleRecording = function(on) {
audioEngine.startRecording(); audioEngine.startRecording();
$recButton.css('animation-name', 'openwebrx-record-animation'); $recButton.css('animation-name', 'openwebrx-record-animation');
} }
}
}; };
// //

View File

@ -1403,6 +1403,9 @@ function openwebrx_init() {
// Create and run clock // Create and run clock
clock = new Clock($('#openwebrx-clock-utc')); clock = new Clock($('#openwebrx-clock-utc'));
// Initialize keyboard shortcuts
Shortcuts.init(document.body);
} }
function initSliders() { function initSliders() {

View File

@ -138,6 +138,7 @@ class CompiledAssetsController(GzipMixin, ModificationAwareController):
"lib/Modes.js", "lib/Modes.js",
"lib/MetaPanel.js", "lib/MetaPanel.js",
"lib/Waterfall.js", "lib/Waterfall.js",
"lib/Shortcuts.js",
"lib/Bandplan.js", "lib/Bandplan.js",
"lib/Spectrum.js", "lib/Spectrum.js",
"lib/Scanner.js", "lib/Scanner.js",