Go to the first, previous, next, last section, table of contents.

Option summary

In the following, options are grouped into subjects and are listed alphabetically within each subject. Both long options and short (one-letter) options are listed, where short options appear in parentheses. Except for the +DPI option, there is a one-to-one correspondence between long and short options. You may use either long or short options. Mixing long and short options is acceptable.

Option parameter names suggest the expected data type, e. g., `--rotate (-r) float' means that option `--rotate' or its corresponding short form `-r' expect a parameter of type `float'.

General options

`--pencolors (-c) string'
Pen color(s), a string of 1 to 8 digits. Valid digits: 0...7 (0=Background or off, 1=Foreground, 2=Red, 3=Green, 4=Blue, 5=Cyan, 6=Magenta, 7=Yellow). Default: `11111111'
`--outfile (-f) string'
Name of output file. If omitted, hp2xx generates the name from the input file name and the current mode string. `-f-' causes hp2xx to write to stdout. Default: none.
`--logfile (-l) string'
Name of log file. If given, diagnostics go into this file, else to stderr. Remark: `-q' inhibits all diagnostics!
`--mode (-m) string'
Mode string. Valid: string =
  `cad'  (TeXcad-compatible line generation using \special{em:...}),
  `em'   (more efficient line drawing with E. Mattes's TeX \special{em:...}),
  `eps'  (Encapsulated PostScript),
  `hpgl' (simplified HP-GL, useful for imports),
  `img'  (e.g., GEM's Image format),
  `mf'   (Metafont source),
  `pbm'  (Portable Bitmap),
  `pcl'  (HP-PCL Level 3),
  `pcx'  (Paintbrush format),
  `pre'  (Preview mode; no output!),
  `rgip' (Uniplex RGIP vector format),
  `tex'  (line drawing with TeX / epic macros)
Occasionally available (unsupported) modes:
  `ilbm' (e.g., for AMIGA: ILBM/IFF format),
  `pac'  (e.g., for ATARI/STAD),
  `pic'  (e.g., for ATARI/Signum).
Default: `pre'.
`--pensize (-p) string'
Pensize(s), a string of 1 to 8 digits. Valid digits: 0...9 (unit = 1/10 mm) for vector modes, 0...4 (unit = pixel) for raster modes. Default: `11111111'
`--pages (-P) int[:[int]]'
Select HP-GL page int or a page range. Valid: int integer and >= 0. Default: int = 0 (all pages).
`--quiet (-q)'
Quiet mode (no diagnostic output).
`--rotation (-r) float'
Rotation angle [deg]. E.g., `-r90' gives landscape. Default: 0.0
`--swapfile (-s) string'
Name of swap file. Default: string = `hp2xx.swp'.

Size controls

`--aspectfactor (-a) float'
Aspect factor. Valid: float > 0.0. Use float > 1.0 for landscape and float < 1.0 for portrait deformations. Default: float = 1.0
`--height (-h) float'
(Upper limit of) height of picture in mm. Default: float=200.0
`--width (-w) float'
(Upper limit of) width of picture in mm. Default: float=200.0
`--x0 (-x) float'
Pre-set left limit of HP-GL coordinate range to float (rarely used).
`--x1 (-X) float'
Pre-set right limit of HP-GL coordinate range to float (rarely used).
`--y0 (-y) float'
Pre-set lower limit of HP-GL coordinate range to float (rarely used).
`--y1 (-Y) float'
Pre-set upper limit of HP-GL coordinate range to float (rarely used).
`--truesize (-t)'
Ignore options `-a -h -w' (aspect factor, height, width). Size information will come from the HP-GL intrinsic data. WARNING: Avoid using option `-r' (rotate) as it works on top of HP-GL and thus will distort the detected HP-GL sizes.

Raster format controls

`--DPI (-d) int'
Set x resolution to int dots per inch (DPI). If not overridden by `-D', sets also y resolution to int DPI. Valid: int integer and > 0. Default: int = 75.
`--DPI_x (-d) int'
Same as `--DPI'
`--DPI_y (-D) int'
Set y resolution to int DPI. int integer and > 0. Default: int = 75.

PCL specifics

`--PCL_formfeed (-F)'
Send a FormFeed after graphics data. Default: No FormFeed.
`--PCL_init (-i)'
Pre-initialize printer. Default: No pre-init
`--PCL_Deskjet (-S) int'
Use (Deskjet) Special commands. int = 0 deactivates this option, int = 1 enables b/w mode, int = 3 is intended for DJ500C (CMY) color support, int = 4 supports DJ550C (CMYK mode).
`--DPI_x (-d) int'
Set x resolution (see above): Valid here: int = 75, 100, 150, 300
`--DPI_y (-D) int'
Set y resolution (see above). Invalid here!

Margins

(Apply to modes `eps', `pcl', `pre' ONLY)

`--xoffset (-o) float'
X offset of picture (left margin) in mm. Valid: float >= 0.0, default: float=0.0
`--yoffset (-O) float'
Y offset of picture (upper margin) in mm. Valid: float >= 0.0, default: float=0.0

Preview (DOS/PC's only)

`--VGAmodebyte (-V) int'
VGA mode byte (decimal). Default: int = 18. WARNING: Setting inappropriate VGA modes may damage your hardware, especially your monitor!

Help

`--help (-H)'
(or calling hp2xx without any arguments) Show on-line help.

@appendix

Acknowledgement

While hp2xx was available as binaries on several platforms, many people contributed to this project by supplying me with valuable suggestions and reports. Many thanks to all of them! It is my pleasure to especially thank the following people for their outstanding contributions:

Nelson Beebe
Help with the new generic makefile (easier configuration); clean selection mechanism for reviewer suggested
Elisabeth Dregger-Cappel
Network and host resources for hp2xx distribution
Joern Eggers
New ATARI format "cs" for CS-TeX; bug fixes for arcs / circles
Roland Emmerich
DOS betatests and suggestions; showit
Jonathan M. Gillian
DOS betatests and suggestions
Gilles Gravier
RGIP converter
Thomas Hiller
Code for EA support
Claus H. Langhans
AMIGA portation; pbm, ilbm formats
Norbert Meyer
ATARI portation; img, pic, pac formats; first ATARI previewer
Michael Schmitz
Many VAX & MACH tests
Michael Schoene
X11 stuff; many tests
Andreas Schwab
Improved ATARI previewer
Friedhelm Sowa
Many DOS tests and suggestions for cooperation of hp2xx with TeX figure generation
Gerhard Steger
Many VAX tests; VAX scripts; access to MicroVAX platforms
Horst Szillat
OS/2 support, OS/2 full-screen previewer & help
A. Treindl
Code for UC support

Copyright notice

Copyright (c) 1991 - 1993  Heinz W. Werntges
All rights reserved.

Redistribution and use in source and binary forms are permitted provided that
the above copyright notice and this paragraph are duplicated in all such forms
and that any documentation, advertising materials, and other materials related
to such distribution and use acknowledge that the software was developed
by the abovementioned author(s).

THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION,
THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS
FOR A PARTICULAR PURPOSE.

Go to the first, previous, next, last section, table of contents.