4. Command-Line Options
There are several resources which may be set or reset in addition to the
standard toolkit command-line options. For a complete list refer to
5.1 Non-Standard X11 Application Resources.
The synopsis is:
pcb [-option ...] [-toolkit_option ...] [layout-file]
or
pcb -specialoption
4.1 Options
- `-alldirections/+alldirections'
- Disables or enables line clipping to 45 degree angles. Overwrites the
resource allDirectionLines.
- `-backup value'
- Time between two backups in seconds. Passing zero disables the backup feature.
Overwrites the resource backupInterval.
- `-c value'
- Number of characters per output line. The resource charactersPerLine is
overwritten.
- `-fontfile filename'
- The default set of symbols (font) for a new layout is read from this file.
All directories as defined by the resource fontPath are scanned
for the file. The scan is only performed if the filename doesn't contain
a directory component. The fontFile resource is changed.
- `-lelement command-line'
- Sets the command to be executed when an element is loaded from a file to the
paste buffer. The command may contain %f and %p to pass the requested filename
and the searchpath to the command. It must write the data to its
standard output. The related resource is elementCommand.
- `-lfile command-line'
- Sets the command to be executed when a new layout is loaded from a file.
The command may contain %f and %p to pass the requested filename
and the searchpath to the command. It must write the data to its
standard output. The related resource is fileCommand.
- `-lfont command-line'
- Sets the command to be executed when a font is loaded from a file.
The command may contain %f and %p to pass the requested filename
and the searchpath to the command. It must write the data to its
standard output. The related resource is fontCommand.
- `-lg layergroups'
- This option overwrites the resource layerGroups. See its description
for more information. The value is used for new layouts only.
- `-libname filename'
- The default filename for the library. Overwrites the resource
libraryFilename.
- `-libpath path'
- The default search path for the the library. Overwrites the resource
libraryPath.
- `-llib command-line'
- Sets the command to be executed when an element is loaded from the library.
The command may contain %f and %p to pass the requested filename
and the searchpath to the command. %a is replaces by the three arguments
template, value and package. The command must write
the data to its standard output. The related resource is libraryCommand.
- `-llibcont command-line'
- The command lists the contents of the library.
The command may contain %f and %p to pass the library filename
and the searchpath to the command. Also refer to 6.7 Library File Format
and 6.6 Library Contents File Format.
The related resource is libraryContentsCommand.
- `-loggeometry geometry'
- Determines the geometry of the log window.
- `-pnl value'
- Restricts the displayed length of the name of a pin in the pinout window to
the passed value. See also, the resource pinoutNameLength.
- `-pz value'
- Sets the zoom factor for the pinout window according to the formula:
scale = 1:(2 power value). The related resource is pinoutZoom.
- `-reset/+reset'
- If enabled, all connections are reset after each element is scanned.
This feature is only used while scanning connections to all elements.
See also, resetAfterElement.
- `-ring/+ring'
- Overrides the resource ringBellWhenFinished. If enabled, the bell
sounds when connection searching has finished.
- `-rs string'
- Overrides the resource routeStyle. The string defines a colon
separated list of route styles. The route styles consist of a
comma separated list of name, line thickness, via diameter, and via drill size.
e.g. "Fat,50,100,40:Skinny,8,35,20:75Ohm,110,110,20"
- `-s/+s'
- Enables/Disables the saving of the previous commandline. Overrides the
saveLastCommand resource.
- `-save/+save'
- See the resource description of saveInTMP for details.
- `-sfile command-line'
- Sets the command to be executed when an layout file is saved.
The command may contain %f which is replaced by the filename. The command
must read its data from the standard input.
The resource saveCommand is overwritten.
- `-size <width>x<height>'
- Overrides the resource size which determines the maximum size
of a layout.
- `-v value'
- Sets the volume of the X speaker. The value is passed to
XBell()
and
must be in the range -100..100.
4.2 Special Options
There are some special options available in addition to normal command line
options. Each of these must be the only option specified on a command line.
The available special options are:
- `-copyright'
- Prints out the copyright notice and terminates.
- `-version'
- Prints out the version ID and terminates.
- `-help'
- Prints out the usage message and terminates.
This document was generated
by Build Daemon user on August, 20 2004
using texi2html