fascinus/lib/banter/banter.1

80 lines
1.6 KiB
Groff

.Dd January 14, 2021
.Dt banter 1
.Os
.
.Sh NAME
.Nm banter
.Nd little script to make irc color art that will probably get you banned
.
.Sh SYNOPSIS
.Nm
.Op Fl d Ar delay
.Op Fl w Ar width
.Op Fl s Ar sharpness
.Op Fl Fl colorfmt Ar format
.Op Fl Fl filler Ar filler
.Pa file
.
.Sh DESCRIPTION
.Nm
is a image to irc color codes converter.
.
.Pp
note that
.Nm
does not check if the line is too long for irc, additional
filtering may be needed if you do not want
accidental wrapping.
.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d Ar delay
set the
.Ar delay
in seconds between output lines. this does
not factor in computation time.
.
.It Fl w Ar width
the
.Ar width
of filler characters. the actual line will almost certainly
be longer because of color codes.
.
.It Fl s Ar sharpness
doubles the pixels to make edges sharper, however uses
exponentially more ram.
.Ar sharpness
is
.Cm 4
by default and can be lowered to reduce ram usage.
.
.It Fl Fl colorfmt Ar format
the unicode-escaped format of the colorcodes. you probably
do not want to change it, the default of
.Cm '\ex03{},{}'
is usually fine for all irc-related use.
.
.It Fl Fl filler Ar filler
what to fill the actual contents of the text with.
you could use it to hide messages if you want.
the default value is
.Cm '.' .
.
.It Pa file
the path to the image to convert
.El
.
.Sh BUGS
please report any bugs found to
.Lk https://github.com/xfnw/banter/issues .
.
.Pp
note that
.Nm
does not support non-rgb[a] color palettes, and an
exception on other palettes like grayscale
is to be expected and not a bug.
.
.Sh AUTHORS
.An xfnw Aq Mt xfnw@riseup.net