Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ANSILOVE(1)		    General Commands Manual		   ANSILOVE(1)

NAME
       ansilove	-- ANSI	/ ASCII	art to PNG converter

SYNOPSIS
       ansilove	 [-dhiqrsSv]  [-b  bits]  [-c  columns]	 [-f  font]  [-m mode]
		[-o file] [-R factor] [-t type]	file

DESCRIPTION
       ansilove	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.

       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 col-
       ors.

       The options are as follows:

       -b bits	   Set to 9 to render 9th column of block characters (default:
		   8).

       -c columns  Adjust number of columns for	ANSI, BIN, and TND files.

       -d	   Enable DOS aspect ratio.

       -f font	   Select font for supported formats.

		   Valid options for PC	fonts are:

		   80x25	      Default (Code page 437)

		   80x50	      80x50 mode (Code page 437)

		   cp737	      Greek (Code page 737)

		   cp775	      Baltic (Code page	775)

		   cp850	      Latin1 (Code page	850)

		   cp852	      Latin2 (Code page	852)

		   cp855	      Cyrillic (Code page 855)

		   cp857	      Turkish (Code page 857)

		   cp860	      Portuguese (Code page 860)

		   cp861	      Icelandic	(Code page 861)

		   cp862	      Hebrew (Code page	862)

		   cp863	      French Canadian (Code page 863)

		   cp865	      Nordic (Code page	865)

		   cp866	      Russian (Code page 866)

		   cp869	      Greek (Code page 869)

		   spleen	      Spleen (Modern font, code	page 437)

		   terminus	      Terminus (Modern font, code page 437)

		   Valid options for Amiga fonts are:

		   amiga	      Alias to Topaz, see below

		   microknight	      Original MicroKnight version

		   microknight+	      Modified MicroKnight version

		   mosoul	      Original mO'sOul font

		   pot-noodle	      Original P0T-NOoDLE font

		   topaz	      Original Topaz Kickstart 2.x version

		   topaz+	      Modified Topaz Kickstart 2.x+ version

		   topaz500	      Original Topaz Kickstart 1.x version

		   topaz500+	      Modified Topaz Kickstart 1.x version

       -h	   Show	help.

       -i	   Enable iCE colors.

       -m mode	   Set rendering mode for ANS files.

		   Valid options are:

		   ced	   Black on gray, with 78 columns.

		   transparent
			   Render with transparent background.

		   workbench
			   Use Amiga Workbench palette.

       -o file	   Specify output filename/path.

       -q	   Suppress output messages (quiet).

       -r	   Create Retina @2x output file.

       -R factor   Create Retina output	file with custom scale factor.

       -t type	   Specify input file type.

		   Valid types are:

		   ans	   ANSi	(ANSI escape sequences:	ANSI X3.64 standard)

		   adf	   Artworx  format,  supporting	 custom	character sets
			   and palettes

		   bin	   Binary format (raw memory copy of text  mode	 video
			   memory)

		   idf	   iCE	Draw  format, supporting custom	character sets
			   and palettes

		   pcb	   PCBoard Bulletin Board System (BBS) own file	format

		   tnd	   TundraDraw format, supporting 24-bit	color mode

		   xb	   XBin	format,	supporting custom character  sets  and
			   palettes

       -s	   Show	SAUCE record without generating	output.

       -S	   If  available,  use	SAUCE  info  for  render  options (ex:
		   width).

       -v	   Show	version	information.

EXAMPLES
       To render a file	with iCE colors	enabled:

	     $ ansilove	-i file.ans

       To create a Retina @2x output file:

	     $ ansilove	-r file.ans

       To creates a Retina output file with a custom scale factor:

	     $ ansilove	-R 3 file.ans

       To only display SAUCE record without generating output:

	     $ ansilove	-s file.ans
       To render a file	with transparent background:

	     $ ansilove	-m transparent file.ans

       To render a file	using a	custom font:

	     $ ansilove	-f amiga file.txt

       To render a file	using a	custom font, rendering	the  9th  column,  en-
       abling iCE colors, and using DOS	aspect ratio:

	     $ ansilove	-f 80x50 -b 9 -d -i file.ans

AUTHORS
       ansilove	 was  written  by  Stefan  Vogt,  Brian	 Cassidy, and Frederic
       Cambus.

FreeBSD	ports 15.0		March 18, 2025			   ANSILOVE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ansilove&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help