a2png man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

a2png(1)			 USER COMMANDS			      a2png(1)

NAME
       a2png - convert ASCII text to PNG bitmap image

SYNOPSIS
       a2png [ options ] [ file(s) ]

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

OPTIONS
       -      Read text from standard input

       --background=...
	      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.

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

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

       --font=...
	      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
	      using 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/local/share/ghostscript/fonts/.  If	you  find  any	ghost‐
	      script fonts, you can try using one of them.  Check out the file
	      `Fontmap' in that directory  for	descriptive  names  for	 those
	      fonts.

	      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
	      GDFONTPATH.

	      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.

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

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

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

       --height=...
	      Set output height in pixels.  Default is 480.

       --html-input
	      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  http://jp2a.sourceforge.net
	      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.

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

       --no-crop
	      Do not crop away the unused  image  areas	 after	rendering  the
	      text.

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

       --overwrite
	      Overwrite	 existing  files.   The	 default  is not to overwrite,
	      instead 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.

       --verbose
	      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.

       --width=...
	      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.

       --size=WxH
	      Set output width and height in pixels.  Default is 640x480.

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

EXAMPLES
       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‐
       file.txt

RETURN VALUES
       a2png returns 0 for success and 1 for errors.

BUGS
       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
       UTF-8.

       Check the web at http://a2png.sourceforge.net for new  versions,	 these
       issues might very well be fixed in future updates.

AUTHOR
       Christian Stigen Larsen <csl@sublevel3.org> -- http://csl.sublevel3.org

LICENSE
       a2png is distributed under the GNU General Public License v2.

version 0.1		      September 22, 2006		      a2png(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net