File: ch04s04s04.html

package info (click to toggle)
gimp-help 2%2B0.7-5
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 30,852 kB
  • ctags: 4
  • sloc: xml: 104,248; sh: 544; makefile: 262; perl: 42
file content (389 lines) | stat: -rw-r--r-- 15,881 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>4.4. Paths Menu</title>
    <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
    <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.66.1" />
    <link rel="start" href="index.html" title="&#10;      &#10;    " />
    <link rel="up" href="ch04s04.html" title="4. Path dialog" />
    <link rel="prev" href="ch04s04s03.html" title="4.3. Buttons" />
    <link rel="next" href="ch04s05.html" title="5. Indexed Palette dialog" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center" id="chaptername">4.4. Paths Menu</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="ch04s04s03.html">Prev</a> </td>
          <th width="60%" align="center" id="sectionname">4.4. Paths Menu</th>
          <td width="20%" align="right"> <a accesskey="n" href="ch04s05.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect2" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h3 class="title"><a id="gimp-paths-menu"></a>4.4. Paths Menu</h3>
          </div>
        </div>
      </div>
      <div class="informalfigure">
        <div class="mediaobject">
          <img src="../images/dialogs/dialogs-paths-menu.png" />
          <div class="caption">
            <p>
	    The Paths dialog menu
	  </p>
          </div>
        </div>
      </div>
      <p>
      The Paths menu can be brought up by right-clicking on a path entry
      in the list in the Paths dialog, or by choosing the top entry
      ("Paths Menu") from the Paths dialog Tab menu.  This menu gives
      you access to most of the operations that affect paths.
    </p>
      <div class="variablelist">
        <dl>
          <dt>
            <span class="term">Path Tool</span>
          </dt>
          <dd>
            <p>
	    <span class="guilabel">Path Tool</span> is an alternative way to
	    activate the <a href="ch03s06.html#gimp-tool-path" title="6.1. Path Tool">Path tool</a>,
	    used for creating and manipulating paths.  It can also be
	    activated from the Toolbox, or by using the keyboard shortcut
	    <span><b class="keycap">B</b></span> (for <span class="emphasis"><em>Bezier</em></span>).
	  </p>
          </dd>
          <dt>
            <span class="term">Edit Path Attributes</span>
          </dt>
          <dd>
            <a id="gimp-path-edit"></a>
            <p>
            <span class="guilabel">Edit Path Attributes</span> brings up a small
            dialog that allows you to change the name of the path.  You
            can also do this by double-clicking on the name in the list in
            the Paths dialog.
          </p>
          </dd>
          <dt>
            <span class="term">New Path</span>
          </dt>
          <dd>
            <a id="gimp-path-new"></a>
            <p>
            <span class="guilabel">New Path</span>creates a new path, adds it to
            the list in the Paths dialog, and makes it the active path
            for the image.  It brings up a dialog that allows you to
            give a name to the path.  The new path is created with no
            anchor points, so you will need to use the Path tool to give
            it some before you can use it for anything.
          </p>
          </dd>
          <dt>
            <span class="term">Raise Path</span>
          </dt>
          <dd>
            <a id="gimp-path-raise"></a>
            <p>
            <span class="guilabel">Raise Path</span> moves the path one slot higher
            in the list in the Paths dialog.  The position of a path in
            the list has no functional significance, so this is simply a
            convenience to help you keep things organized.
          </p>
          </dd>
          <dt>
            <span class="term">Lower Path</span>
          </dt>
          <dd>
            <a id="gimp-path-lower"></a>
            <p>
            <span class="guilabel">Lower Path</span>moves the path one slot lower
            in the list in the Paths dialog.  The position of a path in
            the list has no functional significance, so this is simply a
            convenience to help you keep things organized.
          </p>
          </dd>
          <dt>
            <span class="term">Duplicate Path</span>
          </dt>
          <dd>
            <a id="gimp-path-duplicate"></a>
            <p>
            "Duplicate Path" creates a copy of the active path, assigns
            it a unique name, adds it to the list in the Paths dialog,
            and makes it the active path for the image.  The copy will
            be visible only if the original path was visible.  
          </p>
            <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
              <table border="0" summary="Note">
                <tr>
                  <td rowspan="2" align="center" valign="top" width="25">
                    <img alt="[Note]" src="../images/note.png" />
                  </td>
                  <th align="left">Note</th>
                </tr>
                <tr>
                  <td colspan="2" align="left" valign="top">
                    <p>
              Note that copying a visible path will make the path
              "disappear" from the image display: this happens because
              paths are drawn in XOR mode, which has the curious
              property that drawing an item twice "undraws" it.  The
              paths are still there even though you don't see anything:
              if you move one of them, you will be able to see both.
            </p>
                  </td>
                </tr>
              </table>
            </div>
          </dd>
          <dt>
            <span class="term">Delete Path</span>
          </dt>
          <dd>
            <a id="gimp-path-delete"></a>
            <p>
            <span class="guilabel">Delete Path</span> deletes the current selected
            path.
          </p>
          </dd>
          <dt>
            <span class="term">Merge Visible Paths</span>
          </dt>
          <dd>
            <p>
            <span class="guilabel">Merge Visible Paths</span> takes all the paths
            in the image that are visible (that is, all that show "open
            eye" symbols in the Paths dialog), and turns them into
            components of a single path.  This may be convenient if you
            want to stroke them all in the same way, etc.
          </p>
          </dd>
          <dt>
            <span class="term">Cesta do výběru; Přidat do výběru; Ubrat z výběru;
        Průnik s výběrem</span>
          </dt>
          <dd>
            <a id="gimp-path-selection-replace"></a>
            <a id="gimp-path-selection-add"></a>
            <a id="gimp-path-selection-subtract"></a>
            <a id="gimp-path-selection-intersect"></a>
            <p>
            These commands all convert the active path into a selection,
            and then combine it with the existing selection in the
            specified ways.  ("Path to Selection" discards the existing
            selection and replaces it with one formed from the path.)
            If necessary, any unclosed components of the path are closed
            by connecting the last anchor point to the first anchor
            point with a straight line.  The "marching ants" for the
            resulting selection should closely follow the path, but
            don't expect the correspondence to be perfect.
          </p>
          </dd>
          <dt>
            <span class="term">Selection to Path</span>
          </dt>
          <dd>
            <a id="gimp-selection-to-path"></a>
            <p>
            This operation can be accesssed in several ways:
          </p>
            <div class="itemizedlist">
              <ul type="disc">
                <li>
                  <p>
          From an image menubar, as
          <span class="guimenu">Select</span>-&gt;<span class="guimenuitem">To Path</span>
              </p>
                </li>
                <li>
                  <p>
                From the Paths dialog menu, as <span class="guimenuitem">Selection to 
                Path</span>.
              </p>
                </li>
                <li>
                  <p>
                From the <span class="guilabel">Selection to Path</span> button at
                the bottom of the Paths dialog.
              </p>
                </li>
                <li>
                  <p>
                From the "Selection to Path" button in the Tool Options
                for the Path tool.
              </p>
                </li>
              </ul>
            </div>
            <p>
            <span class="guilabel">Selection to Path</span> creates a new path
            from the image's selection. In most cases the resulting path
            will closely follow the "marching ants" of the selection,
            but the correspondence will not usually be perfect. 
          </p>
            <p>
            Converting a two-dimensional selection mask into a
            one-dimensional path involves some rather tricky algorithms:
            you can alter the way it is done using the
            <span class="guilabel">Advanced Options</span>, which are accessed by
            holding down the <span><b class="keycap">Shift</b></span> key while pressing
            the <span class="guilabel">Selection to Path</span> button at the
            bottom of the Paths dialog.  This brings up the Advanced
            Options dialog, which allows you to set 20 different options
            and variables, all with cryptic names.  The Advanced Options
            are really intended for developers only, and help with them
            goes beyond the scope of this documentation.  Generally
            speaking, <span class="guilabel">Selection to Path</span> will do
            what you expect it to, and you don't need to worry about how
            it is done (unless you want to).
          </p>
          </dd>
          <dt>
            <span class="term">Stroke Path</span>
          </dt>
          <dd>
            <a id="gimp-path-stroke"></a>
            <p>
            This operation can be accesssed in several ways:
          </p>
            <div class="itemizedlist">
              <ul type="disc">
                <li>
                  <p>
                From an image menubar, as
                <span class="guimenu">Edit</span>-&gt;<span class="guimenuitem">Stroke Path</span>
              </p>
                </li>
                <li>
                  <p>
                From the Paths dialog menu, as <span class="guimenuitem">Stroke
                Path</span>.
              </p>
                </li>
                <li>
                  <p>
                From the <span class="guilabel">Stroke Path</span> button at the
                bottom of the Paths dialog.
              </p>
                </li>
                <li>
                  <p>
                From the <span class="guilabel">Stroke Path</span> button in the
                Tool Options for the Path tool.
              </p>
                </li>
              </ul>
            </div>
            <p>
            "Stroke Path" renders the active path on the active layer of
            the image, permitting a wide variety of line styles and
            stroking options.  See the section on <a href="ch02s04s13.html" title="4.13. Stroking a Selection or Path">Stroking</a> for more information.
          </p>
          </dd>
          <dt>
            <span class="term">Copy Path</span>
          </dt>
          <dd>
            <a id="gimp-path-copy"></a>
            <p>
            "Copy Path" copies the active path to the Paths Clipboard,
            enabling you to paste it into a different image.  
          </p>
            <div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
              <table border="0" summary="Tip">
                <tr>
                  <td rowspan="2" align="center" valign="top" width="25">
                    <img alt="[Tip]" src="../images/tip.png" />
                  </td>
                  <th align="left">Tip</th>
                </tr>
                <tr>
                  <td colspan="2" align="left" valign="top">
                    <p>
              You can also copy and paste a path by dragging its icon
              from the Paths dialog into the target image's display.
            </p>
                  </td>
                </tr>
              </table>
            </div>
          </dd>
          <dt>
            <span class="term">Paste Path</span>
          </dt>
          <dd>
            <a id="gimp-path-paste"></a>
            <p>
            <span class="guilabel">Paste Path</span> creates a new path from the
            contents of the Path Clipboard, adds it to the list in the
            Paths dialog, and makes it the active path for the image.  If
            no path has previously been copied into the clipboard, the
            menu entry will be insensitive.
          </p>
          </dd>
          <dt>
            <span class="term">Import Path</span>
          </dt>
          <dd>
            <a id="gimp-path-import"></a>
            <p>
            "Import Path" creates a new path from an SVG file:  it pops
            up a file chooser dialog that allows you to navigate to the
            file.  See the <a href="ch02s04s07.html" title="4.7. Paths">Paths</a>
            section for information on SVG files and how they relate to
            GIMP paths.
          </p>
          </dd>
          <dt>
            <span class="term">Export Path</span>
          </dt>
          <dd>
            <p>
            <span class="guilabel">Export Path</span> allows you to save a path to
            a file:  it pops up a file save dialog that allows you to
            specify the file name and location.  You can later add this
            path to any GIMP image using the <span class="guilabel">Import
            Path</span> command.  The format used for saving paths is
            SVG:  this means that vector-graphics programs such as
            <span class="application">Sodipodi</span> or
            <span class="application">Inkscape</span> will also be able to
            import the paths you save.  See the <a href="ch02s04s07.html" title="4.7. Paths">Paths</a> section for more information
            on SVG files and how they relate to GIMP paths.
          </p>
          </dd>
        </dl>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="ch04s04s03.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="ch04s04.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="ch04s05.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">4.3. Buttons </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> 5. Indexed Palette dialog</td>
        </tr>
      </table>
    </div>
  </body>
</html>