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:...}),
  `dxf'  (Autocad Drawing Exchange Format),
  `em'   (more efficient line drawing with E. Mattes's TeX \special{em:...}),
  `eps'  (Encapsulated PostScript),
  `gpt'  (Gnuplot input file),
  `hpgl' (simplified HP-GL, useful for imports),
  `img'  (e.g., GEM's Image format),
  `jpg'  (JPEG image format),
  `mf'   (Metafont source),
  `nc'   (G code for CNC engraving tools)
  `pbm'  (Portable Bitmap (monochrome) or Portable Pixmap (color plots)),
  `pcl'  (HP-PCL Level 3),
  `pcx'  (Paintbrush format),
  `pdf'  (Adobe Portable Document Format),
  `png'  (Portable Network Graphics format),
  `pre'  (Preview mode; no output!),
  `rgip' (Uniplex RGIP vector format),
  `svg'  (Scalable Vector Graphics, for XML web pages)
  `tex'  (line drawing with TeX / epic macros)
  `fig'  (for Brian Smith's XFIG vector drawing program)
  `tiff' (TIFF tagged image file format)
  `esc2' (Epson Stylus printers)

Occasionally available (currently unsupported) modes:

  `ilbm' (e.g., for AMIGA: ILBM/IFF format),
  `pac'  (e.g., for ATARI/STAD),
  `pic'  (e.g., for ATARI/Signum).

Default: `pre'.

`--nofill (-n)'

Ignore all polygon fill commands in the HPGL file(s). This may sometimes be necessary to improve readability of images at small scales (e.g. thumbnails in an overview listing), or to work around problems in the polygon fill code.

`--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).

`--zengange (-z float'

This option is only relevant for CNC G-code generation (` -m nc', where it sets the working depth of the tool.

`--zretract (-Z float'

This option is only relevant for CNC G-code generation (` -m nc', where it sets the retraction level of the tool.

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

`--extraclip (-e) int'

Set extra clipping space to int plotter units. Default: int = 0.

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!

TIFF specifics

`-S int'

Select TIFF compression algorithm. int = 0 or 1 no compression, int = 2 run length encoding (RLE), int = 3 Group 3 FAX, int = 4 Group 4 FAX; int = 5 LZW (normally disabled in to_tiff.c due to Unisys patent), int = 6 old-style JPEG, int = 7 JPEG, int = 8 Deflate.

Margins

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

`--center (-C)'

Center the picture within the frame defined by options `-w -h' by adding to the left or upper margin. Null effect if the width/height ratio of the picture matches that of options `-w -h'.

`--no_ps (-N)'

Ignore papersize definition given by a PS command in the HPGL file, and calculate the actual image size. This may be necessary to avoid unnecessary margins (with programs that write a standard header regardless of the true size of the drawing).

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

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