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

       -i, -image
                 Name of the image to load in. JPG and PNG images are supported. This is the only
                 compulsory field.

       -t, -text Name of the text file to load in, if omitted STDIN is used.

       -o, -output
                 Name of the PostScript file to produce, if omitted STDOUT is used.

       -s, -size 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".

       -d, -density
                 Density of the text. Higher numbers are more dense, default is 1.4.

       -m, -margin
                 The margins of the page in cm. Default is 1.

       -b, -background
                 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".

       -x, -p, -padding
                 Density of the text. Higher numbers are more dense, default is 1.4.

       -n, -title
                 The title of the output to write as meta-data in the PostScript file. Default is
                 "Shanty output".

       -l, -orientation
                 The orientation of the paper, can be "portrait", "landscape" or "auto".  Default
                 is "auto".

       -rtl      Switch to right-to-left text.

       -btt      Switch to bottom-to-top text.

       -f, -font Specify  font.  The  font  name specified must be visible to the not just make a
                 font magically appear. Default is "Courier-Bold".

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