mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-11-10 00:25:43 +01:00
7e9bebad0b
This patch adds to switch the operation mode of aseqdump to specify how the values are shown. Namely, it allows to show the MIDI 2.0 values in two more different ways: compatible "normalized" view and percentage view, in addition to the default "raw" view. The "raw" view mode just shows the value found in the event almost as is. The MIDI 2.0 values are shown in 16 or 32bit hex numbers. The channel and UMP group numbers are 0-based, taking from 0 to 15. OTOH, in the normalized view, the 16bit or 32bit velocity and data values of MIDI 2.0 are normalized to the value fit in MIDI 1.0, i.e. from 0 to 127, but with decimal points. Similarly, the pitch wheel values are normalized between -8192 to 8191. Also, the channel numbers and UMP group numbers are 1-based, taking from 1 to 16. In the percentage view, the velocity and data values are normalized and shown in percentage, from 0% to 100%. The pitch wheel is normalized from -100% to 100%. The channel and UMP groups are 1-based as well as in normalized view mode. Signed-off-by: Takashi Iwai <tiwai@suse.de>
73 lines
1.8 KiB
Groff
73 lines
1.8 KiB
Groff
.TH ASEQDUMP 1 "19 Feb 2005"
|
|
|
|
.SH NAME
|
|
aseqdump \- show the events received at an ALSA sequencer port
|
|
|
|
.SH SYNOPSIS
|
|
.B aseqdump
|
|
[\fI\-p client:port,...\fP]
|
|
|
|
.SH DESCRIPTION
|
|
.B aseqdump
|
|
is a command-line utility that prints the sequencer events it receives as text.
|
|
|
|
To stop receiving, press Ctrl+C.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
.I \-h,\-\-help
|
|
Prints a list of options.
|
|
|
|
.TP
|
|
.I \-V,\-\-version
|
|
Prints the current version.
|
|
|
|
.TP
|
|
.I \-l,\-\-list
|
|
Prints a list of possible input ports.
|
|
|
|
.TP
|
|
.I \-u,\-\-ump=version
|
|
Sets the client MIDI version.
|
|
0 is for legacy mode, 1 is UMP MIDI 1.0 mode, and 2 is UMP MIDI 2.0 mode.
|
|
|
|
.TP
|
|
.I \-r,\-\-raw
|
|
Suppress the automatic conversion of events among UMP and legacy clients.
|
|
|
|
.TP
|
|
.I \-R,\-\-raw-view
|
|
Shows the raw values as is.
|
|
The channel numbers and UMP group numbers are 0-based in this mode.
|
|
This is the default behavior.
|
|
|
|
.TP
|
|
.I \-N,\-\-normalized-view
|
|
Shows the normalized values to be aligned with MIDI 1.0.
|
|
The channel numbers and UMP group numbers are shown as 1-based values,
|
|
i.e. 1 is the lowest number.
|
|
The velocity and data values are normalized between 0 and 127.
|
|
The values for MIDI 2.0 are shown with two digits decimal points (from
|
|
0.00 to 127.00).
|
|
The pitch wheel is normalized between -8192 to 8192, too.
|
|
|
|
.TP
|
|
.I \-P,\-\-percent-view
|
|
Shows the values in percentage.
|
|
The channel numbers and UMP group numbers are shown as 1-based values
|
|
in this mode, too.
|
|
The velocity and data values are normalized between 0 and 100%, shown
|
|
with two digits decimal points.
|
|
The pitch wheel is normalized between -100% to 100%, too.
|
|
|
|
.TP
|
|
.I \-p,\-\-port=client:port,...
|
|
Sets the sequencer port(s) from which events are received.
|
|
|
|
A client can be specified by its number, its name, or a prefix of its
|
|
name. A port is specified by its number; for port 0 of a client, the
|
|
":0" part of the port specification can be omitted.
|
|
|
|
.SH AUTHOR
|
|
Clemens Ladisch <clemens@ladisch.de>
|