.\"
.\" $Id: fd2ps.man,v 1.3 2009/11/03 23:23:37 jtt Exp $
.\"
.\" Man page for Forms Designer
.\" Use the following command to generate viewable man page
.\"   tbl fdesign.1 | {nt}roff -man
.\"
.\"   ul | more -fsk to view
.\"
.\"
.TH FD2PS 1L "October 2009" "Version 0.36" "Forms Library"
.SH NAME
fd2ps \-  Translates fdesign output to PostScript
.\"
.\" setup
.de Cr
.ie n (c)
.el \(co
..
.SH SYNOPSIS
.if n fd2ps
.if t  \{
.B fd2ps
\}
[-options] input.[fd] [output]
.SH DESCRIPTION
The program
.I fd2ps
translates the
.I fd
file produced by the interface builder program
.I fdesign
of the
.B "Forms Library"
into PostScript (ps), or optionally Encapsulated PostScript
(eps) for printing or inclusion into other documents. The input file
can be given with or without the .fd extension.
If output file name is not specified, used is a filename derived
from the input file name by replacing the .fd extension with
ps or eps. If output filename is specified as \-,
stdout is used.

.SH OPTIONS
.I fd2ps
accepts the following command line options
.TP 6
.B \-help
Prints a brief summary of all command line options.
.TP
.B \-version
Prints the current version of
.I fd2ps
and exits.
.TP
.B \-p
The option requests portrait orientation.
By default, the orientation is switched to landscape
if portrait will not fit the page. This option
overrides the default.
.TP
.B \-l
This options requests landscape output.
.TP
.BI \-bw " n"
Specifies the border width of the interface. By default this information
is obtained from the .fd file.
.TP
.B \-eps
This option requests Encapsulated PostScript instead of
the plain PostScript output.
.TP
.B \-gray
This options requests all colors be converted
to gray levels. By default,
.I fd2ps
outputs colors as specified in the .fd file.
.TP
.B \-G f
specifies a gamma factor that will be used to
adjust the builtin colors in a non-linear fashion.
It can be thought as a way to brighten or dim
the builtin colors: larger the gamma, brighter the color.
The default gamma is 1.0.
.TP
.BI \-dpi " f"
This option specifies the screen resolution on which
the user interface is designed.
By giving a smaller or larger dpi number than that of the screen,
the output is in effect being enlarged or shrunk. This
flag does not affect text size. The default DPI is 85.
If the .fd file is specified in device independent
unit, this flag does not have effect.
.TP
.BI \-rgb " file"
This option specifies the path to the X color database (rgb.txt)
for use in parsing XPM colornames. The default is
/usr/lib/X11/rgb.txt. Environment variable
.B RGBFile
can be used to change the default.
.TP
.BI \-paper " name"
This option specifies the paper name, such as A4, Letter etc.
The output PostScript will always center
on the page.  Use name
.I all
to get a list of the known paper names and sizes.
The default is US Letter unless environment variable
.B PAPER
is set to one of the known paper names.
.TP
.BI \-pw " f"
Specifies the paper width, in inches.
.TP
.BI \-ph " f"
Specifies the paper height, in inches.
.TP
.B \-verbose
This option specifies verbose output, i.e., comments
in the output PostScript file. Most useful for
debugging the
.I fd2ps
program.
.SH BUGS
Not all objects are currently supported.
.SH SEE ALSO
fdesign(1L), xforms(5)
.SH AUTHOR
Copyright
.Cr
1997-98 by T.C. Zhao (tc_zhao@yahoo.com)
.br
Since 2002: GNU Lesser General Public License
.br
Maintainers: Jean-Marc Lasgouttes, Angus Leeming and Jens Thoms Toerring
<jt@toerring.de>
.SH HOME PAGE
http://xforms-toolkit.org
.br
http://world.std.com/~xforms