libgeda: Don't double free path argument
[geda-gaf.git] / docs / wiki / geda-gschem_warmup.html
blob7cb3dd940be7599e8bb53d91d5bb873d7b390426
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-gschem_warmup.ru.html" class="wikilink1" title="geda-gschem_warmup.ru.html">Русский</a>.
15 </p>
17 <h1 id="gschemwarmupforbeginners">gschem Warmup for Beginners</h1>
18 <div class="level1">
20 <p>
21 You need to become familiar with doing a few things in <em><strong>gschem</strong></em>, so just run <em><strong>gschem</strong></em> and start playing around:
22 </p>
24 <p>
25 You get an initial page with menus and a toolbar at the top. As you select operations from the menus, notice that there are usually keyboard shortcuts which can alternatively be used to access the menu functions.
26 </p>
28 <p>
29 <a href="media/geda/warmup_gschem.png" class="media" target="_blank" title="geda:warmup_gschem.png">geda:warmup_gschem.png</a>
30 </p>
32 <p>
33 Look at the page and you will see that it contains a title-block.
34 When drawing a schematic, it&#039;s a good idea to always start by
35 setting some schematic boundaries to draw within. This is why the
36 title-block is added every time you start <em><strong>gschem</strong></em> to create
37 a new schematic.
38 </p>
40 <p>
41 Try to zoom in and out the page:
42 </p>
43 <ul>
44 <li class="level1"><div class="li"> Use keyboard shortcut <kbd>Z</kbd> to zoom in and <kbd>Shift</kbd>+<kbd>Z</kbd> to zoom out (or select from menu <strong>View-&gt;Zoom In</strong> or <strong>View-&gt;Zoom Out</strong>). Notice that as you press a key or a key sequence it is displayed in the status bar at the bottom. Notice also that as you zoom in or zoom out the viewable area centers around the mouse cursor.</div>
45 </li>
46 <li class="level1"><div class="li"> Roll the mouse wheel first without and then with pressing one of the keys <kbd>Shift</kbd> or <kbd>Control</kbd> to see how to zoom or pan the page.</div>
47 </li>
48 <li class="level1"><div class="li"> With the mouse in the <em><strong>gschem</strong></em> drawing area, hit the keys <kbd>V</kbd><kbd>E</kbd> (or select from menu <strong>View-&gt;Zoom Extents</strong>) to zoom the view to the title-block symbol extents.</div>
49 </li>
50 </ul>
52 <p>
53 I find that using the default B sized title-block lets my
54 schematics print at a nice size on letter sized paper, but let&#039;s
55 suppose you don&#039;t like it, so you need to remove the old
56 title-block and replace it with another one:
57 </p>
58 <ul>
59 <li class="level1"><div class="li"> Zoom the page to see the whole title-block.</div>
60 </li>
61 <li class="level1"><div class="li"> Position the mouse pointer at the bottom left of the title-block, then press the left mouse button and drag the mouse to select it.</div>
62 </li>
63 <li class="level1"><div class="li"> Hit the <kbd>E</kbd> <kbd>Shift</kbd>+<kbd>L</kbd> shortcut (or select <strong>Edit-&gt;Unlock</strong> from menu) to unlock and <kbd>D</kbd> or <kbd>Delete</kbd> to delete the title-block.</div>
64 </li>
65 <li class="level1"><div class="li"> Bring up the <strong>Select Component</strong> window by selecting from the menu <strong>Add-&gt;Component</strong> or hit keyboard shortcut <kbd>I</kbd>. Or you could click the add component icon on the toolbar (<a href="media/geda/warmup_add_component.png" class="media" target="_blank" title="geda:warmup_add_component.png">geda:warmup_add_component.png</a>).</div>
66 </li>
67 <li class="level1"><div class="li"> In the <strong>Libraries</strong> list, select <strong>Titleblocks (generic)</strong>.</div>
68 </li>
69 <li class="level1"><div class="li"> Left click on the little triangle at the left or just double click the library name to open its component list.</div>
70 </li>
71 <li class="level1"><div class="li"> Select <strong>title-A.sym</strong>.</div>
72 </li>
73 <li class="level1"><div class="li"> Move the mouse onto the <em><strong>gschem</strong></em> drawing area and place the title-block symbol by clicking the left mouse button. Then click the right mouse button to abort adding more title-block symbols.</div>
74 </li>
75 </ul>
77 <p>
78 Let&#039;s add some components on the page and try to move them around:
79 </p>
80 <ul>
81 <li class="level1"><div class="li"> Back in the select components window, (bring it up again if you closed it), select the <strong>Basic devices</strong> library and then select the component <strong>resistor-1.sym</strong> and place a couple of resistors on the schematic with the left mouse button.</div>
82 </li>
83 <li class="level1"><div class="li"> Right click to abort adding more resistors.</div>
84 </li>
85 <li class="level1"><div class="li"> Left click on one of the resistors to select it. Notice that it is now an orange color and that indicates it is selected.</div>
86 </li>
87 <li class="level1"><div class="li"> Left click again anywhere to deselect it.</div>
88 </li>
89 <li class="level1"><div class="li"> Alternate left clicking on both resistors to select them, but notice that if you don&#039;t hit the resistor just right, the title-block is selected instead. We really don&#039;t want to ever select the title-block again, so we can lock it to prevent its irritating selection: click so the title-block IS selected, then select <strong>Edit-&gt;Lock</strong> or hit keyboard shortcut <kbd>E</kbd><kbd>L</kbd>. Now it&#039;s easier to select the resistors as we like.</div>
90 </li>
91 <li class="level1"><div class="li"> Move the resistors around with the left mouse button.</div>
92 </li>
93 <li class="level1"><div class="li"> Select a resistor and then rotate with the <kbd>E</kbd><kbd>R</kbd> keys or the <strong>Edit-&gt;Rotate 90 Mode</strong>. Notice that it is rotated around the mouse pointer position. If you rotate from menu you have to define the rotation center position by clicking on it. If you don&#039;t see where the rotated component is, hit again <kbd>V</kbd><kbd>E</kbd> to zoom to the schematic extents.</div>
94 </li>
95 <li class="level1"><div class="li"> Hit <kbd>U</kbd> or <kbd>Ctrl</kbd>+<kbd>Z</kbd> to undo the last action and <kbd>Ctrl</kbd>+<kbd>Y</kbd> to redo it again.</div>
96 </li>
97 <li class="level1"><div class="li"> Move the resistors relatively close together and then zoom in on them.</div>
98 </li>
99 </ul>
102 <a href="media/geda/warmup_resistors_1.png" class="media" target="_blank" title="geda:warmup_resistors_1.png">geda:warmup_resistors_1.png</a>
103 </p>
106 Now we can add some nets:
107 </p>
108 <ul>
109 <li class="level1"><div class="li"> Place the mouse on one of the resistor pins and hit the <kbd>N</kbd> key or click the add net icon on the toolbar (<a href="media/geda/warmup_net.png" class="media" target="_blank" title="geda:warmup_net.png">geda:warmup_net.png</a>) to start adding a net.</div>
110 </li>
111 <li class="level1"><div class="li"> Move the mouse to a pin on the other resistor and you will see a small circle indicating the place the net will snap. The circle is visible only in magnetic mode which is enabled by default.</div>
112 </li>
113 </ul>
116 <a href="media/geda/warmup_resistors_2.png" class="media" target="_blank" title="geda:warmup_resistors_2.png">geda:warmup_resistors_2.png</a>
117 </p>
118 <ul>
119 <li class="level1"><div class="li"> Left click to attach the net to the pin.</div>
120 </li>
121 <li class="level1"><div class="li"> Move the mouse slightly and you will see a new net following the mouse cursor. Right click to abort adding new nets.</div>
122 </li>
123 </ul>
126 Look at the toolbar and see that your mode has switched to adding nets. Before you can change resistor selections again, you will have to re-enter select mode with the <kbd>S</kbd> key or by clicking the select toolbar icon (<a href="media/geda/warmup_select.png" class="media" target="_blank" title="geda:warmup_select.png">geda:warmup_select.png</a>) or by using the menu <strong>Edit-&gt;Select Mode</strong>. You will have to play with doing things to get used to the <em><strong>gschem</strong></em> modes.
127 </p>
130 If when you added the net between the resistors you get something that looks like this:
131 <a href="media/geda/warmup_resistors_3.png" class="media" target="_blank" title="geda:warmup_resistors_3.png">geda:warmup_resistors_3.png</a>
132 it means you missed the pin on the right resistor. The square cue on the end of the pin shows its connectible point and you must start and stop nets with the mouse on this red spot to make a connection to the pin. To correct this:
133 </p>
134 <ul>
135 <li class="level1"><div class="li"> Select the net between the resistors and delete it with the <kbd>Delete</kbd> key.</div>
136 </li>
137 <li class="level1"><div class="li"> Switch again to net mode and try to connect the resistors once more.</div>
138 </li>
139 </ul>
142 Now let&#039;s play with attributes:
143 </p>
144 <ul>
145 <li class="level1"><div class="li"> Select a resistor and hit the <kbd>E</kbd><kbd>E</kbd> keys. This will pop up the attribute editing window for the resistor. Here you can change existing attribute values or add new attributes with values to the resistor. Practice well with adding attributes and changing attribute values because you will need to be very familiar with managing attributes when using <em><strong>gschem</strong></em>.</div>
146 </li>
147 </ul>
150 Now go back to <a href="geda-gsch2pcb_tutorial.html" class="wikilink1" title="geda-gsch2pcb_tutorial.html">the tutorial</a> and try working through the simple example there. If you encounter steps that aren&#039;t clear, look through the <em><strong>gschem</strong></em> <a href="geda-gschem_ug.html" class="wikilink1" title="geda-gschem_ug.html">user documentation</a> and <a href="geda-master_attributes_list.html" class="wikilink1" title="geda-master_attributes_list.html">attributes documentation</a>. Other <em><strong>gschem</strong></em> documentation can be found on the <a href="geda-documentation.html" class="wikilink1" title="geda-documentation.html">gEDA Documentation</a> page.
151 </p>
152 <hr />
155 tutorial by Bill Wilson (billw--at--gkrellm.net)
156 </p>
158 </div>
159 </body>
160 </html>