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.