File: aseqjoy.1.in

package info (click to toggle)
aseqjoy 0.0.2-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 440 kB
  • sloc: sh: 1,232; ansic: 183; makefile: 9
file content (64 lines) | stat: -rw-r--r-- 2,612 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
.TH aseqjoy "1" "May 2016" "aseqjoy @VERSION@" "User Commands"
.SH NAME
aseqjoy \- Joystick to ALSA MIDI Sequencer Converter
.SH SYNOPSIS
.B aseqjoy
[\fIoptions\fR]
.SH DESCRIPTION
Aseqjoy maps each axis of a joystick device to a specific MIDI 
controller. Moving the joystick along an axis will cause aseqjoy to emit
MIDI controller messages via ALSA's sequencer API. The value of the controller
message represents the joystick's position along the axis (eg \'left\' \-> 0, 
\'middle\' \-> 63, \'right\' \-> 127). Note that you can run aseqjoy with the 
\fB\'-r\'\fR commandline switch to use fine MIDI control change messages instead 
(with 14 bit resolution).


Aseqjoy uses the ALSA sequencer API to emit the MIDI events. Therefor it
creates and output port named after joystick used. You can then use for example
\fBaconnect\fR, \fBQjackCtrl\fR or the \fBalsa-patch-bay\fR to connect an aseqjoy 
instance to an input port of your choice.

\fBNote:\fR Some joysticks may have to be calibrated (with \fBjscal\fR) before 
they can be used efficiently. 
.SH OPTIONS
.TP
\fB\-h\fR
Display help info
.TP
\fB\-d [joystick]\fR
Select the joystick to use for aseqjoy, where \fB[joystick]\fR is an integer value
from from 0 to 3 effectivley selecting devices js0 to js3.
.TP
\fB\-v\fR
Verbose mode - aseqjoy will output information about the MIDI events
sent.
.TP
\fB\-0 [controller]\fR
Select the MIDI controller ID for axis 0. As a default value aseqjoy will use
10 + the axis ID, so for axis 0 that would be 10 + 0 = 10.
.TP
\fB\-1 [controller]\fR, \fB\-2 [controller]\fR, \fB\-3 [controller]\fR,
Just like \fB\-0\fR this will set the controller IDs for axes 1, 2, 3.
.TP
\fB\-r\fR
Use fine MIDI control change messages instead (14 bit insstead of 7 bit 
resolution).
.SH OPERATION
After aseqjoy has started successfully all motion detected by the selected 
joystick device will cause MIDI controller messages to be emitted via the 
corresponding ALSA sequencer output port. The controller IDs are either the
default values (10, 11, 12 ...) or the ones given as commandline options.

Pressing a joystick button will cause aseqjoy to switch the MIDI channel. On
startup channel '1' is selected. Pressing joystick button 2 will cause channel
2 to be selected. Other buttons work accordingly.
.SH LICENSE
aseqjoy comes under the terms of the GNU General Public License Version 2 or 
(at your option) any later version - for details please refer to the file 
COPYING included with the aseqjoy source code.
.SH AUTHOR
Man page and software by Alexander Koenig <alex@lisas.de>.
.SH "SEE ALSO"
.LP 
jscal(1), aconnect(1)