aseqjoy

NAME

aseqjoy - Joystick to ALSA MIDI Sequencer Converter

SYNOPSIS

aseqjoy [options]

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).

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 aconnect or the alsa-patch-bay to connect an aseqjoy instance to an input port of your choice.

Note: Some joysticks may have to be calibrated (with jscal) before they can be used efficently.

OPTIONS

-h: Display help info
-d [joystick]: Select the joystick to use for aseqjoy, where [joystick] is an integer value from from 0 to 3 effectivley selecting devices js0 to js3.
-v: Verbose mode - aseqjoy will output information about the MIDI events sent.
-0 [controller]: 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.
-1 [controller], -2 [controller], -3 [controller],: Just like -0 this will set the controller IDs for axes 1, 2, 3.

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.

AUTHOR

Man page and software by Alexander König <alex@lisas.de>.

This document was created by man2html, using the manual pages.
Time: 18:19:17 GMT, April 18, 2003