PCB(1) manual page

Name

Pcb - X11 interactive printed circuit board

layout system

Synopsis

pcb [-option ...] [-toolkit_option ...] [description file]

pcb -specialoption

Description

Pcb is a handy tool for the X Window System build to design printed circuit boards. All coordinate units are 1/1000 inch. It implements the most needed features like:

* A layout consists of lines, arcs, polygons, elements (lines, pins and arcs),: vias and text information seperated into several layers. Each of them is identified by a unique name and color (if supported by your display). SMD circuits are also supported.
* 8 layers are supported in addition to a silkscreen layer.: Visibility of pins and SMD pads and vias is controllable.
* All files are 7 bit ASCII and can be preprocessed with any UNIX command: that writes it's results to stdout (GNU m4 is required).
* The layout grid is anywhere in the range from 1/1000 inch up to 250/1000: inch. The maximum is defined at compilation time.
* Zooming is supported.
* A copy of the current data is saved temporarily in /tmp to: ensure that nothing is lost during critical sections of the program.
* An unlimited (depending on memory) undo operations: is supported. Also redo is available in case you change your made.

Pcb is intended to be a simple tool without memory and time consuming features like autorouter and autoplacement. It worked well for several people on an Atari platform till it was ported to X11 in 1994. Most of the settings can be specified by resources, passed in the command-line or changed at runtime. Layout related settings are saved together with the data.

Options

Beside the toolkit options, Pcb recognizes some command-line options with following syntax: -option switches it on,

+option switches it off

-alldirections,+alldirections

Enables or disables lines in any direction. Overrides the resource allDirectionLines.

-backup <value>

Time in seconds between two backups. Overrides the resource backupInterval.

-c <value>

Number of characters per output-line. Overrides the resource charactersPerLine.

-fontfile <filename>

The default font is read from this file. The file is, together with a path, passed to an external program. The path is defined by the resource fontPath wheras the command uses fontCommand. Overwrittes the resource fontFile.

-lelement <UNIX command>

Sets the command to be executed when an element is loaded. The command may contain %f which is replaced by the filename and %p which is replaced by the element search-path. The command must write it's results to stdout. The resource elementCommand is overwritten.

-lfile <UNIX command>

Sets the command to be executed when an layout file is loaded. The command may contain %f which is replaced by the filename and %p which is replaced by the search-path. The command must write it's results to stdout. The resource fileCommand is overwritten.

-lfont <UNIX command>

Sets the command to be executed when an fontfile is loaded. The command may contain %f which is replaced by the filename and %p which is replaced by the font search-path. The command must write it's results to stdout. The resource fontCommand is overwritten.

-lg <layergroups>

This option overwrites the resource layerGroups. See its description for more information.

-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 <UNIX command>

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 <UNIX command>

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. The related resource is libraryContentsCommand.

-loggeometry <geometry>

Determines the geometry of the logging window.

-pnl <positiv integer value>

Defines the maximum length of a pin name to be displayed in a pinout window. Overwrittes the resource pinoutNameLength.

-pz <positiv integer value>

Sets the zoom factor for pinout window according to the formula: scale = 1:(2^value). The resource pinoutZoom is overwritten.

-reset/+reset

If enabled, all found connections are reset after an element has been scanned. This setting is only used while scanning connections to all elements. Overrides the resource resetAfterElement.

-ring/+ring

Overrides the resource ringBellWhenFinished. If enabled, the bell on the keyboard is rang when connection searching has finished.

-s/+s

Enables/Disables the saving of the previous commandline. Overrides the saveLastCommand resource.

-save/+save

Overrides the resource saveInTMP. If enabled all data is saved in a temporary file in the directory /tmp instead of being lost.

-sfile <UNIX command>

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 it's data from stdin. The resource saveCommand is overwritten.

-size <width>x<height>

Overrides the resource size which determines the maximum size of a layout.

Sets the volume of the X-speaker. Overrides the resource volume.

In addition to these 'normal-work-options' you will find additional special options, -copyright, -help and -version, which print out the GNU COPYLEFT notice, a usage message and the current version.

Roland Merk (merk@faw.uni-ulm.de) for his help during the hard days of learning X11 programming.

Erland Unruh (Erland.Unruh@malmo.trab.se) for alpha and beta testing of the early releases.

Many, many others who donated some of their time for developing new circuit-files, did testing and came up with several bug-fixes and improvements. Thanks to all of them.

Table of Contents

Name
Version
Synopsis
Description
Options
X11 Interface
See Also
Copyright
Author
Acknowledgement