2005-02-21 09:30:12 +01:00
|
|
|
.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.
|
|
|
|
|
|
2022-11-17 17:48:23 +01:00
|
|
|
.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.
|
|
|
|
|
|
aseqdump: Add options to switch view mode
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>
2023-08-28 16:36:17 +02:00
|
|
|
.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.
|
|
|
|
|
|
2005-02-21 09:30:12 +01:00
|
|
|
.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>
|
