NAME¶
filterm - filter terminal input and/or output
SYNOPSIS¶
filterm INPUT OUTPUT [
COMMAND [
ARGS]]
DESCRIPTION¶
Execute the specified
COMMAND (default is the shell), filtering terminal
input and/or output.
It can help e.g. when our terminal is unable to display non-ASCII characters or
to enter them from the keyboard. It also makes writing various terminal
filters easier.
INPUT and
OUTPUT are names of konwert's filters - they are passed
as the first argument to the
konwert(1) program.
filterm -
OUTPUT filters only output, and
filterm INPUT -
only input.
The command
- executes the shell as a login shell.
It differs from
konwert INPUT | COMMAND |
konwert OUTPUT in that the command is executed on a
pseudo-terminal, so full-screen programs work correctly.
The filters have to output the characters as soon as they receive all necessary
input, without buffering.
trs(1) scripts are OK, but
sed(1) or
awk(1) or
tr(1) scripts are not. In C you may use
read(),
getchar(),
fread(), and
write(), but
putchar() and
fwrite() only together with
fflush(stdout). In C++:
cin.get(),
cout.put(), and
cout <<. In perl:
sysread,
getc,
read, and
syswrite, but
print only with
$| = 1.
The input filter will have set the environment variable
FILTERM=in, and
the output one -
FILTERM=out. This way some filters can slightly alter
their behaviour when working for filterm.
OPTIONS¶
- --help
- display help and exit
- --version
- output version information and exit
FILTERS FOR FILTERM¶
See
konwert(1). Additionally the following konwert's filters are designed
only for filterm:
- tyldy (input)
- Polish ~a~c~e~l~n~o~s~x~z
- lewyap (input)
- Polish `a`c`e`l`n`o`s`x`z
- boldpl (output)
- ASCII with Polish letters shown as bold.
- pinectrlchars (output)
- Replaces the characters 128..159 shown by the Pine
(or another program) as ^À..^ß back to the real
128..159.
- 512bold (output)
- Changes the mapping of colors in 512-character mode, which
restricts the number of colors to eight. The palette is dynamically
changed to contain the eight most recently used colors. When more colors
are used at once, some of them display incorrectly.
- 512bold1 (output)
- Changes the mapping of colors in 512-character mode.
Instead of ignoring the intensity, the following colors are available:
black, red, green, white, blue, light magenta, light cyan, light gray;
others are substitutied with approximations. This gives better effect,
allowing to show the intensity, with the side-effect of belying the hue of
some colors.
- kbdmacros (input)
- Keyboard macros. A sequence of keys can be recorded with
Esc Ctrl-A SEQUENCE Esc Ctrl-E SHORTCUT -
after which, if you press the SHORTCUT, the SEQUENCE will be
generated instead. Later such assignment can be deleted with Esc Ctrl-A
Esc Ctrl-E SHORTCUT Esc Ctrl-E. Instead of Esc
Ctrl- you often may press Ctrl-Alt-. The defined shortcuts,
together with the above redefinable key combinations used to define them,
are stored in the ~/.kbdmacros file. Note: when you redefine a
sequence, all its prefixes will not be passed through immediately, but
wait until it can be unambiguously told which sequence was actually input.
This includes escape sequences representing some extended keys.
SEE ALSO¶
konwert(1)
BUGS¶
512bold filter is not perfect. Some escape sequences may be emulated
incorrectly. Additionally, colors changed in multiple steps or not used
unnecessarily allocate some of the eight colors.
COPYRIGHT¶
filterm filters terminal input and/or output. It forms part of the konwert
package.
Copyright (c) 1998 Marcin 'Qrczak' Kowalczyk
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA
AUTHOR¶
__("< Marcin Kowalczyk * qrczak@knm.org.pl http://qrczak.home.ml.org/
\__/ GCS/M d- s+:-- a21 C+++>+++$ UL++>++++$ P+++ L++>++++$ E->++
^^ W++ N+++ o? K? w(---) O? M- V? PS-- PE++ Y? PGP->+ t
QRCZAK 5? X- R tv-- b+>++ DI D- G+ e>++++ h! r--%>++ y-