DragonFly On-Line Manual Pages
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
delimited 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
ghostscript 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
somefile.txt
RETURN VALUES
a2png returns 0 for success and 1 for errors.
BUGS
Carriage returns do not work correctly; they do not replace the
characters 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)