[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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  Pcb command-line options.
4.2 Special Options  Version and copyright information.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Michael Banck on April, 16 2004 using texi2html