NAME

SYNOPSIS

DESCRIPTION

OPTIONS

-font filename

Specifies a BDF font file to load. If a default font was built in to the program at compile-time, the default is to use that. Otherwise this must be the name of a file in Adobe Binary Distribution Format that specifies a bitmap font, and it must be specified before the first -text argument.

If there is a builtin font, you can reload it with -font builtin.

-scale float

Scale the currently-selected font up or down by the given ratio, e.g., 0.5 divides the font size in half. When scaling down, the font will be nicely anti-aliased onto the background image. However, when scaling up (> 1.0), the font will get pixellated.

Note that -scale operations are cumulative: for cleanest results, it's best to reload the font (with -font) before re-scaling.

-blur integer

Add an N pixel halo around the currently selected font, so that it is visible on both light and dark backgrounds. The font will be in the current foreground color, and the halo in the background color.

It tends to look better to scale then blur, rather than the other way around.

Like -scale, -blur operations are cumulative.

Note that large blur values are pretty slow.

-opacity float

How transparent to draw the next block of text. 0.0 means invisible, 1.0 means solid.

-fg color

Foreground color of next block of text. Default is black.

-bg color

Background color (color of blur halo). Default is white.

A small number of color names are supported ("black", "white", etc.) or hexadecimal triplets of the form "#RRGGBB" may be used.

-pos X Y

Where to position the next block of text. Positive numbers are measured from the upper left of the image; Negative numbers are measured from the bottom right of the image. So "-10" means near the right (or bottom) edge, regardless of the image size.

-left

The next block of text will be flush-left, that is, have its left edge at the current position (this is the default.)

-right

The next block of text will be flush-right, that is, have its right edge at the current position.

-center

The next block of text will be centered on top of the current position. Note that this only applies to the X position, not Y: multi-line text is also centered on X, but grows down.

-text string

Place the given text in the image at the current position and in the current font. Newlines are allowed; tabs are not handled.

If the text contains percent (%) characters, they are interpreted as for strftime(3), so you can easily put timestamps into images.

-time time_t

This sets the time which will be formatted by percent directives in the -text arguments. It defaults to the current time, but you can make it be the write-date of the input file by saying -time file, or can set it to a specific time by specifying a number of seconds after the Epoch (Jan 1, 1970.)

SEE ALSO

UPDATES

You can find some common fonts in BDF form here: http://ftp.x.org/pub/R6.4/xc/fonts/bdf/100dpi/

COPYRIGHT

AUTHOR