Scroll to navigation

SHANTY(1) Shanty SHANTY(1)

NAME

Shanty - Makes a PostScript file from an image and some text.

SYNOPSIS

shanty -i image_file [-t text_file] [-o output_file] [-s paper_size] [-d density] [-m margin] [-b background_color] [-x padding] [-n title] [-l orientation] [-rtl] [-btt] [-f font_name] [-altgd]

DESCRIPTION

Shanty takes a text file and an image (PNG or JPG) and creates a PostScript file where one pixel in the image becomes one character in the PostScript.

OPTIONS

Name of the image to load in. JPG and PNG images are supported. This is the only compulsory field.
Name of the text file to load in, if omitted STDIN is used.
Name of the PostScript file to produce, if omitted STDOUT is used.
Size of the paper to work with. This field should be one of: "a0", "a2", "a3", "a4", "a5", "a6", "letter", "broadsheet", "ledger", "tabloid", "legal", "executive" and "36x36". Default is "a4".
Density of the text. Higher numbers are more dense, default is 1.4.
The margins of the page in cm. Default is 1.
The colour of a backing rectangle to place behind the text. Colours are specified as "R,G,B" with each value between 0 and 255. "off" means no backing colour. Default is "off".
Density of the text. Higher numbers are more dense, default is 1.4.
The title of the output to write as meta-data in the PostScript file. Default is "Shanty output".
The orientation of the paper, can be "portrait", "landscape" or "auto". Default is "auto".
Switch to right-to-left text.
Switch to bottom-to-top text.
Specify font. The font name specified must be visible to the not just make a font magically appear. Default is "Courier-Bold".
If you have problems loading the GD library, try this switch.

HOMEPAGE

<http://www.codebunny.org/coding/shanty/>

AUTHOR

Duncan Martin <duncan@codebunny.org>

ACKNOWLEDGEMENTS

Many thanks to DFB <http://www.cs.nott.ac.uk/~dfb/> and contributors to comp.lang.postscript.

6 October 2006 Duncan Martin