@c key options
@menu
* General Options::
* General GUI Options::
* GTK+ GUI Options::
* lesstif GUI Options::
* Colors::
* Layer Names::
* Paths::
* Sizes::
* Commands::
* DRC Options::
* BOM Creation::
* G-code Options::
* Gerber Export::
* Postscript Export::
* Encapsulated Postscript Export::
* PNG Options::
* Nelma Options::
* IPC-D-356 Netlist Export::
* gsvit Options::
* lpr Printing Options::
@end menu
@c options General Options
@node General Options
@section General Options
@c ./../src/main.c 447
@ftable @code
@item --help
Show help on command line options.
@end ftable
@c ./../src/main.c 452
@ftable @code
@item --version
Show version.
@end ftable
@c ./../src/main.c 456
@ftable @code
@item --verbose
Be verbose on stdout.
@end ftable
@c ./../src/main.c 461
@ftable @code
@item --copyright
Show copyright.
@end ftable
@c ./../src/main.c 466
@ftable @code
@item --show-defaults
Show option defaults.
@end ftable
@c ./../src/main.c 471
@ftable @code
@item --show-actions
Show available actions and exit.
@end ftable
@c ./../src/main.c 476
@ftable @code
@item --dump-actions
Dump actions (for documentation).
@end ftable
@c ./../src/main.c 481
@ftable @code
@item --grid-units-mm <string>
Set default grid units. Can be mm or mil. Defaults to mil.
@end ftable
@c ./../src/main.c 486
@ftable @code
@item --clear-increment-mm <string>
Set default clear increment (amount to change when user presses k or K)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 491
@ftable @code
@item --grid-increment-mm <string>
Set default grid increment (amount to change when user presses g or G)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 496
@ftable @code
@item --line-increment-mm <string>
Set default line increment (amount to change when user presses l or L)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 501
@ftable @code
@item --size-increment-mm <string>
Set default size increment (amount to change when user presses s or S)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 506
@ftable @code
@item --clear-increment-mil <string>
Set default clear increment (amount to change when user presses k or K)
when user is using an imperial grid unit.
@end ftable
@c ./../src/main.c 511
@ftable @code
@item --grid-increment-mil <string>
Set default grid increment (amount to change when user presses g or G)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 516
@ftable @code
@item --line-increment-mil <string>
Set default line increment (amount to change when user presses l or L)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 521
@ftable @code
@item --size-increment-mil <string>
Set default size increment (amount to change when user presses s or S)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 749
@ftable @code
@item --backup-interval
Time between automatic backups in seconds. Set to @code{0} to disable.
The default value is @code{60}.
@end ftable
@c ./../src/main.c 786
@ftable @code
@item --groups <string>
Layer group string. Defaults to @code{"1,c:2:3:4:5:6,s:7:8"}.
@end ftable
@c ./../src/main.c 851
@ftable @code
@item --route-styles <string>
A string that defines the route styles. Defaults to @*
@code{"Signal,1000,3600,2000,1000:Power,2500,6000,3500,1000
	:Fat,4000,6000,3500,1000:Skinny,600,2402,1181,600"}
@end ftable
@c ./../src/main.c 870
@ftable @code
@item --element-path <string>
A colon separated list of directories or commands (starts with '|').
The path is passed to the program specified in @option{--element-command}.
@end ftable
@c ./../src/main.c 880
@ftable @code
@item --action-script <string>
If set, this file is executed at startup.
@end ftable
@c ./../src/main.c 885
@ftable @code
@item --action-string <string>
If set, this string of actions is executed at startup.
@end ftable
@c ./../src/main.c 890
@ftable @code
@item --fab-author <string>
Name of author to be put in the Gerber files.
@end ftable
@c ./../src/main.c 895
@ftable @code
@item --layer-stack <string>
Initial layer stackup, for setting up an export. A comma separated list of layer
names, layer numbers and layer groups.
@end ftable
@c ./../src/main.c 946
@ftable @code
@item --save-last-command
If set, the last user command is saved.
@end ftable
@c ./../src/main.c 950
@ftable @code
@item --save-in-tmp
If set, all data which would otherwise be lost are saved in a temporary file
@file{/tmp/PCB.%i.save} . Sequence @samp{%i} is replaced by the process ID.
@end ftable
@c ./../src/main.c 955
@ftable @code
@item --save-metric-only
If set, save pcb files using only mm unit suffix rather than 'smart' mil/mm.
@end ftable
@c ./../src/main.c 969
@ftable @code
@item --reset-after-element
If set, all found connections are reset before a new component is scanned.
@end ftable
@c ./../src/main.c 974
@ftable @code
@item --auto-buried-vias
Enables automatically created vias (during line moves and layer switch) to be buriad/blind vias
@end ftable
@c ./../src/main.c 979
@ftable @code
@item --ring-bell-finished
Execute the bell command when all rats are routed.
@end ftable
@c options General GUI Options
@node General GUI Options
@section General GUI Options
@c ./../src/main.c 905
@ftable @code
@item --pinout-offset-x <num>
Horizontal offset of the pin number display. Defaults to @code{100mil}.
@end ftable
@c ./../src/main.c 910
@ftable @code
@item --pinout-offset-y <num>
Vertical offset of the pin number display. Defaults to @code{100mil}.
@end ftable
@c ./../src/main.c 915
@ftable @code
@item --pinout-text-offset-x <num>
Horizontal offset of the pin name display. Defaults to @code{800mil}.
@end ftable
@c ./../src/main.c 920
@ftable @code
@item --pinout-text-offset-y <num>
Vertical offset of the pin name display. Defaults to @code{-100mil}.
@end ftable
@c ./../src/main.c 925
@ftable @code
@item --draw-grid
If set, draw the grid at start-up.
@end ftable
@c ./../src/main.c 929
@ftable @code
@item --clear-line
If set, new lines clear polygons.
@end ftable
@c ./../src/main.c 933
@ftable @code
@item --full-poly
If set, new polygons are full ones.
@end ftable
@c ./../src/main.c 937
@ftable @code
@item --unique-names
If set, you will not be permitted to change the name of an component to match that
of another component.
@end ftable
@c ./../src/main.c 941
@ftable @code
@item --snap-pin
If set, pin centers and pad end points are treated as additional grid points
that the cursor can snap to.
@end ftable
@c ./../src/main.c 960
@ftable @code
@item --all-direction-lines
Allow all directions, when drawing new lines.
@end ftable
@c ./../src/main.c 965
@ftable @code
@item --show-number
Pinout shows number.
@end ftable
@c options GTK+ GUI Options
@node GTK+ GUI Options
@section GTK+ GUI Options
@c ./../src/hid/gtk/gui-top-window.c 1748
@ftable @code
@item --listen
Listen for actions on stdin.
@end ftable
@c ./../src/hid/gtk/gui-top-window.c 1754
@ftable @code
@item --bg-image <string>
File name of an image to put into the background of the GUI canvas. The image must
be a color PPM image, in binary (not ASCII) format. It can be any size, and will be
automatically scaled to fit the canvas.
@end ftable
@c ./../src/hid/gtk/gui-top-window.c 1760
@ftable @code
@item --pcb-menu <string>
Location of the @file{gpcb-menu.res} file which defines the menu for the GTK+ GUI.
@end ftable
@c options lesstif GUI Options
@node lesstif GUI Options
@section lesstif GUI Options
@c ./../src/hid/lesstif/main.c 238
@ftable @code
@item --listen
Listen for actions on stdin.
@end ftable
@c ./../src/hid/lesstif/main.c 244
@ftable @code
@item --bg-image <string>
File name of an image to put into the background of the GUI canvas. The image must
be a color PPM image, in binary (not ASCII) format. It can be any size, and will be
automatically scaled to fit the canvas.
@end ftable
@c ./../src/hid/lesstif/main.c 250
@ftable @code
@item --pcb-menu <string>
Location of the @file{pcb-menu.res} file which defines the menu for the lesstif GUI.
@end ftable
@c options Colors
@node Colors
@section Colors
@c ./../src/main.c 526
@ftable @code
@item --black-color <string>
Color value for black. Default: @samp{#000000}
@end ftable
@c ./../src/main.c 530
@ftable @code
@item --black-color <string>
Color value for white. Default: @samp{#ffffff}
@end ftable
@c ./../src/main.c 534
@ftable @code
@item --background-color <string>
Background color of the canvas. Default: @samp{#e5e5e5}
@end ftable
@c ./../src/main.c 539
@ftable @code
@item --crosshair-color <string>
Color of the crosshair. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 544
@ftable @code
@item --cross-color <string>
Color of the cross. Default: @samp{#cdcd00}
@end ftable
@c ./../src/main.c 548
@ftable @code
@item --via-color <string>
Color of vias. Default: @samp{#7f7f7f}
@end ftable
@c ./../src/main.c 552
@ftable @code
@item --via-selected-color <string>
Color of selected vias. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 557
@ftable @code
@item --pin-color <string>
Color of pins. Default: @samp{#4d4d4d}
@end ftable
@c ./../src/main.c 561
@ftable @code
@item --pin-selected-color <string>
Color of selected pins. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 566
@ftable @code
@item --pin-name-color <string>
Color of pin names and pin numbers. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 571
@ftable @code
@item --element-color <string>
Color of components. Default: @samp{#000000}
@end ftable
@c ./../src/main.c 575
@ftable @code
@item --rat-color <string>
Color of ratlines. Default: @samp{#b8860b}
@end ftable
@c ./../src/main.c 579
@ftable @code
@item --invisible-objects-color <string>
Color of invisible objects. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 584
@ftable @code
@item --invisible-mark-color <string>
Color of invisible marks. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 589
@ftable @code
@item --element-selected-color <string>
Color of selected components. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 594
@ftable @code
@item --rat-selected-color <string>
Color of selected rats. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 599
@ftable @code
@item --connected-color <string>
Color to indicate physical connections. Default: @samp{#00ff00}
@end ftable
@c ./../src/main.c 604
@ftable @code
@item --found-color <string>
Color to indicate logical connections. Default: @samp{#ff00ff}
@end ftable
@c ./../src/main.c 609
@ftable @code
@item --off-limit-color <string>
Color of off-canvas area. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 614
@ftable @code
@item --grid-color <string>
Color of the grid. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 618
@ftable @code
@item --layer-color-<n> <string>
Color of layer @code{<n>}, where @code{<n>} is an integer from 1 to 16.
@end ftable
@c ./../src/main.c 636
@ftable @code
@item --layer-selected-color-<n> <string>
Color of layer @code{<n>}, when selected. @code{<n>} is an integer from 1 to 16.
@end ftable
@c ./../src/main.c 655
@ftable @code
@item --warn-color <string>
Color of offending objects during DRC. Default value is @code{"#ff8000"}
@end ftable
@c ./../src/main.c 659
@ftable @code
@item --mask-color <string>
Color of the mask layer. Default value is @code{"#ff0000"}
@end ftable
@c options Layer Names
@node Layer Names
@section Layer Names
@c ./../src/main.c 754
@ftable @code
@item --layer-name-1 <string>
Name of the 1st Layer. Default is @code{"top"}.
@end ftable
@c ./../src/main.c 758
@ftable @code
@item --layer-name-2 <string>
Name of the 2nd Layer. Default is @code{"ground"}.
@end ftable
@c ./../src/main.c 762
@ftable @code
@item --layer-name-3 <string>
Name of the 3nd Layer. Default is @code{"signal2"}.
@end ftable
@c ./../src/main.c 766
@ftable @code
@item --layer-name-4 <string>
Name of the 4rd Layer. Default is @code{"signal3"}.
@end ftable
@c ./../src/main.c 770
@ftable @code
@item --layer-name-5 <string>
Name of the 5rd Layer. Default is @code{"power"}.
@end ftable
@c ./../src/main.c 774
@ftable @code
@item --layer-name-6 <string>
Name of the 6rd Layer. Default is @code{"bottom"}.
@end ftable
@c ./../src/main.c 778
@ftable @code
@item --layer-name-7 <string>
Name of the 7rd Layer. Default is @code{"outline"}.
@end ftable
@c ./../src/main.c 782
@ftable @code
@item --layer-name-8 <string>
Name of the 8rd Layer. Default is @code{"spare"}.
@end ftable
@c options Paths
@node Paths
@section Paths
@c ./../src/main.c 832
@ftable @code
@item --lib-newlib <string>
Top level directory for the newlib style library.
@end ftable
@c ./../src/main.c 841
@ftable @code
@item --lib-name <string>
The default filename for the library.
@end ftable
@c ./../src/main.c 846
@ftable @code
@item --default-font <string>
The name of the default font.
@end ftable
@c ./../src/main.c 857
@ftable @code
@item --file-path <string>
A colon separated list of directories or commands (starts with '|'). The path
is passed to the program specified in @option{--file-command} together with the selected
filename.
@end ftable
@c ./../src/main.c 865
@ftable @code
@item --font-path <string>
A colon separated list of directories to search the default font. Defaults to
the default library path.
@end ftable
@c ./../src/main.c 875
@ftable @code
@item --lib-path <string>
A colon separated list of directories that will be passed to the commands specified
by @option{--element-command} and @option{--element-contents-command}.
@end ftable
@c options Sizes
@node Sizes
@section Sizes
@c ./../src/main.c 664
All parameters should be given with an unit. If no unit is given, 1/100 mil
(cmil) will be used. Write units without space to the
number like @code{3mm}, not @code{3 mm}.
Valid Units are:
 @table @samp
   @item km
    Kilometer
   @item m
    Meter
   @item cm
    Centimeter
   @item mm
    Millimeter
   @item um
    Micrometer
   @item nm
    Nanometer
   @item in
    Inch (1in = 0.0254m)
   @item mil
    Mil (1000mil = 1in)
   @item cmil
    Centimil (1/100 mil)
@end table

@ftable @code
@item --via-thickness <num>
Default diameter of vias. Default value is @code{60mil}.
@end ftable
@c ./../src/main.c 669
@ftable @code
@item --via-drilling-hole <num>
Default diameter of holes. Default value is @code{28mil}.
@end ftable
@c ./../src/main.c 674
@ftable @code
@item --line-thickness <num>
Default thickness of new lines. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 679
@ftable @code
@item --rat-thickness <num><unit>
Thickness of rats. If no unit is given, PCB units are assumed (i.e. 100 
means "1 nm"). This option allows for a special unit @code{px} which 
sets the rat thickness to a fixed value in terms of screen pixels.
Maximum fixed thickness is 100px. Minimum saling rat thickness is 101nm.  
Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 683
@ftable @code
@item --keepaway <num>
Default minimum distance between a track and adjacent copper.
Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 687
@ftable @code
@item --default-PCB-width <num>
Default width of the canvas. Default value is @code{6000mil}.
@end ftable
@c ./../src/main.c 692
@ftable @code
@item --default-PCB-height <num>
Default height of the canvas. Default value is @code{5000mil}.
@end ftable
@c ./../src/main.c 697
@ftable @code
@item --text-scale <num>
Default text scale. This value is in percent. Default value is @code{100}.
@end ftable
@c ./../src/main.c 701
@ftable @code
@item --alignment-distance <num>
Specifies the distance between the board outline and alignment targets.
Default value is @code{2mil}.
@end ftable
@c ./../src/main.c 735
@ftable @code
@item --grid <num>
Initial grid size. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 739
@ftable @code
@item --minimum polygon area <num>
Minimum polygon area.
@end ftable
@c ./../src/main.c 744
@ftable @code
@item --paste-adjust <num>
Adjust pad thickness in paste layer. Default value is @code{0}.
Shrinking the pads is done with a negative amount.

Example:
@example
pcb -x gerber --paste-adjust -0.07mm filename.pcb
@end example
@end ftable
@c options Commands
@node Commands
@section Commands
@c ./../src/main.c 791
pcb uses external commands for input output operations. These commands can be
configured at start-up to meet local requirements. The command string may include
special sequences @code{%f}, @code{%p} or @code{%a}. These are replaced when the
command is called. The sequence @code{%f} is replaced by the file name,
@code{%p} gets the path and @code{%a} indicates a package name.
@c ./../src/main.c 794
@ftable @code
@item --font-command <string>
Command to load a font.
@end ftable
@c ./../src/main.c 798
@ftable @code
@item --file-command <string>
Command to read a file.
@end ftable
@c ./../src/main.c 802
@ftable @code
@item --element-command <string>
Command to read a footprint. @*
Defaults to @code{"M4PATH='%p';export M4PATH;echo 'include(%f)' | m4"}
@end ftable
@c ./../src/main.c 808
@ftable @code
@item --print-file <string>
Command to print to a file.
@end ftable
@c ./../src/main.c 812
@ftable @code
@item --lib-command-dir <string>
Path to the command that queries the library.
@end ftable
@c ./../src/main.c 817
@ftable @code
@item --lib-command <string>
Command to query the library. @*
Defaults to @code{"QueryLibrary.sh '%p' '%f' %a"}
@end ftable
@c ./../src/main.c 822
@ftable @code
@item --lib-contents-command <string>
Command to query the contents of the library. @*
Defaults to @code{"ListLibraryContents.sh %p %f"} or,
on Windows builds, an empty string (to disable this feature).
@end ftable
@c ./../src/main.c 837
@ftable @code
@item --save-command <string>
Command to save to a file.
@end ftable
@c ./../src/main.c 861
@ftable @code
@item --rat-command <string>
Command for reading a netlist. Sequence @code{%f} is replaced by the netlist filename.
@end ftable
@c options DRC Options
@node DRC Options
@section DRC Options
@c ./../src/main.c 706
All parameters should be given with an unit. If no unit is given, 1/100 mil
(cmil) will be used for backward compability. Valid units are given in section
@ref{Sizes}.
@c ./../src/main.c 710
@ftable @code
@item --bloat <num>
Minimum spacing. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 714
@ftable @code
@item --shrink <num>
Minimum touching overlap. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 718
@ftable @code
@item --min-width <num>
Minimum width of copper. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 722
@ftable @code
@item --min-silk <num>
Minimum width of lines in silk. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 726
@ftable @code
@item --min-drill <num>
Minimum diameter of holes. Default value is @code{15mil}.
@end ftable
@c ./../src/main.c 730
@ftable @code
@item --min-ring <num>
Minimum width of annular ring. Default value is @code{10mil}.
@end ftable
@c options BOM Creation
@node BOM Creation
@section BOM Creation
@c ./../src/hid/bom/bom.c 67
@ftable @code
@item --bomfile <string>
Name of the BOM output file.
Parameter @code{<string>} can include a path.
@end ftable
@c ./../src/hid/bom/bom.c 72
@ftable @code
@item --xyfile <string>
Name of the XY output file.
Parameter @code{<string>} can include a path.
@end ftable
@c ./../src/hid/bom/bom.c 78
@ftable @code
@item --xy-unit <unit>
Unit of XY dimensions. Defaults to mil.
Parameter @code{<unit>} can be @samp{km}, @samp{m}, @samp{cm}, @samp{mm},
@samp{um}, @samp{nm}, @samp{px}, @samp{in}, @samp{mil}, @samp{dmil},
@samp{cmil}, or @samp{inch}.
@end ftable
@c options G-code Options
@node G-code Options
@section G-code Options
@c ./../src/hid/gcode/gcode.c 173
@ftable @code
@item --basename <string>
File name prefix and suffix, layer names will be inserted before the
suffix.
Parameter @code{<string>} can include a path.
@end ftable
@c ./../src/hid/gcode/gcode.c 180
@ftable @code
@item --measurement-unit <unit>
Measurement unit used in the G-code output.
Defaults to mil.
Parameter @code{<unit>} can be @samp{km}, @samp{m}, @samp{cm}, @samp{mm},
@samp{um}, @samp{nm}, @samp{px}, @samp{in}, @samp{mil}, @samp{dmil},
@samp{cmil}, or @samp{inch}.
@end ftable
@c ./../src/hid/gcode/gcode.c 186
@ftable @code
@item --dpi <int>
Accuracy of the mill path generation in pixels/inch.
@end ftable
@c ./../src/hid/gcode/gcode.c 192
@ftable @code
@item --safe-Z <real>
Safe Z for traverse movements of all operations.
@end ftable
@c ./../src/hid/gcode/gcode.c 198
@ftable @code
@item --iso-mill-depth <real>
Isolation milling depth.
@end ftable
@c ./../src/hid/gcode/gcode.c 204
@ftable @code
@item --iso-tool-diameter <real>
Isolation milling tool diameter.
@end ftable
@c ./../src/hid/gcode/gcode.c 210
@ftable @code
@item --iso-tool-plunge <real>
Isolation milling feedrate when plunging into the material.
@end ftable
@c ./../src/hid/gcode/gcode.c 217
@ftable @code
@item --iso-tool-feedrate <real>
Isolation milling feedrate.
@end ftable
@c ./../src/hid/gcode/gcode.c 223
@ftable @code
@item --predrill
Whether to pre-drill all drill spots with the isolation milling tool.
Drill depth is iso-mill-depth here.
This feature eases and enhances accuracy of manual drilling.
@end ftable
@c ./../src/hid/gcode/gcode.c 231
@ftable @code
@item --drill-depth <real>
Drilling depth.
@end ftable
@c ./../src/hid/gcode/gcode.c 237
@ftable @code
@item --drill-feedrate <real>
Drilling feedrate.
@end ftable
@c ./../src/hid/gcode/gcode.c 243
@ftable @code
@item --drill-mill
Whether to produce drill holes equal or bigger than the milling tool
diameter with the milling tool.
With the milling tool bigger holes can be accurately sized without
changing the tool.
@end ftable
@c ./../src/hid/gcode/gcode.c 252
@ftable @code
@item --outline-mill-depth <real>
Milling depth when milling the outline.
Currently, only the rectangular extents of the board are milled, no
polygonal outlines or holes.
@end ftable
@c ./../src/hid/gcode/gcode.c 260
@ftable @code
@item --outline-tool-diameter <real>
Diameter of the tool used for outline milling.
@end ftable
@c ./../src/hid/gcode/gcode.c 266
@ftable @code
@item --outline-mill-plunge <real>
Outline milling feedrate when plunging into the material.
@end ftable
@c ./../src/hid/gcode/gcode.c 273
@ftable @code
@item --outline-mill-feedrate <real>
Outline milling feedrate.
@end ftable
@c ./../src/hid/gcode/gcode.c 279
@ftable @code
@item --advanced-gcode
Whether to produce G-code for advanced interpreters, like using variables
or drill cycles.
Not all machine controllers understand this, but it allows better
hand-editing of the resulting files.
@end ftable
@c options Gerber Export
@node Gerber Export
@section Gerber Export
@c ./../src/hid/gerber/gerber.c 350
@ftable @code
@item --gerberfile <string>
Gerber output file prefix. Parameter @code{<string>} can include a path.
@end ftable
@c ./../src/hid/gerber/gerber.c 356
@ftable @code
@item --all-layers
Output contains all layers, even empty ones.
@end ftable
@c ./../src/hid/gerber/gerber.c 362
@ftable @code
@item --verbose
Print file names and aperture counts on stdout.
@end ftable
@c ./../src/hid/gerber/gerber.c 368
@ftable @code
@item --metric
Generate metric Gerber and drill files
@end ftable
@c ./../src/hid/gerber/gerber.c 374
@ftable @code
@item --copy-outline <string>
Copy the outline onto other layers.
Parameter @code{<string>} can be @samp{none}, @samp{mask},
@samp{silk} or @samp{all}.
@end ftable
@c ./../src/hid/gerber/gerber.c 380
@ftable @code
@item --name-style <string>
Naming style for individual gerber files.
Parameter @code{<string>} can be @samp{fixed}, @samp{single},
@samp{first}, @samp{eagle}, @samp{hackvana} or @samp{oshpark}.
@end ftable
@c options Postscript Export
@node Postscript Export
@section Postscript Export
@c ./../src/hid/ps/ps.c 146
@ftable @code
@item --psfile <string>
Name of the postscript output file. Can contain a path.
@end ftable
@c ./../src/hid/ps/ps.c 152
@ftable @code
@cindex drill-helper
@item --drill-helper
Print a centering target in large drill holes.
@end ftable
@c ./../src/hid/ps/ps.c 158
@ftable @code
@cindex align-marks
@item --align-marks
Print alignment marks on each sheet. This is meant to ease alignment during exposure.
@end ftable
@c ./../src/hid/ps/ps.c 164
@ftable @code
@item --outline
Print the contents of the outline layer on each sheet.
@end ftable
@c ./../src/hid/ps/ps.c 169
@ftable @code
@item --mirror
Print mirror image.
@end ftable
@c ./../src/hid/ps/ps.c 175
@ftable @code
@item --fill-page
Scale output to make the board fit the page.
@end ftable
@c ./../src/hid/ps/ps.c 181
@ftable @code
@item --auto-mirror
Print mirror image of appropriate layers.
@end ftable
@c ./../src/hid/ps/ps.c 187
@ftable @code
@item --ps-color
Postscript output in color.
@end ftable
@c ./../src/hid/ps/ps.c 193
@ftable @code
@cindex ps-bloat
@item --ps-bloat <num>
Amount to add to trace/pad/pin edges.
@end ftable
@c ./../src/hid/ps/ps.c 199
@ftable @code
@cindex ps-invert
@item --ps-invert
Draw objects as white-on-black.
@end ftable
@c ./../src/hid/ps/ps.c 205
@ftable @code
@item --media <media-name>
Size of the media, the postscript is fitted to. The parameter
@code{<media-name>} can be any of the standard names for paper size: @samp{A0}
to @samp{A10}, @samp{B0} to @samp{B10}, @samp{Letter}, @samp{11x17},
@samp{Ledger}, @samp{Legal}, @samp{Executive}, @samp{A-Size}, @samp{B-size},
@samp{C-Size}, @samp{D-size}, @samp{E-size}, @samp{US-Business_Card},
@samp{Intl-Business_Card}.
@end ftable
@c ./../src/hid/ps/ps.c 211
@ftable @code
@cindex psfade
@item --psfade <num>
Fade amount for assembly drawings (0.0=missing, 1.0=solid).
@end ftable
@c ./../src/hid/ps/ps.c 218
@ftable @code
@item --scale <num>
Scale value to compensate for printer sizing errors (1.0 = full scale).
@end ftable
@c ./../src/hid/ps/ps.c 225
@ftable @code
@cindex multi-file
@item --multi-file
Produce multiple files, one per page, instead of a single multi page file.
@end ftable
@c ./../src/hid/ps/ps.c 232
@ftable @code
@item --xcalib <num>
Paper width. Used for x-Axis calibration.
@end ftable
@c ./../src/hid/ps/ps.c 238
@ftable @code
@item --ycalib <num>
Paper height. Used for y-Axis calibration.
@end ftable
@c ./../src/hid/ps/ps.c 244
@ftable @code
@item --drill-copper
Draw drill holes in pins / vias, instead of leaving solid copper.
@end ftable
@c ./../src/hid/ps/ps.c 251
@ftable @code
@cindex show-legend
@item --show-legend
Print file name and scale on printout.
@end ftable
@c options Encapsulated Postscript Export
@node Encapsulated Postscript Export
@section Encapsulated Postscript Export
@c ./../src/hid/ps/eps.c 76
@ftable @code
@item --eps-file <string>
Name of the encapsulated postscript output file. Can contain a path.
@end ftable
@c ./../src/hid/ps/eps.c 82
@ftable @code
@item --eps-scale <num>
Scale EPS output by the parameter @samp{num}.
@end ftable
@c ./../src/hid/ps/eps.c 88
@ftable @code
@cindex screen-layer-order (EPS)
@item --screen-layer-order
Export layers as shown on screen.
@end ftable
@c ./../src/hid/ps/eps.c 94
@ftable @code
@item --monochrome
Convert output to monochrome.
@end ftable
@c ./../src/hid/ps/eps.c 100
@ftable @code
@cindex only-visible
@item --only-visible
Limit the bounds of the EPS file to the visible items.
@end ftable
@c options PNG Options
@node PNG Options
@section PNG Options
@c ./../src/hid/png/png.c 236
@ftable @code
@item --outfile <string>
Name of the file to be exported to.
Parameter @code{<string>} can include a path.
@end ftable
@c ./../src/hid/png/png.c 242
@ftable @code
@item --dpi
Scale factor in pixels/inch. Set to 0 to scale to size specified in the layout.
@end ftable
@c ./../src/hid/png/png.c 248
@ftable @code
@item --x-max
Width of the png image in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 254
@ftable @code
@item --y-max
Height of the png output in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 260
@ftable @code
@item --xy-max
Maximum width and height of the PNG output in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 266
@ftable @code
@item --screen-layer-order
Export layers in the order shown on screen.
@end ftable
@c ./../src/hid/png/png.c 272
@ftable @code
@item --monochrome
Convert output to monochrome.
@end ftable
@c ./../src/hid/png/png.c 278
@ftable @code
@item --only-visible
Limit the bounds of the exported PNG image to the visible items.
@end ftable
@c ./../src/hid/png/png.c 284
@ftable @code
@item --use-alpha
Make the background and any holes transparent.
@end ftable
@c ./../src/hid/png/png.c 290
@ftable @code
@item --fill-holes
Drill holes in pins/pads are filled, not hollow.
@end ftable
@c ./../src/hid/png/png.c 296
@ftable @code
@item --format <string>
File format to be exported. Parameter @code{<string>} can be @samp{PNG},
@samp{GIF}, or @samp{JPEG}.
@end ftable
@c ./../src/hid/png/png.c 302
@ftable @code
@item --png-bloat <num><dim>
Amount of extra thickness to add to traces, pads, or pin edges. The parameter
@samp{<num><dim>} is a number, appended by a dimension @samp{mm}, @samp{mil}, or
@samp{pix}. If no dimension is given, the default dimension is 1/100 mil.
@end ftable
@c ./../src/hid/png/png.c 308
@ftable @code
@cindex photo-mode
@item --photo-mode
Export a photo realistic image of the layout.
@end ftable
@c ./../src/hid/png/png.c 314
@ftable @code
@item --photo-flip-x
In photo-realistic mode, export the reverse side of the layout. Left-right flip.
@end ftable
@c ./../src/hid/png/png.c 320
@ftable @code
@item --photo-flip-y
In photo-realistic mode, export the reverse side of the layout. Up-down flip.
@end ftable
@c ./../src/hid/png/png.c 326
@ftable @code
@cindex photo-mask-colour
@item --photo-mask-colour <colour>
In photo-realistic mode, export the solder mask as this colour.
Parameter @code{<colour>} can be @samp{green}, @samp{red}, @samp{blue},
@samp{purple}, @samp{black}, or @samp{white}.
@end ftable
@c ./../src/hid/png/png.c 332
@ftable @code
@cindex photo-plating
@item --photo-plating <colour>
In photo-realistic mode, export the exposed copper as though it has this type
of plating. Parameter @code{<colour>} can be @samp{tinned}, @samp{gold},
@samp{silver}, or @samp{copper}.
@end ftable
@c ./../src/hid/png/png.c 338
@ftable @code
@cindex photo-silk-colour
@item --photo-silk-colour <colour>
In photo-realistic mode, export the silk screen as this colour. Parameter
@code{<colour>} can be @samp{white}, @samp{black}, or @samp{yellow}.
@end ftable
@c options Nelma Options
@node Nelma Options
@section Nelma Options
@c ./../src/hid/nelma/nelma.c 155
@ftable @code
@item --basename <string>
File name prefix.
@end ftable
@c ./../src/hid/nelma/nelma.c 161
@ftable @code
@item --dpi <num>
Horizontal scale factor (grid points/inch).
@end ftable
@c ./../src/hid/nelma/nelma.c 167
@ftable @code
@item --copper-height <num>
Copper layer height (um).
@end ftable
@c ./../src/hid/nelma/nelma.c 173
@ftable @code
@item --substrate-height <num>
Substrate layer height (um).
@end ftable
@c ./../src/hid/nelma/nelma.c 179
@ftable @code
@item --substrate-epsilon <num>
Substrate relative epsilon.
@end ftable
@c options IPC-D-356 Netlist Export
@node IPC-D-356 Netlist Export
@section IPC-D-356 Netlist Export
@c ./../src/hid/ipcd356/ipcd356.c 64
@ftable @code
@item --netlist-file <string>
Name of the IPC-D-356 Netlist output file.
Parameter @code{<string>} can include a path.
@end ftable
@c options gsvit Options
@node gsvit Options
@section gsvit Options
@c ./../src/hid/gsvit/gsvit.c 227
@ftable @code
@item -- basename <string>
File name prefix.
@end ftable
@c ./../src/hid/gsvit/gsvit.c 233
@ftable @code
@item --dpi <num>
Horizontal scale factor (grid points/inch).
@end ftable
@c options lpr Printing Options
@node lpr Printing Options
@section lpr Printing Options
@c ./../src/hid/lpr/lpr.c 31
@ftable @code
@item --lprcommand <string>
Command to use for printing. Defaults to @code{lpr}. This can be used to produce
PDF output with a virtual PDF printer. Example: @*
@code{--lprcommand "lp -d CUPS-PDF-Printer"}.
@end ftable
@noindent In addition, all @ref{Postscript Export} options are valid.
