home *** CD-ROM | disk | FTP | other *** search
- <?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>2.3.  Path Dialog</title>
- <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
- <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
- <link rel="stylesheet" href="gimp-help-custom.css" type="text/css" />
- <link rel="alternate stylesheet" href="gimp22.css" type="text/css" title="gimp22" />
- <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
- <link rel="start" href="index.html" title="GNU Image Manipulation Program" />
- <link rel="up" href="gimp-dialogs-structure.html" title="2.  Image Structure Related Dialogs" />
- <link rel="prev" href="gimp-channel-dialog.html" title="2.2.  Channels Dialog" />
- <link rel="next" href="gimp-indexed-palette-dialog.html" title="2.4.  Colormap Dialog" />
- </head>
- <body>
- <div class="navheader">
- <table width="100%" summary="Navigation header">
- <tr>
- <th colspan="3" align="center">2.3. 
- <span lang="en" xml:lang="en">Path Dialog</span>
- </th>
- </tr>
- <tr>
- <td width="20%" align="left"><a accesskey="p" href="gimp-channel-dialog.html"><img src="../images/prev.png" alt="Prev" /></a> </td>
- <th width="60%" align="center">2. 
- <span lang="en" xml:lang="en">Image Structure Related Dialogs</span>
- </th>
- <td width="20%" align="right"> <a accesskey="n" href="gimp-indexed-palette-dialog.html"><img src="../images/next.png" alt="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-path-dialog"></a>2.3. 
- <span lang="en" xml:lang="en">Path Dialog</span>
- </h3>
- </div>
- <div>
- <div class="revhistory">
- <table border="1" width="100%" summary="Revision history">
- <tr>
- <th align="left" valign="top" colspan="3">
- <b>Revision History</b>
- </th>
- </tr>
- <tr>
- <td align="left">Revision $Revision: 2419 $</td>
- <td align="left">2006-03-05</td>
- <td align="left">j.h</td>
- </tr>
- </table>
- </div>
- </div>
- </div>
- </div>
- <a id="id2656454" class="indexterm"></a>
- <a id="id2656468" class="indexterm"></a>
- <div class="figure">
- <a id="id2656482"></a>
- <p class="title">
- <b>Figure 14.12. 
- <span lang="en" xml:lang="en">The Paths dialog</span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/dialogs/dialogs-paths.png" alt="The Paths dialog" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- The Paths dialog is used to manage paths, allowing you to create or
- delete them, save them, convert them to and from selections, etc.
- </p>
- <p>
- The Paths dialog is a dockable dialog; see the section on
- <a class="link" href="gimp-concepts-docks.html" title="2.3.  Dialogs and Docking">Dialogs and Docking</a>
- for help on manipulating it. It can be activated in several ways:
- </p>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="gimp-path-dialog-activate"></a>2.3.1. 
- <span lang="en" xml:lang="en">Activate dialog</span>
- </h4>
- </div>
- </div>
- </div>
- <div class="itemizedlist">
- <ul type="disc">
- <li>
- <p>
- From the Toolbox menu:
- <span class="guimenu">File</span> ‚Üí <span class="guisubmenu">Dialogs</span> ‚Üí <span class="guimenuitem"><span class="accel">P</span>aths</span>.
- </p>
- </li>
- <li>
- <p>
- From the Toolbox menu:
- <span class="guimenu">File</span> ‚Üí <span class="guisubmenu">Dialogs</span> ‚Üí <span class="guisubmenu">Create New Dock</span> ‚Üí <span class="guimenuitem">Layers, Channels, and Paths</span>.
- This gives you a dock containing three dialogs, with the
- Paths dialog one of them.
- </p>
- </li>
- <li>
- <p>
- From an image menu:
- <span class="guimenu">Dialogs</span> ‚Üí <span class="guimenuitem"><span class="accel">P</span>aths</span>.
- </p>
- </li>
- <li>
- <p>
- From the Tab menu in any dockable dialog:
- <span class="guimenu">Add Tab</span> ‚Üí <span class="guimenuitem"><span class="accel">P</span>aths</span>.
- </p>
- </li>
- </ul>
- </div>
- </div>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="gimp-path-dialog-using"></a>2.3.2. 
- <span lang="en" xml:lang="en">Using the Paths dialog</span>
- </h4>
- </div>
- </div>
- </div>
- <p>
- Each path belongs to one image: paths are components of images just
- like layers. The Paths dialog shows you a list of all paths belonging
- to the currently active image: switching images causes the dialog to
- show a different list of paths. If the Paths dialog is embedded in a
- “<span class="quote">Layers, Channels, and Paths</span>” dock, you can see the name
- of the active image in the Image Menu at the top of the dock.
- (Otherwise, you can add an Image Menu to the dock by choosing
- “<span class="quote">Show Image Menu</span>” from the Tab menu.)
- </p>
- <p>
- If you are familiar with the Layers dialog, you have a head start,
- because the Paths dialog is in several ways similar. It shows a list of
- all paths that exist in the image, with four items for each path:
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">
- <span class="guiicon">
- <span class="inlinemediaobject"><img src="../images/dialogs/stock-eye-20.png" /></span>
- </span>
- <span lang="en" xml:lang="en">Path visibility</span>
- </span>
- </dt>
- <dd>
- <p>
- An “<span class="quote">open eye</span>” icon if the path is visible, or a
- blank space if it is not. "Visible" means that a trace of the
- path is drawn on the image display. The path is not actually
- shown in the image pixel data unless it has been stroked or
- otherwise rendered. Clicking in the eye-symbol-space toggles the
- visibility of the path.
- </p>
- </dd>
- <dt>
- <span class="term">
- <span class="guiicon">
- <span class="inlinemediaobject"><img src="../images/dialogs/stock-vchain-24.png" /></span>
- </span>
- <span lang="en" xml:lang="en">chain paths</span>
- </span>
- </dt>
- <dd>
- <p>
- A “<span class="quote">chain</span>” symbol is shown to the right of the
- eye-symbol-space if the path is transform-locked, or a blank
- space if it is not. “<span class="quote">Transform-locked</span>” means that
- it forms
- part of a set of elements (layers, channels, etc) that are
- all affected in the same way by transformations (scaling,
- rotation, etc) applied to any one of them. Clicking in the
- chain-symbol-space toggles the transform-lock status of the
- path.
- </p>
- </dd>
- <dt>
- <span class="term">Preview image</span>
- </dt>
- <dd>
- <p>
- A small preview-icon showing a sketch of the path. If you click
- on the icon and drag it into an image, this will create a copy of
- the path in that image.
- </p>
- </dd>
- <dt>
- <span class="term">
- <span class="guiicon">
- <span class="inlinemediaobject"><img src="../images/dialogs/dialogs-paths-rename.png" /></span>
- </span>
- <span lang="en" xml:lang="en">path name</span>
- </span>
- </dt>
- <dd>
- <p>
- The name of the path, which must be unique within the image.
- Double-clicking on the name will allow you to edit it. If the
- name you create already exists, a number will be appended (e.g.,
- "#1") to make it unique.
- </p>
- </dd>
- </dl>
- </div>
- <p>
- If the list is non-empty, at any given moment one of the members is the
- image's <span class="emphasis"><em>active path</em></span>,
- which will be the subject of any operations you perform using the
- dialog menu or the buttons at the bottom: the active path is shown
- highlighted in the list. Clicking on any of the entries will make it
- the active path.
- </p>
- <p>
- Right-clicking on any entry in the list brings up the
- <a class="link" href="gimp-path-dialog.html#gimp-concepts-paths-menu" title="2.3.4.  The “Paths” sub-menu">Paths Menu</a>.
- You can also access the Paths Menu from the dialog Tab menu.
- </p>
- </div>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="gimp-path-dialog-buttons"></a>2.3.3. 
- <span lang="en" xml:lang="en">Buttons</span>
- </h4>
- </div>
- </div>
- </div>
- <p>
- The buttons at the bottom of the Paths dialog all correspond to entries
- in the Paths menu (accessed by right-clicking on a path list entry),
- but some of them have extra options obtainable by holding down modifier
- keys while you press the button.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">New Path</span>
- </dt>
- <dd>
- <p>
- See <a class="link" href="gimp-path-dialog.html#gimp-path-new">New Path</a>. Holding down
- the <span class="keycap"><strong>Shift</strong></span> key brings up a dialog that allows you
- to assign a name to the new (empty) path.
- </p>
- </dd>
- <dt>
- <span class="term">Raise Path</span>
- </dt>
- <dd>
- <p>
- See <a class="link" href="gimp-path-dialog.html#gimp-path-raise">Raise Path</a>.
- </p>
- </dd>
- <dt>
- <span class="term">Lower Path</span>
- </dt>
- <dd>
- <p>
- See <a class="link" href="gimp-path-dialog.html#gimp-path-lower">Lower Path</a>.
- </p>
- </dd>
- <dt>
- <span class="term">Duplicate Path</span>
- </dt>
- <dd>
- <p>
- See <a class="link" href="gimp-path-dialog.html#gimp-path-duplicate">Duplicate Path</a>.
- </p>
- </dd>
- <dt>
- <span class="term">Path to Selection</span>
- </dt>
- <dd>
- <p>
- Converts the path into a selection; see
- <a class="link" href="gimp-path-dialog.html#gimp-path-selection-replace">
- Path to Selection
- </a>
- for a full explanation. You can use modifier keys to set the way
- the new selection interacts with the existing selection:
- </p>
- <div class="segmentedlist">
- <table border="0">
- <thead>
- <tr class="segtitle">
- <th>Modifiers</th>
- <th>Action</th>
- </tr>
- </thead>
- <tbody>
- <tr class="seglistitem">
- <td class="seg">None</td>
- <td class="seg">Replace existing selection</td>
- </tr>
- <tr class="seglistitem">
- <td class="seg">
- <span class="keycap"><strong>Shift</strong></span>
- </td>
- <td class="seg">Add to selection</td>
- </tr>
- <tr class="seglistitem">
- <td class="seg">
- <span class="keycap"><strong>Ctrl</strong></span>
- </td>
- <td class="seg">Subtract from selection</td>
- </tr>
- <tr class="seglistitem">
- <td class="seg">
- <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Ctrl</strong></span>
- </td>
- <td class="seg">Intersect with selection.</td>
- </tr>
- </tbody>
- </table>
- </div>
- </dd>
- <dt>
- <span class="term">Selection to Path</span>
- </dt>
- <dd>
- <p>
- Holding down the <span class="keycap"><strong>Shift</strong></span> key brings up the
- <span class="guilabel">Advanced Options</span> dialog, which
- probably is only useful to GIMP developers.
- </p>
- </dd>
- <dt>
- <span class="term">Stroke Path</span>
- </dt>
- <dd>
- <p>
- See <a class="link" href="gimp-path-stroke.html" title="6.18.  Stroke Path">Stroke Path</a>.
- </p>
- </dd>
- <dt>
- <span class="term">Delete Path</span>
- </dt>
- <dd>
- <p>
- <span class="guilabel">Delete Path</span> deletes the current selected
- path.
- </p>
- </dd>
- </dl>
- </div>
- </div>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="gimp-concepts-paths-menu"></a>2.3.4. 
- <span lang="en" xml:lang="en">The “<span class="quote">Paths</span>” sub-menu</span>
- </h4>
- </div>
- </div>
- </div>
- <div class="figure">
- <a id="id2657310"></a>
- <p class="title">
- <b>Figure 14.13. 
- <span lang="en" xml:lang="en">The “<span class="quote">Paths</span>” sub-menu</span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/dialogs/dialogs-paths-menu.png" alt="The Paths sub-menu" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <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 class="link" href="gimp-tools-other.html#gimp-tool-path" title="6.1.  Path">Path tool</a>,
- used for creating and manipulating paths. It can also be
- activated from the Toolbox, or by using the keyboard shortcut
- <span class="keycap"><strong>B</strong></span> (for <span class="emphasis"><em>Bézier</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>
- </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
- “<span class="quote">open eye</span>” 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">
- Path to Selection; Add to Selection; Subtract from Selection;
- Intersect with Selection
- </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 accessed in several ways:
- </p>
- <div class="itemizedlist">
- <ul type="disc">
- <li>
- <p>
- From an image menubar, as
- <span class="guimenu">Select</span> ‚Üí <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 <span class="guilabel">Selection to Path</span> 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 class="keycap"><strong>Shift</strong></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-dialog-stroke"></a>
- <p>
- This operation can be accessed in several ways:
- </p>
- <div class="itemizedlist">
- <ul type="disc">
- <li>
- <p>
- From an image menubar, as
- <span class="guimenu">Edit</span> ‚Üí <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>
- “<span class="quote">Stroke Path</span>” 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 class="link" href="gimp-selection-stroke.html" title="6.17.  Stroke Selection">Stroking</a> for more
- information.
- </p>
- </dd>
- <dt>
- <span class="term">Copy Path</span>
- </dt>
- <dd>
- <a id="gimp-path-copy"></a>
- <p>
- <span class="guilabel">Copy Path</span> 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 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>
- <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 align="left" valign="top">
- <p>
- When you copy a path to an image, it is not visible. You have
- to make it visible in the Path dialog.
- </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 class="link" href="gimp-using-paths.html#gimp-concepts-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 class="link" href="gimp-using-paths.html#gimp-concepts-paths">Paths</a> section for more
- information on SVG files and how they relate to GIMP paths.
- </p>
- </dd>
- </dl>
- </div>
- </div>
- </div>
- <div class="navfooter">
- <hr />
- <table width="100%" summary="Navigation footer">
- <tr>
- <td width="40%" align="left"><a accesskey="p" href="gimp-channel-dialog.html"><img src="../images/prev.png" alt="Prev" /></a> </td>
- <td width="20%" align="center">
- <a accesskey="u" href="gimp-dialogs-structure.html">
- <img src="../images/up.png" alt="Up" />
- </a>
- </td>
- <td width="40%" align="right"> <a accesskey="n" href="gimp-indexed-palette-dialog.html"><img src="../images/next.png" alt="Next" /></a></td>
- </tr>
- <tr>
- <td width="40%" align="left" valign="top"><a accesskey="p" href="gimp-channel-dialog.html">2.2. 
- <span lang="en" xml:lang="en">Channels Dialog</span>
- </a> </td>
- <td width="20%" align="center">
- <a accesskey="h" href="index.html">
- <img src="../images/home.png" alt="Home" />
- </a>
- </td>
- <td width="40%" align="right" valign="top"> <a accesskey="n" href="gimp-indexed-palette-dialog.html">2.4. 
- <span lang="en" xml:lang="en">Colormap Dialog</span>
- </a></td>
- </tr>
- </table>
- </div>
- </body>
- </html>
-