docs/wiki/geda-gerbv_pnp_readme.html

   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   <title></title>
   6   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   7   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   8   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   9
  10   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  11 </head>
  12 <body>
  13
  14
  15 <h1 class="sectionedit784"><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>
  16 <div class="level1">
  17 <pre class="code">Searching for Parts and marking them on screen (in gerbv)
  18
  19 THIS FUNCTIONALITY IS ONLY AVAILABLE WHEN COMPILING GERBV AGAINST GTK2!
  20
  21 Please direct any comments, suggestions etc. to Juergen &lt;juergenhaas@gmx.net&gt;
  22 =============================================================================
  23 ***  Support for Pick and Place files:                                   ***
  24 ***  csv-style files with/without quotes                                 ***
  25 ***  the following delimiters are supported &#039;;&#039; &#039;:&#039; &#039;|&#039; &#039;,&#039;              ***
  26 ----------------------------------------------------------------------------
  27
  28
  29 ----------------------------------------------------------------------------
  30 A pick and place file has 11 columns (the first two lines a file in gerbv/examplei
  31 are shown here) and looks like this:
  32
  33 Designator:Footprint:Mid X:Mid Y:Ref X:Ref Y:Pad X:Pad Y:Layer:Rotation:Comment
  34
  35 R29:0805_REFL:25.4mm:72.644mm:25.4mm:72.644mm:25.4mm:71.6788mm:T:90.00:1K/1%
  36 ----------------------------------------------------------------------------
  37
  38 Some instructions for the first time user:
  39
  40 after loading a PNP file a new dialog will come up offering various option of
  41 selecting and graphically marking electronic parts.
  42
  43 Three modes of selecting items do exist:
  44 1)enter any search phrase and hit enter
  45      (See also paragraph &quot;SCROLLING&quot; further down)
  46         -Generally under linux regexp expressions are used such as &quot;.*&quot; i.e. &#039;*&#039;
  47         -All matches will be marked in the list AND on the screen
  48         -if you press ESC or press &lt;ENTER&gt; on an empty line it will deselect all
  49          items
  50         -if you had a selection already and you would like to add single items
  51          one by one, just hold down CTRL key while you left-click on the desired
  52          fields
  53
  54 2)just simply use left click combined with Shift and/or CTRL for manual
  55   mouse driven selections
  56   Pressing right button of mouse will not only select but also draw item on
  57   selected layer
  58
  59 3)if you have pressed &lt;ENTER&gt; on an empty phrase you first of all will deselect
  60   anything which was selected  and you can then enter the so-called &quot;assembly
  61   mode&quot; by left clicking on an item and afterwards pressing space as often as
  62   desired, while the select parts dialog is active. The selection will move
  63   down the list one by one displaying the selected part in the window
  64   automatically (with the corresponding layer being active).
  65
  66  Alternatively 1:
  67  If you had more than one item selected and you did not clear the selections list
  68  by &lt;ENTER&gt; on an empty phrase, only the first item will be taken into account
  69  and all others will be deselected.
  70
  71  Alternatively 2:
  72  You can of course also select an item by clicking on it, pressing space will
  73  then proceed as described
  74
  75  This mode also features arrows Up/Down selection, where arrow Up will reverse
  76  the action of arrow Down/Spacebar. Furthermore, holding SHIFT while pressing
  77  arrow Up/Down will increase the selection in either direction
  78 -------------------------
  79 More Features:
  80
  81 4)Inversion of selection:
  82   pressing this button at any given time inverts the selection concerning the
  83   whole list and upon clicking Mark button this new selection will be drawn
  84   onto screen.
  85
  86
  87 5)Top/bottom selection
  88   General:  press mark to mark selections on screen, after choosing to select
  89                    top or bottom parts.
  90
  91     a)in existing selection will only remove non wanted items
  92           (e.g. all bottom parts if you press &quot;top  parts&quot;) from selection
  93
  94     b)if there is no selection, all top or all bottoms parts are selected
  95
  96
  97 6)Choose available layers for marking selected parts from drop-down list
  98   HINT: if pick and place file is loaded last, already occupied layers
  99         will not be in the drop-down list
 100
 101 -------------------------------------------------------------------
 102 Hint 1:
 103 right click functionality to know Part description.
 104 After you have graphically marked a number of parts (say all resistors) you can
 105 right click onto a part which is selected in the scroll-down list of available
 106 parts in the search dialog.
 107 Its designator, comment and footprint are then shown in the statusbar and in the log window.
 108 This comes in handy if there are many parts you want to look at, but e.g. you already
 109 know a fault has occurred only on one side of the board.
 110
 111 -------------------------------------------------------------------
 112 Hint 2:
 113 SCROLLING (in the dialog window)
 114  Scrolling generally only occurs, if search for comments is not activated AND
 115  also whenever enter is hit the list will bescrolled to the first hit,
 116  regardless of the search mode.
 117  The use of BackSpace is supported.
 118  If you decide to select an entry from the list of completions offered, then the
 119  scrolling will only occur once you press enter.
 120
 121 Example:
 122  imagine you are looking for an element labelled EU3:
 123  If you hit the first key (E) to enter a search phrase in the entry field, the
 124  list will be scrolled to the first element matching this key (E), also entering
 125  a subsequent key (U) will then further refine that and scroll to the first
 126  element with EU etc.
 127 ====================================================================</pre>
 128
 129 </div>
 130 </body>
 131 </html>