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

FreeBSD Manual Pages


home | help
a2png(1)			 USER COMMANDS			      a2png(1)

       a2png - convert ASCII text to PNG bitmap	image

       a2png [ options ] [ file(s) ]

       a2png reads text	from files or standard input and renders them to a PNG
       bitmap image.  The first	version	is pretty simple, and will only	handle
       newlines, carriage returns and tabs -- ANSI schemes is not supported.

       The Cairo graphics library is used for rendering	the file in memory.

       -      Read text	from standard input

	      Set  background  color.  The format is the same as for HTML/CSS,
	      i.e. aabbcc, in RGB values.  Default is black (000000).

       --bold Use bold font.

	      Set horizontal spacing between characters	in pixels.  Default is
	      0.  You can also use negative.

	      Make any font fixed-width	by using the horizontal	spacing	of the
	      widest character in the Latin1 character set.

	      Set font family to use.  You can either point directly to	a font
	      file,  as	 in  --font=myfont.ttf,	or simply the name "myfont" if
	      that font	exists as myfont.ttf or	myfont.ttc in the default font
	      search path.

	      If  you  want  to	use a font in your current directory, you must
	      specify it like this: --font=./fontname.ttf

	      You can also set your own	font search path with a	 comma	delim-
	      ited list	in the environment variable GDFONTPATH,	if you are us-
	      ing gdlib	for rendering.

	      If you have ghostscript installed, you can do a `which  gs'  and
	      investigate  that	path's share/ghostscript/fonts/, e.g. /usr/lo-
	      cal/share/ghostscript/fonts/.   If  you  find  any   ghostscript
	      fonts,  you  can	try  using  one	 of  them.  Check out the file
	      `Fontmap'	in that	directory  for	descriptive  names  for	 those

	      Both  Cairo  and GD use Freetype as a font subsystem, so you can
	      try some fonts with that distribution.  The --font parameter can
	      hence  read  any	fonts that Freetype can	handle,	so you can try
	      with almost any font formats (including truetype fonts).

	      If you are using Cairo, then a lot of  fonts  like  "Fixed"  are
	      shipped with the installation.  In that case, you	cannot use GD-

	      In most cases you	will want to use a monospaced  font,  such  as
	      `Courier'	 or  `Courier  New'.  If you don't have	any monospaced
	      font, you	can emulate the	behaviour by using the option --fixed.

	      Set font size.  Note that	you cannot use pixels or pt here.  The
	      size is a	floating point value, defaulting to 0.025.

	      Set  foreground  color.  The format is the same as for HTML/CSS,
	      i.e. aabbcc, in RGB values.  Default is white (ffffff).

	      Set PNG pixel format.  Available values  are  ARGB32  (default),
	      RGB24 and	A8 (alpha values, 8 bits per pixel).

	      Set output height	in pixels.  Default is 480.

	      Unfortunately  this  is  probably	 not what you are looking for.
	      This program will	*not* render HTML pages.   Instead,  it	 reads
	      the  exact format	that is	output from the	program	jp2a using the
	      options `--colors	--html-raw'  (see
	      for more information on jp2a).

	      This is used to color the	characters.  For reference, the	format
	      is this:

	      <span style='color:#rrggbb;'>A</span><br/>

	      The <br/>	is used	to break lines.	 No newlines are accepted, and
	      the  code	to parse this input is extremely bad, so you shouldn't
	      get your hopes up	for this one.

       --help -h
	      Print help.

	      Sets amount of extra pixels to add between each line.   The  de-
	      fault  is	 to  add  2 pixels.  You can set this to zero, or even
	      negative values.

	      Do not crop away the unused  image  areas	 after	rendering  the

	      Set output filename or a directory to write the files to.

	      Overwrite	 existing files.  The default is not to	overwrite, in-
	      stead adding a numbered suffix to	the filename.  That is,	if you
	      convert foo.txt you get foo.png the first	time you convert.  The
	      second time you'll get foo2.png and so on.

	      Print verbose output messages.  This is useful when you want  to
	      know the cropping	dimensions, and	when converting	multiple files
	      to see their output names.

	      Set output width in pixels.  Default is 640.

       --version -V
	      Print program version and	exit.

       --silent	-s
	      Silent mode; do not print	any messages to	the console.

	      Set output width and height in pixels.  Default is 640x480.

	      Set the number of	spaces that tab	 characters  will  expand  to.
	      Default is 8.

       Convert files to	800x600	pixels:	    a2png --size=800x600 file1 file2

       Convert text from standard input:    a2png --size=800x600 -

       Convert	file  with  yellow background: a2png --background=ffff00 some-

       a2png returns 0 for success and 1 for errors.

       Carriage	returns	do not work correctly; they do not replace the charac-
       ters they overwrite, so you get garbled output.

       The --transparent option	does not work with gdlib.

       The --bold option does not work with gdlib.

       Only Latin1 characters are accepted, although the subsystems do support

       Check the web at for new  versions,	 these
       issues might very well be fixed in future updates.

       Christian Stigen	Larsen <> --

       a2png is	distributed under the GNU General Public License v2.

version	0.1		      September	22, 2006		      a2png(1)


Want to link to this manual page? Use this URL:

home | help