Updated and correct the gEDA/gaf man pages a little bit.
[geda-gaf.git] / docs / wiki / geda_gerbv_pnp_readme.html
blob8a72f5efeb487da02d26483d9e6a90fc4d3f743e
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
4 lang="en" dir="ltr">
5 <head>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <title>geda:gerbv_pnp_readme</title>
8 <meta name="generator" content="DokuWiki Release rc2007-05-24" />
9 <meta name="robots" content="index,follow" />
10 <meta name="date" content="2007-05-24T22:27:24-0400" />
11 <meta name="keywords" content="geda,gerbv_pnp_readme" />
12 <link rel="search" type="application/opensearchdescription+xml" href="http://geda.seul.org/wiki/lib/exe/opensearch.php" title="geda Wiki" />
13 <link rel="start" href="http://geda.seul.org/wiki/" />
14 <link rel="contents" href="http://geda.seul.org/wiki/geda:gerbv_pnp_readme?do=index" title="Index" />
15 <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://geda.seul.org/wiki/feed.php" />
16 <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://geda.seul.org/wiki/feed.php?mode=list&ns=geda" />
17 <link rel="alternate" type="text/html" title="Plain HTML" href="http://geda.seul.org/wiki/_export/xhtml/geda:gerbv_pnp_readme" />
18 <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://geda.seul.org/wiki/_export/raw/geda:gerbv_pnp_readme" />
19 <link rel="stylesheet" media="all" type="text/css" href="lib/exe/css" />
20 <link rel="stylesheet" media="screen" type="text/css" href="lib/exe/001css" />
21 <link rel="stylesheet" media="print" type="text/css" href="lib/exe/002css" />
22 </head>
23 <body>
24 <div class="dokuwiki export">
28 <h1><a name="searching_for_parts_and_marking_them_on_screen_in_gerbv" id="searching_for_parts_and_marking_them_on_screen_in_gerbv">Searching for Parts and marking them on screen (in gerbv)</a></h1>
29 <div class="level1">
30 <pre class="code">Searching for Parts and marking them on screen (in gerbv)
32 THIS FUNCTIONALITY IS ONLY AVAILABLE WHEN COMPILING GERBV AGAINST GTK2!
34 Please direct any comments, suggestions etc. to Juergen &lt;juergenhaas@gmx.net&gt;
35 =============================================================================
36 *** Support for Pick and Place files: ***
37 *** csv-style files with/without quotes ***
38 *** the following delimiters are supported &#039;;&#039; &#039;:&#039; &#039;|&#039; &#039;,&#039; ***
39 ----------------------------------------------------------------------------
42 ----------------------------------------------------------------------------
43 A pick and place file has 11 columns (the first two lines a file in gerbv/examplei
44 are shown here) and looks like this:
46 Designator:Footprint:Mid X:Mid Y:Ref X:Ref Y:Pad X:Pad Y:Layer:Rotation:Comment
48 R29:0805_REFL:25.4mm:72.644mm:25.4mm:72.644mm:25.4mm:71.6788mm:T:90.00:1K/1%
49 ----------------------------------------------------------------------------
51 Some instructions for the first time user:
53 after loading a PNP file a new dialog will come up offering various option of
54 selecting and graphically marking electronic parts.
56 Three modes of selecting items do exist:
57 1)enter any search phrase and hit enter
58 (See also paragraph &quot;SCROLLING&quot; further down)
59 -Generally under linux regexp expressions are used such as &quot;.*&quot; i.e. &#039;*&#039;
60 -All matches will be marked in the list AND on the screen
61 -if you press ESC or press &lt;ENTER&gt; on an empty line it will deselect all
62 items
63 -if you had a selection already and you would like to add single items
64 one by one, just hold down CTRL key while you left-click on the desired
65 fields
67 2)just simply use left click combined with Shift and/or CTRL for manual
68 mouse driven selections
69 Pressing right button of mouse will not only select but also draw item on
70 selected layer
72 3)if you have pressed &lt;ENTER&gt; on an empty phrase you first of all will deselect
73 anything which was selected and you can then enter the so-called &quot;assembly
74 mode&quot; by left clicking on an item and afterwards pressing space as often as
75 desired, while the select parts dialog is active. The selection will move
76 down the list one by one displaying the selected part in the window
77 automatically (with the corresponding layer being active).
79 Alternatively 1:
80 If you had more than one item selected and you did not clear the selections list
81 by &lt;ENTER&gt; on an empty phrase, only the first item will be taken into account
82 and all others will be deselected.
84 Alternatively 2:
85 You can of course also select an item by clicking on it, pressing space will
86 then proceed as described
88 This mode also features arrows Up/Down selection, where arrow Up will reverse
89 the action of arrow Down/Spacebar. Furthermore, holding SHIFT while pressing
90 arrow Up/Down will increase the selection in either direction
91 -------------------------
92 More Features:
94 4)Inversion of selection:
95 pressing this button at any given time inverts the selection concerning the
96 whole list and upon clicking Mark button this new selection will be drawn
97 onto screen.
100 5)Top/bottom selection
101 General: press mark to mark selections on screen, after choosing to select
102 top or bottom parts.
104 a)in existing selection will only remove non wanted items
105 (e.g. all bottom parts if you press &quot;top parts&quot;) from selection
107 b)if there is no selection, all top or all bottoms parts are selected
110 6)Choose available layers for marking selected parts from drop-down list
111 HINT: if pick and place file is loaded last, already occupied layers
112 will not be in the drop-down list
114 -------------------------------------------------------------------
115 Hint 1:
116 right click functionality to know Part description.
117 After you have graphically marked a number of parts (say all resistors) you can
118 right click onto a part which is selected in the scroll-down list of available
119 parts in the search dialog.
120 Its designator, comment and footprint are then shown in the statusbar and in the log window.
121 This comes in handy if there are many parts you want to look at, but e.g. you already
122 know a fault has occurred only on one side of the board.
124 -------------------------------------------------------------------
125 Hint 2:
126 SCROLLING (in the dialog window)
127 Scrolling generally only occurs, if search for comments is not activated AND
128 also whenever enter is hit the list will bescrolled to the first hit,
129 regardless of the search mode.
130 The use of BackSpace is supported.
131 If you decide to select an entry from the list of completions offered, then the
132 scrolling will only occur once you press enter.
134 Example:
135 imagine you are looking for an element labelled EU3:
136 If you hit the first key (E) to enter a search phrase in the entry field, the
137 list will be scrolled to the first element matching this key (E), also entering
138 a subsequent key (U) will then further refine that and scroll to the first
139 element with EU etc.
140 ====================================================================</pre>
142 </div>
143 </div>
144 </body>
145 </html>