gaf: Fix memory leak
[geda-gaf.git] / docs / wiki / geda-pcb-quick_reference.html
blob8757c38cc1c3a944330514bd0a323f46cf155bf5
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
6 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
7 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
10 </head>
11 <body>
13 <p>
14 <em>Translations of this page are also available in the following languages:</em> <a href="geda-pcb-quick_reference.fr.html" class="wikilink1" title="geda-pcb-quick_reference.fr.html">Français</a>, <a href="geda-pcb-quick_reference.ru.html" class="wikilink1" title="geda-pcb-quick_reference.ru.html">Русский</a>.
15 </p>
17 <h1 id="pcbquickreference">PCB: Quick Reference</h1>
18 <div class="level1">
20 </div>
22 <h2 id="additionalinformation">Additional information</h2>
23 <div class="level2">
25 <p>
26 More information on PCB you can find in the PCB Command reference
27 (<em><code>refcard.pdf</code></em>) containing description of all PCB shortcuts
28 and in the PCB Manual (<em><code>pcb.pdf</code></em> or <em><code>pcb.html</code></em>)
29 residing in the <em><code>doc/</code></em> directory of your PCB installation
30 (its path may vary on various systems).
31 </p>
33 </div>
35 <h2 id="defaultkeymapping">Default Key Mapping</h2>
36 <div class="level2">
38 </div>
40 <h3 id="allkeystrokes">All Keystrokes</h3>
41 <div class="level3">
42 <div class="table sectionedit1"><table class="inline">
43 <thead>
44 <tr class="row0">
45 <th class="col0 centeralign"> Key </th><th class="col1 leftalign"> Mnemonic </th><th class="col2 leftalign"> Description </th>
46 </tr>
47 </thead>
48 <tr class="row1">
49 <td class="col0 rightalign"> <kbd>Esc</kbd> </td><td class="col1 leftalign"> select </td><td class="col2 leftalign"> enter select mode (same as <kbd>Space</kbd>, or <kbd>F11</kbd>) </td>
50 </tr>
51 <tr class="row2">
52 <td class="col0 rightalign"> <kbd>Esc</kbd> </td><td class="col1 leftalign"> end of action </td><td class="col2 leftalign"> terminate the current action, e.g. stop drawing tracks </td>
53 </tr>
54 <tr class="row3">
55 <td class="col0 rightalign"> <kbd>Insert</kbd> </td><td class="col1 leftalign"> insert point </td><td class="col2 leftalign"> enter insert point mode. Click and drag on track to insert a point </td>
56 </tr>
57 <tr class="row4">
58 <td class="col0 rightalign"> <kbd>Return</kbd> </td><td class="col1 leftalign"> click </td><td class="col2 leftalign"> same as a click on the left mouse button </td>
59 </tr>
60 <tr class="row5">
61 <td class="col0 rightalign"> <kbd>Space</kbd> </td><td class="col1 leftalign"> select </td><td class="col2 leftalign"> enter select mode (same as <kbd>Esc</kbd>, or <kbd>F11</kbd>) </td>
62 </tr>
63 <tr class="row6">
64 <td class="col0 rightalign"> <kbd>Tab</kbd> </td><td class="col1 leftalign"> flip up/down </td><td class="col2 leftalign"> view: vertical flip </td>
65 </tr>
66 <tr class="row7">
67 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Tab</kbd> </td><td class="col1 leftalign"> flip left/right </td><td class="col2 leftalign"> view: horizontal flip </td>
68 </tr>
69 <tr class="row8">
70 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> </td><td class="col1 leftalign"> far side </td><td class="col2 leftalign"> view: exchange the roles of front side and far side </td>
71 </tr>
72 <tr class="row9">
73 <td class="col0 rightalign"> <kbd>Del</kbd> </td><td class="col1 leftalign"> delete </td><td class="col2"> delete object under the mouse cursor </td>
74 </tr>
75 <tr class="row10">
76 <td class="col0"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd> L-Mouse </td><td class="col1 leftalign"> delete </td><td class="col2"> delete object under the mouse cursor (fast) </td>
77 </tr>
78 <tr class="row11">
79 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Del</kbd> </td><td class="col1 leftalign"> del-sel </td><td class="col2"> delete objects in selection </td>
80 </tr>
81 <tr class="row12">
82 <td class="col0 rightalign"> <kbd>Backspace</kbd> </td><td class="col1 leftalign"> del-sel </td><td class="col2"> delete objects in selection </td>
83 </tr>
84 <tr class="row13">
85 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Backspace</kbd> </td><td class="col1 leftalign"> del-copper </td><td class="col2 leftalign"> deletes connected copper under the cursor. Rats are considered a connection. </td>
86 </tr>
87 <tr class="row14">
88 <td class="col0 rightalign"> <kbd>|</kbd> </td><td class="col1 leftalign"> thin-draw </td><td class="col2 leftalign"> toggles thin draw mode </td>
89 </tr>
90 <tr class="row15">
91 <td class="col0 rightalign"> <kbd>A</kbd> </td><td class="col1 leftalign"> set same </td><td class="col2 leftalign"> read the parameters to use for new objects from the object below the cursor. </td>
92 </tr>
93 <tr class="row16">
94 <td class="col0 rightalign"> <kbd>Alt</kbd>+<kbd>A</kbd> </td><td class="col1 leftalign"> select-all </td><td class="col2 leftalign"> select all objects on active layers. Deactivated layers are ignored. </td>
95 </tr>
96 <tr class="row17">
97 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> </td><td class="col1 leftalign"> unselect </td><td class="col2 leftalign"> clear selection </td>
98 </tr>
99 <tr class="row18">
100 <td class="col0 rightalign"> <kbd>B</kbd> </td><td class="col1 leftalign"> to other side </td><td class="col2 leftalign"> flip object to the other side of the board </td>
101 </tr>
102 <tr class="row19">
103 <td class="col0 rightalign"> <kbd>C</kbd> </td><td class="col1 leftalign"> center </td><td class="col2 leftalign"> view: center display at cursor position </td>
104 </tr>
105 <tr class="row20">
106 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>C</kbd> </td><td class="col1 leftalign"> copy to buffer </td><td class="col2 leftalign"> copy selection to buffer and unselect </td>
107 </tr>
108 <tr class="row21">
109 <td class="col0 rightalign"> <kbd>D</kbd> </td><td class="col1 leftalign"> display name </td><td class="col2 leftalign"> display pin or pad name </td>
110 </tr>
111 <tr class="row22">
112 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>D</kbd> </td><td class="col1 leftalign"> pinout dialog </td><td class="col2 leftalign"> open pinout window for element under mouse cursor </td>
113 </tr>
114 <tr class="row23">
115 <td class="col0 rightalign"> <kbd>E</kbd> </td><td class="col1 leftalign"> eliminate rats </td><td class="col2 leftalign"> delete all rats </td>
116 </tr>
117 <tr class="row24">
118 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>E</kbd> </td><td class="col1"> eliminate some rats</td><td class="col2 leftalign"> delete selected rats </td>
119 </tr>
120 <tr class="row25">
121 <td class="col0 rightalign"> <kbd>F</kbd> </td><td class="col1 leftalign"> find </td><td class="col2 leftalign"> highlight connections to object under mouse cursor. This includes rats and objects on invisible layers </td>
122 </tr>
123 <tr class="row26">
124 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>F</kbd> </td><td class="col1 leftalign"> add to found </td><td class="col2 leftalign"> add connections to object under mouse cursor to the set of found objects </td>
125 </tr>
126 <tr class="row27">
127 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>F</kbd> </td><td class="col1 leftalign"> un-find </td><td class="col2 leftalign"> un-highlight found connections </td>
128 </tr>
129 <tr class="row28">
130 <td class="col0 rightalign"> <kbd>G</kbd> </td><td class="col1 leftalign"> incr grid mil </td><td class="col2 leftalign"> increment grid by configured imperial increment </td>
131 </tr>
132 <tr class="row29">
133 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>G</kbd> </td><td class="col1 leftalign"> decr grid mil </td><td class="col2 leftalign"> decrement grid by configured imperial increment </td>
134 </tr>
135 <tr class="row30">
136 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>G</kbd> </td><td class="col1 leftalign"> incr grid mm </td><td class="col2 leftalign"> increment grid by configured metric increment </td>
137 </tr>
138 <tr class="row31">
139 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> </td><td class="col1 leftalign"> decr grid mm </td><td class="col2 leftalign"> decrement grid by configured metric increment </td>
140 </tr>
141 <tr class="row32">
142 <td class="col0 rightalign"> <kbd>H</kbd> </td><td class="col1 leftalign"> hide </td><td class="col2"> toggle the visibility of the refdes or value attached to the component under the cursor </td>
143 </tr>
144 <tr class="row33">
145 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>H</kbd> </td><td class="col1 leftalign"> hide sel </td><td class="col2 leftalign"> toggle the visibility of the refdes or value attached to selected components </td>
146 </tr>
147 <tr class="row34">
148 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>H</kbd> </td><td class="col1 leftalign"> holeplate </td><td class="col2 leftalign"> toggle plating of a via. Used to produce non metalized mounting holes </td>
149 </tr>
150 <tr class="row35">
151 <td class="col0 rightalign"> <kbd>J</kbd> </td><td class="col1 leftalign"> lineclear </td><td class="col2 leftalign"> toggle the polygon clear flag of the line under the cursor </td>
152 </tr>
153 <tr class="row36">
154 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>J</kbd> </td><td class="col1 leftalign"> lineclear sel </td><td class="col2 leftalign"> toggle the polygon clear flag of selected lines </td>
155 </tr>
156 <tr class="row37">
157 <td class="col0 rightalign"> <kbd>K</kbd> </td><td class="col1 leftalign"> klear </td><td class="col2 leftalign"> increment clearance (soldermask to copper edge) </td>
158 </tr>
159 <tr class="row38">
160 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>K</kbd> </td><td class="col1 leftalign"> klear (-) </td><td class="col2 leftalign"> decrement clearance (soldermask to copper edge (NOTE: can go negative!)) </td>
161 </tr>
162 <tr class="row39">
163 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>K</kbd> </td><td class="col1 leftalign"> klear sel </td><td class="col2 leftalign"> increment clearance of selected objects (soldermask to copper edge) </td>
164 </tr>
165 <tr class="row40">
166 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Ctrl</kbd>+<kbd>K</kbd> </td><td class="col1 leftalign"> klear sel (-) </td><td class="col2 leftalign"> decrement clearance of selected objects (soldermask to copper edge) </td>
167 </tr>
168 <tr class="row41">
169 <td class="col0 rightalign"> <kbd>L</kbd> </td><td class="col1 leftalign"> increase line </td><td class="col2 leftalign"> increment width of the line tool, adds to the settings of the current line style </td>
170 </tr>
171 <tr class="row42">
172 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>L</kbd> </td><td class="col1 leftalign"> decrease line </td><td class="col2"> reduce the current linewidth </td>
173 </tr>
174 <tr class="row43">
175 <td class="col0 rightalign"> <kbd>M</kbd> </td><td class="col1 leftalign"> move to layer </td><td class="col2 leftalign"> move the object under the cursor to the current layer </td>
176 </tr>
177 <tr class="row44">
178 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>M</kbd> </td><td class="col1"> move selection to layer </td><td class="col2 leftalign"> move selected objects to the current working layer (see <a href="geda-pcb_tips.html#how_do_i_move_one_set_of_layer_tracks_to_another_layer" class="wikilink1" title="geda-pcb_tips.html">pcb tip</a>) </td>
179 </tr>
180 <tr class="row45">
181 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>M</kbd> </td><td class="col1 leftalign"> move origin </td><td class="col2"> set the origin to the current position of the mouse pointer </td>
182 </tr>
183 <tr class="row46">
184 <td class="col0 rightalign"> <kbd>N</kbd> </td><td class="col1 leftalign"> name </td><td class="col2"> show object refdes / pin number at mouse pointer </td>
185 </tr>
186 <tr class="row47">
187 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>N</kbd> </td><td class="col1 leftalign"> next </td><td class="col2"> Select the shortest unselected rat on the board </td>
188 </tr>
189 <tr class="row48">
190 <td class="col0 rightalign"> <kbd>O</kbd> </td><td class="col1 leftalign"> optimize rats </td><td class="col2"> optimize and redraw all rats </td>
191 </tr>
192 <tr class="row49">
193 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>O</kbd> </td><td class="col1"> optimize some rats </td><td class="col2"> optimize and redraw selected nets only </td>
194 </tr>
195 <tr class="row50">
196 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>O</kbd> </td><td class="col1 leftalign"> octagon </td><td class="col2 leftalign"> toggle the octagon flag of the object under the cursor </td>
197 </tr>
198 <tr class="row51">
199 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>P</kbd> </td><td class="col1 leftalign"> polygon close </td><td class="col2 leftalign"> connect the first point of a polygon with the last </td>
200 </tr>
201 <tr class="row52">
202 <td class="col0 rightalign"> <kbd>Q</kbd> </td><td class="col1 leftalign"> square toggle </td><td class="col2 leftalign"> toggle square/round corners on pads </td>
203 </tr>
204 <tr class="row53">
205 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>R</kbd> </td><td class="col1 leftalign"> redo </td><td class="col2 leftalign"> redo what was undone with undo </td>
206 </tr>
207 <tr class="row54">
208 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>R</kbd> </td><td class="col1 leftalign"> report </td><td class="col2 leftalign"> show object report </td>
209 </tr>
210 <tr class="row55">
211 <td class="col0 rightalign"> <kbd>S</kbd> </td><td class="col1 leftalign"> size </td><td class="col2 leftalign"> increment size of the object under the cursor </td>
212 </tr>
213 <tr class="row56">
214 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>S</kbd> </td><td class="col1 leftalign"> size (-) </td><td class="col2 leftalign"> decrement size of the object under the cursor </td>
215 </tr>
216 <tr class="row57">
217 <td class="col0 rightalign"> <kbd>Alt</kbd>+<kbd>S</kbd> </td><td class="col1 leftalign"> sizehole </td><td class="col2 leftalign"> increase the hole of the object under the cursor </td>
218 </tr>
219 <tr class="row58">
220 <td class="col0 rightalign"> <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> </td><td class="col1 leftalign"> sizehole (-) </td><td class="col2 leftalign"> decrease the hole of the object under the cursor </td>
221 </tr>
222 <tr class="row59">
223 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>S</kbd> </td><td class="col1 leftalign"> sizehole </td><td class="col2 leftalign"> increase the hole of the object under the cursor </td>
224 </tr>
225 <tr class="row60">
226 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> </td><td class="col1 leftalign"> sizehole (-) </td><td class="col2 leftalign"> decrease the hole size </td>
227 </tr>
228 <tr class="row61">
229 <td class="col0 rightalign"> <kbd>T</kbd> </td><td class="col1 leftalign"> text tool size </td><td class="col2 leftalign"> increase the size of new text by 10 mil </td>
230 </tr>
231 <tr class="row62">
232 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>T</kbd> </td><td class="col1"> text tool size (-) </td><td class="col2 leftalign"> decrease the size of new text by 10 mil </td>
233 </tr>
234 <tr class="row63">
235 <td class="col0 rightalign"> <kbd>V</kbd> </td><td class="col1 leftalign"> view extents </td><td class="col2 leftalign"> global view of working area </td>
236 </tr>
237 <tr class="row64">
238 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>V</kbd> </td><td class="col1 leftalign"> via tool dia </td><td class="col2 leftalign"> increase the diameter of new vias by 5 mil </td>
239 </tr>
240 <tr class="row65">
241 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>V</kbd> </td><td class="col1 leftalign"> paste buffer </td><td class="col2"> paste from buffer </td>
242 </tr>
243 <tr class="row66">
244 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd> </td><td class="col1 leftalign"> via tool dia (-) </td><td class="col2 leftalign"> decrease the diameter of new vias by 5 mil </td>
245 </tr>
246 <tr class="row67">
247 <td class="col0 rightalign"> <kbd>Alt</kbd>+<kbd>V</kbd> </td><td class="col1 leftalign"> via tool drill </td><td class="col2 leftalign"> increase the drill diameter of new vias by 5 mil </td>
248 </tr>
249 <tr class="row68">
250 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>V</kbd> </td><td class="col1"> via tool drill (-) </td><td class="col2 leftalign"> decrease the drill diameter of new vias by 5 mil </td>
251 </tr>
252 <tr class="row69">
253 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>X</kbd> </td><td class="col1 leftalign"> cut to buffer </td><td class="col2"> cut selection to buffer </td>
254 </tr>
255 <tr class="row70">
256 <td class="col0 rightalign"> <kbd>Z</kbd> </td><td class="col1 leftalign"> zoom </td><td class="col2 leftalign"> view: zoom in </td>
257 </tr>
258 <tr class="row71">
259 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Z</kbd> </td><td class="col1 leftalign"> un-zoom </td><td class="col2 leftalign"> view: zoom out </td>
260 </tr>
261 <tr class="row72">
262 <td class="col0 rightalign"> <kbd>F1</kbd> </td><td class="col1 leftalign"> via </td><td class="col2"> enter via tool </td>
263 </tr>
264 <tr class="row73">
265 <td class="col0 rightalign"> <kbd>F2</kbd> </td><td class="col1 leftalign"> line </td><td class="col2 leftalign"> enter line tool </td>
266 </tr>
267 <tr class="row74">
268 <td class="col0 rightalign"> <kbd>F3</kbd> </td><td class="col1 leftalign"> arc </td><td class="col2"> enter arc tool </td>
269 </tr>
270 <tr class="row75">
271 <td class="col0 rightalign"> <kbd>F4</kbd> </td><td class="col1 leftalign"> text </td><td class="col2"> enter text tool </td>
272 </tr>
273 <tr class="row76">
274 <td class="col0 rightalign"> <kbd>F5</kbd> </td><td class="col1 leftalign"> rectangle </td><td class="col2"> enter rectangle tool</td>
275 </tr>
276 <tr class="row77">
277 <td class="col0 rightalign"> <kbd>F6</kbd> </td><td class="col1 leftalign"> polygon </td><td class="col2"> enter polygon tool </td>
278 </tr>
279 <tr class="row78">
280 <td class="col0 rightalign"> <kbd>F7</kbd> </td><td class="col1 leftalign"> buffer </td><td class="col2"> enter buffer mode </td>
281 </tr>
282 <tr class="row79">
283 <td class="col0 rightalign"> <kbd>F8</kbd> </td><td class="col1 leftalign"> delete </td><td class="col2"> enter remove mode </td>
284 </tr>
285 <tr class="row80">
286 <td class="col0 rightalign"> <kbd>F9</kbd> </td><td class="col1 leftalign"> rotate </td><td class="col2 leftalign"> enter rotate mode </td>
287 </tr>
288 <tr class="row81">
289 <td class="col0 rightalign"> <kbd>F10</kbd> </td><td class="col1 leftalign"> file menu </td><td class="col2"> file menu </td>
290 </tr>
291 <tr class="row82">
292 <td class="col0 rightalign"> <kbd>F11</kbd> </td><td class="col1 leftalign"> select </td><td class="col2 leftalign"> enter select mode (same as <kbd>Space</kbd>, or <kbd>Esc</kbd>) </td>
293 </tr>
294 <tr class="row83">
295 <td class="col0 rightalign"> <kbd>F12</kbd> </td><td class="col1 leftalign"> lock </td><td class="col2"> enter lock mode </td>
296 </tr>
297 </table></div>
298 <!-- EDIT1 TABLE [588-8546] -->
299 </div>
301 <h3 id="viewportkeystrokes">Viewport Keystrokes</h3>
302 <div class="level3">
303 <div class="table sectionedit2"><table class="inline">
304 <thead>
305 <tr class="row0">
306 <th class="col0 centeralign"> Key </th><th class="col1 centeralign"> Mnemonic </th><th class="col2 leftalign"> Description </th>
307 </tr>
308 </thead>
309 <tr class="row1">
310 <td class="col0 rightalign"> <kbd>V</kbd> </td><td class="col1 leftalign"> view extents </td><td class="col2 leftalign"> global view of working area </td>
311 </tr>
312 <tr class="row2">
313 <td class="col0 rightalign"> <kbd>C</kbd> </td><td class="col1 leftalign"> center </td><td class="col2 leftalign"> centers view on cursor </td>
314 </tr>
315 <tr class="row3">
316 <td class="col0 rightalign"> <kbd>Z</kbd> </td><td class="col1 leftalign"> zoom </td><td class="col2 leftalign"> zoom in </td>
317 </tr>
318 <tr class="row4">
319 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Z</kbd> </td><td class="col1 leftalign"> un-zoom </td><td class="col2 leftalign"> zoom out </td>
320 </tr>
321 <tr class="row5">
322 <td class="col0 rightalign"> <kbd>|</kbd> </td><td class="col1"> thin-draw </td><td class="col2 leftalign"> toggles thin draw mode </td>
323 </tr>
324 <tr class="row6">
325 <td class="col0 rightalign"> <kbd>Tab</kbd> </td><td class="col1 leftalign"> flip up/down </td><td class="col2 leftalign"> vertical flip </td>
326 </tr>
327 <tr class="row7">
328 <td class="col0 rightalign"> <kbd>Shift</kbd>+<kbd>Tab</kbd> </td><td class="col1 leftalign"> flip left/right </td><td class="col2 leftalign"> horizontal flip </td>
329 </tr>
330 <tr class="row8">
331 <td class="col0 rightalign"> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> </td><td class="col1 leftalign"> far side </td><td class="col2 leftalign"> exchange the roles of front and far side </td>
332 </tr>
333 </table></div>
334 <!-- EDIT2 TABLE [8579-9211] -->
335 </div>
337 <h3 id="layers">Layers</h3>
338 <div class="level3">
339 <div class="table sectionedit3"><table class="inline">
340 <thead>
341 <tr class="row0">
342 <th class="col0 centeralign"> Key </th><th class="col1 centeralign"> Mnemonic </th><th class="col2 leftalign"> Description </th>
343 </tr>
344 </thead>
345 <tr class="row1">
346 <td class="col0 centeralign"> <kbd>1</kbd> to <kbd>9</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> select layers 1 to 9 </td>
347 </tr>
348 <tr class="row2">
349 <td class="col0 centeralign"> <kbd>0</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> select layer 10<sup>*</sup> </td>
350 </tr>
351 <tr class="row3">
352 <td class="col0 centeralign"> <kbd>Alt</kbd>+<kbd>1</kbd> to <kbd>Alt</kbd>+<kbd>9</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> select layers 11 to 19<sup>*</sup> </td>
353 </tr>
354 <tr class="row4">
355 <td class="col0 centeralign"> <kbd>Alt</kbd>+<kbd>0</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> select layer 20<sup>*</sup> </td>
356 </tr>
357 <tr class="row5">
358 <td class="col0 centeralign"> <kbd>Ctrl</kbd>+<kbd>1</kbd> to <kbd>Ctrl</kbd>+<kbd>9</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> toggle visibility of layers 1 to 9<sup>*</sup> </td>
359 </tr>
360 <tr class="row6">
361 <td class="col0 centeralign"> <kbd>Ctrl</kbd>+<kbd>0</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> toggle visibility of layer 10<sup>*</sup> </td>
362 </tr>
363 <tr class="row7">
364 <td class="col0 centeralign"> <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>1</kbd> to <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>9</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> toggle visibility of 11 to 19<sup>*</sup> </td>
365 </tr>
366 <tr class="row8">
367 <td class="col0 centeralign"> <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>0</kbd> </td><td class="col1 centeralign"> - </td><td class="col2 leftalign"> toggle visibility of 20<sup>*</sup> </td>
368 </tr>
369 </table></div>
370 <!-- EDIT3 TABLE [9230-9995] -->
372 <sup>*</sup> <sub>These accels are available in PCB, GTK GUI in versions after August 2011</sub>
373 </p>
375 </div>
377 <h1 id="footprintquickreference">Footprint Quick Reference</h1>
378 <div class="level1">
381 The Master document for footprint creation is the PCB Manual. There is also Stuart Brorson’s Footprint Creation for the Open-Source Layout Program PCB.
382 </p>
384 </div>
386 <h2 id="generalsyntax">General syntax</h2>
387 <div class="level2">
390 A pcb footprint file may contain any of the following commands:
391 </p>
392 <ul>
393 <li class="level1"><div class="li"> <strong><code>Element [element_flags, description, pcb_name, value, mark_x, mark_y, text_x, text_y, text_direction, text_scale, text_flags]</code></strong></div>
394 </li>
395 <li class="level1"><div class="li"> <strong><code>Pad [x1 y1 x2 y2 thickness clearance mask name pad_number flags]</code></strong></div>
396 </li>
397 <li class="level1"><div class="li"> <strong><code>Pin [x y thickness clearance mask drillholedia name number flags]</code></strong></div>
398 </li>
399 <li class="level1"><div class="li"> <strong><code>ElementArc [x y r1 r2 startangle sweepangle thickness]</code></strong></div>
400 </li>
401 <li class="level1"><div class="li"> <strong><code>ElementLine [x1 y1 x2 y2 thickness] –&gt; thickness != 1000 = 10 mils almost for all footprints</code></strong></div>
402 </li>
403 <li class="level1"><div class="li"> Comment lines start with the ‘<strong><code>#</code></strong>’-sign</div>
404 </li>
405 </ul>
407 </div>
409 <h2 id="pcbunits">PCB Units</h2>
410 <div class="level2">
413 PCB handles metric and imperial units in the following way:
414 </p>
415 <ul>
416 <li class="level1"><div class="li"> The base Imperial unit is the &quot;centimil&quot;, or 1/100 of a thousandth, or 1/100,000 inch, or 0.00001 inch.</div>
417 </li>
418 <li class="level3"><div class="li"> Allowable imperial value range: &quot;0.04&quot; (0.0000004 inches) to approx. &quot;78740000&quot; (about 78-3/4&quot;)</div>
419 </li>
420 <li class="level3"><div class="li"> The base Metric unit is 1nm (one nanometer). PCB parses in metric if the number has a &quot;mm&quot; behind it.</div>
421 </li>
422 <li class="level3"><div class="li"> Allowable metric value range: &quot;0.000001mm&quot; to &quot;2000mm&quot;</div>
423 </li>
424 <li class="level3 node"><div class="li"> NOTES:</div>
425 <ul>
426 <li class="level4"><div class="li"> use &quot;mm&quot; after number to specify metric</div>
427 </li>
428 <li class="level4"><div class="li"> imperial and metric may be mixed within a footprint (!)</div>
429 </li>
430 </ul>
431 </li>
432 </ul>
434 </div>
436 <h2 id="elements">Elements</h2>
437 <div class="level2">
440 <strong><code>Element [element_flags, description, pcb_name, value, mark_x, mark_y, text_x, text_y, text_direction, text_scale, text_flags]</code></strong>
441 </p>
442 <div class="table sectionedit4"><table class="inline">
443 <thead>
444 <tr class="row0">
445 <th class="col0 leftalign"> </th><th class="col1 rightalign"> Allowed value (unit = 1e-5 inches) </th><th class="col2 centeralign"> Allowed Value (mm) </th><th class="col3 centeralign"> explanation </th><th class="col4 centeralign"> comment </th>
446 </tr>
447 </thead>
448 <tr class="row1">
449 <td class="col0 centeralign"> element_flags </td><td class="col1 centeralign"> unsigned hex value </td><td class="col2 leftalign"> </td><td class="col3 leftalign"> </td><td class="col4"></td>
450 </tr>
451 <tr class="row2">
452 <td class="col0 centeralign"> description </td><td class="col1 centeralign"> string </td><td class="col2 leftalign"> </td><td class="col3 centeralign"> text description of footprint </td><td class="col4 centeralign"> user-defined </td>
453 </tr>
454 <tr class="row3">
455 <td class="col0 centeralign"> pcb_name </td><td class="col1 centeralign"> string </td><td class="col2 leftalign"> </td><td class="col3 rightalign"> generic refdes (R?, U? etc.) </td><td class="col4 centeralign"> user-defined </td>
456 </tr>
457 <tr class="row4">
458 <td class="col0 centeralign"> value </td><td class="col1 centeralign"> string </td><td class="col2 leftalign"> </td><td class="col3 centeralign"> component value (layout specific) </td><td class="col4 centeralign"> user-defined (blank) </td>
459 </tr>
460 <tr class="row5">
461 <td class="col0 centeralign"> mark_x </td><td class="col1 centeralign"> &quot;1&quot; to ~ &quot;78740000&quot; </td><td class="col2 centeralign"> &quot;0.000001mm&quot; to &quot;2000mm&quot; </td><td class="col3 centeralign"> (x,y) loc. of center mark </td><td class="col4 leftalign"> </td>
462 </tr>
463 <tr class="row6">
464 <td class="col0 centeralign"> mark_y </td><td class="col1 centeralign"> &quot;1&quot; to ~ &quot;78740000&quot; </td><td class="col2 centeralign"> &quot;0.000001mm&quot; to &quot;2000mm&quot; </td><td class="col3 leftalign"> </td><td class="col4 leftalign"> </td>
465 </tr>
466 <tr class="row7">
467 <td class="col0 centeralign"> text_x </td><td class="col1 centeralign"> &quot;1&quot; to ~ &quot;78740000&quot; </td><td class="col2 centeralign"> &quot;0.000001mm&quot; to &quot;2000mm&quot; </td><td class="col3 centeralign"> (x,y) loc. of REFDES </td><td class="col4 leftalign"> </td>
468 </tr>
469 <tr class="row8">
470 <td class="col0 centeralign"> text_y </td><td class="col1 centeralign"> &quot;1&quot; to ~ &quot;78740000&quot; </td><td class="col2 centeralign"> &quot;0.000001mm&quot; to &quot;2000mm&quot; </td><td class="col3 leftalign"> </td><td class="col4 leftalign"> </td>
471 </tr>
472 <tr class="row9">
473 <td class="col0 centeralign"> text_direction </td><td class="col1 centeralign"> decimal integer </td><td class="col2 leftalign"> </td><td class="col3 centeralign"> 0=horiz; 1=ccw90; 2=180; 3=cw90 </td><td class="col4 leftalign"> </td>
474 </tr>
475 <tr class="row10">
476 <td class="col0 centeralign"> text_scale </td><td class="col1 centeralign"> decimal integer </td><td class="col2 leftalign"> </td><td class="col3 leftalign"> </td><td class="col4 centeralign"> usu. set to 100 </td>
477 </tr>
478 <tr class="row11">
479 <td class="col0 centeralign"> text_flags </td><td class="col1 centeralign"> unsigned hex </td><td class="col2 leftalign"> </td><td class="col3 leftalign"> </td><td class="col4 leftalign"> </td>
480 </tr>
481 </table></div>
482 <!-- EDIT4 TABLE [11773-12694] -->
483 </div>
485 <h2 id="pads">Pads</h2>
486 <div class="level2">
489 <strong><code>Pad[x1 y1 x2 y2 thickness clearance mask name pad_number flags]</code></strong>
490 </p>
491 <div class="table sectionedit5"><table class="inline">
492 <thead>
493 <tr class="row0">
494 <th class="col0 centeralign"> Item </th><th class="col1 centeralign"> Allowed Value </th><th class="col2 centeralign"> Explanation </th><th class="col3 centeralign"> Comment </th>
495 </tr>
496 </thead>
497 <tr class="row1">
498 <td class="col0 centeralign"> x1 </td><td class="col1 centeralign"> 1/100th mil </td><td class="col2 centeralign"> x (1st point) </td><td class="col3 leftalign"> </td>
499 </tr>
500 <tr class="row2">
501 <td class="col0 centeralign"> y1 </td><td class="col1 centeralign"> 1/100th mil </td><td class="col2 centeralign"> y (1st point) </td><td class="col3 leftalign"> </td>
502 </tr>
503 <tr class="row3">
504 <td class="col0 centeralign"> x2 </td><td class="col1 centeralign"> 1/100th mil </td><td class="col2 centeralign"> x (2nd point) </td><td class="col3 leftalign"> </td>
505 </tr>
506 <tr class="row4">
507 <td class="col0 centeralign"> y2 </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> y (2nd point) </td><td class="col3 leftalign"> </td>
508 </tr>
509 <tr class="row5">
510 <td class="col0 centeralign"> thickness </td><td class="col1 centeralign"> 1/100 mils </td><td class="col2 centeralign"> width of metal surrounding line segment </td><td class="col3 leftalign">see Brorson .pdf </td>
511 </tr>
512 <tr class="row6">
513 <td class="col0 centeralign"> clearance </td><td class="col1 centeralign"> 1/100 mils </td><td class="col2 centeralign"> distance to any other copper on any layer </td><td class="col3 leftalign">actually 1/2 of this number is used! </td>
514 </tr>
515 <tr class="row7">
516 <td class="col0 centeralign"> mask </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> width of mask relief </td><td class="col3 leftalign">actual width of the mask centered on pad copper </td>
517 </tr>
518 <tr class="row8">
519 <td class="col0 centeralign"> name </td><td class="col1 centeralign"> string </td><td class="col2 centeralign"> name of pad (arb. string) </td><td class="col3 leftalign">e.g. &quot;pad_1&quot; or &quot;positive&quot; or any other string </td>
520 </tr>
521 <tr class="row9">
522 <td class="col0 centeralign"> pad_number </td><td class="col1 centeralign"> string </td><td class="col2 centeralign"> pad # </td><td class="col3 leftalign"> used for nets. it MUST be consistent with the definitions on the netlist. </td>
523 </tr>
524 <tr class="row10">
525 <td class="col0 centeralign"> flags </td><td class="col1 centeralign"> hex or string </td><td class="col2 leftalign"> </td><td class="col3 leftalign"> examples: </td>
526 </tr>
527 </table></div>
528 <!-- EDIT5 TABLE [12786-13615] -->
529 </div>
531 <h2 id="pins">Pins</h2>
532 <div class="level2">
535 <strong><code>Pin[x y thickness clearance mask drillholedia name number flags]</code></strong>
536 </p>
537 <div class="table sectionedit6"><table class="inline">
538 <thead>
539 <tr class="row0">
540 <th class="col0 centeralign"> Item </th><th class="col1 leftalign"> Allowed Value </th><th class="col2 centeralign"> Explanation </th><th class="col3 centeralign"> Comment </th>
541 </tr>
542 </thead>
543 <tr class="row1">
544 <td class="col0 centeralign"> x </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> pin x coord. </td><td class="col3 leftalign"> </td>
545 </tr>
546 <tr class="row2">
547 <td class="col0 centeralign"> y </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> pin y coord. </td><td class="col3 leftalign"> </td>
548 </tr>
549 <tr class="row3">
550 <td class="col0 centeralign"> thickness </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> copper diameter </td><td class="col3 leftalign"> </td>
551 </tr>
552 <tr class="row4">
553 <td class="col0 centeralign"> clearance </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> 2*(cu to cu clearance) </td><td class="col3 leftalign">if you want a 10 mil clearance, put 2000 (20 mils) here </td>
554 </tr>
555 <tr class="row5">
556 <td class="col0 centeralign"> mask </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> diameter of mask aperture </td><td class="col3 leftalign">actual dia. of hole in mask </td>
557 </tr>
558 <tr class="row6">
559 <td class="col0 centeralign"> drillholedia </td><td class="col1 centeralign"> 1/100th mils </td><td class="col2 centeralign"> dia. of hole </td><td class="col3 leftalign"> </td>
560 </tr>
561 <tr class="row7">
562 <td class="col0 centeralign"> name </td><td class="col1 centeralign"> string </td><td class="col2 centeralign"> arb. pin name </td><td class="col3 leftalign"> </td>
563 </tr>
564 <tr class="row8">
565 <td class="col0 centeralign"> number </td><td class="col1 centeralign"> decimal integer </td><td class="col2 centeralign"> pin number used by nets/rats </td><td class="col3 leftalign"> </td>
566 </tr>
567 <tr class="row9">
568 <td class="col0 centeralign"> flags </td><td class="col1 centeralign"> hex </td><td class="col2 centeralign"> xxx </td><td class="col3 leftalign"> </td>
569 </tr>
570 </table></div>
571 <!-- EDIT6 TABLE [13708-14314] -->
572 </div>
574 <h2 id="examples">Examples</h2>
575 <div class="level2">
576 <ul>
577 <li class="level1"><div class="li"> <strong><code>Pad[-24606 14760 -19538 14760 1181 2000 3181 &quot;&quot; &quot;16&quot; &quot;square&quot;]</code></strong></div>
578 </li>
579 <li class="level1"><div class="li"> <strong><code>Pad[-14760 19538 -14760 24606 1181 2000 3181 &quot;&quot; &quot;17&quot; &quot;square,edge2&quot;]</code></strong></div>
580 </li>
581 <li class="level1"><div class="li"> <strong><code>Pad[-240.00mil 0.0000 -80.00mil 0.0000 40.00mil 20.00mil 46.00mil &quot;2&quot; &quot;2&quot; &quot;onsolder,square&quot;]</code></strong></div>
582 </li>
583 <li class="level1"><div class="li"> <strong><code>Pad[80.00mil 0.0000 240.00mil 0.0000 40.00mil 20.00mil 46.00mil &quot;1&quot; &quot;1&quot; &quot;onsolder,square,edge2&quot;]</code></strong></div>
584 </li>
585 <li class="level1"><div class="li"> <strong><code>Pin[0 0 12000 2000 12500 6400 &quot;&quot; &quot;1&quot; 0×00000001]</code></strong></div>
586 </li>
587 <li class="level1"><div class="li"> <strong><code>Pin[0 0 11500 11800 35000 12500 &quot;&quot; &quot;1&quot; 0x08]</code></strong> &lt;-- unplated / nonplated hole</div>
588 </li>
589 <li class="level1"><div class="li"> <strong><code>ElementArc [0 0 6800 6800 0 360 1000]</code></strong></div>
590 </li>
591 <li class="level1"><div class="li"> <strong><code>ElementLine [-26696 -26696 26696 -26696 1000]</code></strong></div>
592 </li>
593 <li class="level1"><div class="li"> <strong><code># notes within PCB Footprints go after the pound sign</code></strong></div>
594 </li>
595 </ul>
597 </div>
599 <h1 id="pcbcommandlineactionreferenceabridged">PCB Command Line Action Reference (abridged)</h1>
600 <div class="level1">
601 <div class="table sectionedit7"><table class="inline">
602 <tr class="row0">
603 <td class="col0" colspan="2">:FreeRotateBuffer(degrees)</td><td class="col2">Rotate buffer arbitrarily </td>
604 </tr>
605 <tr class="row1">
606 <td class="col0" colspan="2">:MoveObject(x,y,unit) </td><td class="col2">Move Absolute (x,y,mil) or Relative(+x,-y,mil)</td>
607 </tr>
608 <tr class="row2">
609 <td class="col0" colspan="2">:ChangeClearSize(Selected,&lt;amount&gt;,&lt;unit&gt;)</td><td class="col2"> Clearance Size</td>
610 </tr>
611 <tr class="row3">
612 <td class="col0" colspan="2">:ChangeSize(SelectedPins, SIZE)</td><td class="col2"> Pin Size </td>
613 </tr>
614 <tr class="row4">
615 <td class="col0" colspan="2">:ChangeSize(SelectedLines,+N,mils)</td><td class="col2"> Line Size </td>
616 </tr>
617 <tr class="row5">
618 <td class="col0" colspan="2">:MinClearGap(Selected,&lt;amount&gt;,&lt;unit&gt;)</td><td class="col2"> Clearance Gap </td>
619 </tr>
620 </table></div>
621 <!-- EDIT7 TABLE [15144-15489] --><ul>
622 <li class="level1"><div class="li"> units can be specified as mm or mil.</div>
623 </li>
624 <li class="level1"><div class="li"> Action Reference from the PCB Manual</div>
625 </li>
626 </ul>
628 </div>
630 <h1 id="pcbphysicallayerreference">PCB Physical Layer Reference</h1>
631 <div class="level1">
632 <ul>
633 <li class="level1"><div class="li"> outline layer reference</div>
634 </li>
635 <li class="level1"><div class="li"> physical layer how-to (outline, direct (x,y) footprint placement, part insertion)</div>
636 </li>
637 </ul>
639 </div>
640 </body>
641 </html>