.\"
.\" Copyright (c) 2011-2020, Stefan Vogt, Brian Cassidy, and Frederic Cambus
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions are met:
.\"
.\"   * Redistributions of source code must retain the above copyright
.\"     notice, this list of conditions and the following disclaimer.
.\"
.\"   * Redistributions in binary form must reproduce the above copyright
.\"     notice, this list of conditions and the following disclaimer in the
.\"     documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd $Mdocdate: August 28 2020 $
.Dt ANSILOVE 1
.Os
.Sh NAME
.Nm ansilove
.Nd ANSI / ASCII art to PNG converter
.Sh SYNOPSIS
.Nm
.Op Fl dhiqrsSv
.Op Fl b Ar bits
.Op Fl c Ar columns
.Op Fl f Ar font
.Op Fl m Ar mode
.Op Fl o Ar file
.Op Fl R Ar factor
.Op Fl t Ar type
.Ar file
.Sh DESCRIPTION
.Nm
is an ANSI / ASCII art to PNG converter, allowing to convert ANSI and
artscene-related file formats into PNG images, supporting ANSI (.ANS),
PCBoard (.PCB), Binary (.BIN), Artworx (.ADF), iCE Draw (.IDF),
Tundra (.TND) and XBin (.XB) formats.
.Pp
It creates size optimized 4-bit PNG files and supports SAUCE (Standard
Architecture for Universal Comment Extensions), 80x25 and 80x50 PC fonts
(including all the 14 MS-DOS charsets), Amiga fonts, and iCE colors.
.Pp
The options are as follows:
.Bl -tag -width 10n
.It Fl b Ar bits
Set to 9 to render 9th column of block characters (default: 8).
.It Fl c Ar columns
Adjust number of columns for ANSI, BIN, and TND files.
.It Fl d
Enable DOS aspect ratio.
.It Fl f Ar font
Select font for supported formats.
.Pp
Valid options for PC fonts are:
.Bl -tag -width Er
.It Ic 80x25
Default (Code page 437)
.It Ic 80x50
80x50 mode (Code page 437)
.It Ic cp737
Greek (Code page 737)
.It Ic cp775
Baltic (Code page 775)
.It Ic cp850
Latin1 (Code page 850)
.It Ic cp852
Latin2 (Code page 852)
.It Ic cp855
Cyrillic (Code page 855)
.It Ic cp857
Turkish (Code page 857)
.It Ic cp860
Portuguese (Code page 860)
.It Ic cp861
Icelandic (Code page 861)
.It Ic cp862
Hebrew (Code page 862)
.It Ic cp863
French Canadian (Code page 863)
.It Ic cp865
Nordic (Code page 865)
.It Ic cp866
Russian (Code page 866)
.It Ic cp869
Greek (Code page 869)
.It Ic terminus
Terminus (Modern font, code page 437)
.El
.Pp
Valid options for Amiga fonts are:
.Bl -tag -width Er
.It Ic amiga
Alias to Topaz, see below
.It Ic microknight
Original MicroKnight version
.It Ic microknight+
Modified MicroKnight version
.It Ic mosoul
Original mO'sOul font
.It Ic pot-noodle
Original P0T-NOoDLE font
.It Ic topaz
Original Topaz Kickstart 2.x version
.It Ic topaz+
Modified Topaz Kickstart 2.x+ version
.It Ic topaz500
Original Topaz Kickstart 1.x version
.It Ic topaz500+
Modified Topaz Kickstart 1.x version
.El
.It Fl h
Show help.
.It Fl i
Enable iCE colors.
.It Fl m Ar mode
Set rendering mode for ANS files.
.Pp
Valid options are:
.Bl -tag -width Ds
.It Ic ced
Black on gray, with 78 columns.
.It Ic transparent
Render with transparent background.
.It Ic workbench
Use Amiga Workbench palette.
.El
.It Fl o Ar file
Specify output filename/path.
.It Fl q
Suppress output messages (quiet).
.It Fl r
Create Retina @2x output file.
.It Fl R Ar factor
Create Retina output file with custom scale factor.
.It Fl t Ar type
Specify input file type.
.Pp
Valid types are:
.Bl -tag -width Ds
.It Ic ans
ANSi (ANSI escape sequences: ANSI X3.64 standard)
.It Ic adf
Artworx format, supporting custom character sets and palettes
.It Ic bin
Binary format (raw memory copy of text mode video memory)
.It Ic idf
iCE Draw format, supporting custom character sets and palettes
.It Ic pcb
PCBoard Bulletin Board System (BBS) own file format
.It Ic tnd
TundraDraw format, supporting 24-bit color mode
.It Ic xb
XBin format, supporting custom character sets and palettes
.El
.It Fl s
Show SAUCE record without generating output.
.It Fl S
If available, use SAUCE info for render options (ex: width).
.It Fl v
Show version information.
.El
.Sh EXAMPLES
To render a file with iCE colors enabled:
.Pp
.Dl $ ansilove -i file.ans
.Pp
To create a Retina @2x output file:
.Pp
.Dl $ ansilove -r file.ans
.Pp
To creates a Retina output file with a custom scale factor:
.Pp
.Dl $ ansilove -R 3 file.ans
.Pp
To only display SAUCE record without generating output:
.Pp
.Dl $ ansilove -s file.ans
To render a file with transparent background:
.Pp
.Dl $ ansilove -m transparent file.ans
.Pp
To render a file using a custom font:
.Pp
.Dl $ ansilove -f amiga file.txt
.Pp
To render a file using a custom font, rendering the 9th column, enabling
iCE colors, and using DOS aspect ratio:
.Pp
.Dl $ ansilove -f 80x50 -b 9 -d -i file.ans
.Sh AUTHORS
.An -nosplit
.Nm
was written by
.An Stefan Vogt ,
.An Brian Cassidy ,
and
.An Frederic Cambus .