1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                       "http://www.docbook.org/xml/4.3/docbookx.dtd">
4<!-- section history:
5  2019-03-03 j.h: update to v2.10
6-->
7<sect2 id="gimp-navigation-dialog">
8  <title>Navigation Dialog</title>
9  <indexterm>
10    <primary>Navigation</primary>
11    <secondary>Dialog</secondary>
12  </indexterm>
13
14  <figure>
15    <title>Navigation Dialog</title>
16    <mediaobject>
17      <imageobject>
18        <imagedata fileref="images/dialogs/navigation.png" format="PNG"/>
19      </imageobject>
20    </mediaobject>
21  </figure>
22  <para>
23    The Navigation dialog is designed to offer easy movement around the active
24    image if the zoom is set higher than what the image window can display. If
25    this is the case, there is an white colored rectangle that shows the
26    location of the current view area in respect to the image. In this
27    rectangle, the mouse pointer takes the form of a grabbing hand; outside
28    this rectangle, it takes the form of a hand with pointing fore-finger.
29  </para>
30  <para>
31    To change the viewing region:
32    <itemizedlist>
33      <listitem>
34        <para>
35          Click outside the rectangular area with the pointing fore-finger on
36          the wanted region.
37        </para>
38      </listitem>
39      <listitem>
40        <para>
41          Click and drag the rectangular area.
42        </para>
43      </listitem>
44      <listitem>
45        <para>
46          Use <keycap>Shift</keycap> and mouse-wheel to move horizontally,
47          <keycap>Alt</keycap> and mouse-wheel to move vertically.
48        </para>
49      </listitem>
50    </itemizedlist>
51  </para>
52
53  <sect3>
54    <title>Activating the dialog</title>
55    <para>
56      The <quote>Navigation</quote> dialog is a dockable dialog; see the section
57      <xref linkend="gimp-concepts-docks"/>
58      for help on manipulating it.
59    </para>
60    <para>
61      You can access it:
62    </para>
63    <itemizedlist>
64      <listitem>
65        <para>
66          from the image menu:
67          <menuchoice>
68            <guimenu>Windows</guimenu>
69            <guisubmenu>Dockable Dialogs</guisubmenu>
70            <guimenuitem>Navigation</guimenuitem>
71          </menuchoice>;
72        </para>
73      </listitem>
74      <listitem>
75        <para>
76          from the Tab menu in any dockable dialog by clicking on
77          <guiicon>
78            <inlinemediaobject>
79              <imageobject><imagedata format="PNG"
80                fileref="images/dialogs/stock-menu-left-12.png"/>
81              </imageobject>
82            </inlinemediaobject>
83          </guiicon> and selecting
84          <menuchoice>
85            <guimenu>Add Tab</guimenu>
86            <guimenuitem>Navigation</guimenuitem>
87          </menuchoice>,
88        </para>
89      </listitem>
90      <listitem>
91        <para>
92          from the image-menu:
93          <menuchoice>
94            <guimenu>View</guimenu>
95            <guimenuitem>Navigation window</guimenuitem>
96          </menuchoice>.
97        </para>
98      </listitem>
99      <listitem>
100        <para>
101          You can access more quickly to it (but without the zoom functions)
102          by clicking on the icon at the right bottom corner of the image window:
103          <mediaobject>
104            <imageobject>
105              <imagedata format="PNG"
106                         fileref="images/dialogs/icon-navigation.png"/>
107            </imageobject>
108          </mediaobject>
109        </para>
110      </listitem>
111    </itemizedlist>
112  </sect3>
113
114  <sect3>
115    <title>Using the Navigation Dialog</title>
116    <variablelist>
117      <varlistentry>
118        <term>The slider</term>
119        <listitem>
120          <para>
121            It allows easy zoom level control, more precise than with the
122            <link linkend="gimp-view-zoom">Zoom</link> command. This slider can
123            also be moved using the mouse wheel when the mouse pointer is on
124            the slider, or <keycap>Ctrl</keycap> and mouse wheel.
125          </para>
126        </listitem>
127      </varlistentry>
128      <varlistentry>
129        <term>The buttons</term>
130        <listitem>
131          <para>
132            <emphasis>Zoom Out</emphasis>
133            <guiicon>
134              <inlinegraphic fileref="images/dialogs/stock-zoom-out-16.png"/>
135            </guiicon>
136            <emphasis>Zoom In</emphasis>
137            <guiicon>
138              <inlinegraphic fileref="images/dialogs/stock-zoom-in-16.png"/>
139            </guiicon>
140            and <emphasis>Zoom 1:1</emphasis>
141            <guiicon>
142              <inlinegraphic
143                fileref="images/dialogs/stock-zoom-original-16.png"/>
144            </guiicon>
145            are self explanatory.
146          </para>
147          <variablelist>
148            <varlistentry>
149              <term>
150                Adjust the zoom ratio so that the image becomes fully visible
151              </term>
152              <listitem>
153                <para>
154                  The zoom ratio is adjusted so that the whole image becomes
155                  visible in the window as it is.
156                </para>
157              </listitem>
158            </varlistentry>
159            <varlistentry>
160              <term>
161                Adjust the zoom ratio so that the window is used optimally
162              </term>
163              <listitem>
164                <para>
165                  The image size and the zoom are adjusted so that the image
166                  is fully displayed with the lesser zoom.
167                </para>
168              </listitem>
169            </varlistentry>
170            <varlistentry>
171              <term>
172                Reduce the image window to the size of the image display
173              </term>
174              <listitem>
175                <para>
176                  Restore the image window to the size which allows the image
177                  to be fully displayed with the zoom unchanged. This command
178                  is also as menu entry available. See
179                  <xref linkend="gimp-view-shrink-wrap"/> for the details.
180                </para>
181              </listitem>
182            </varlistentry>
183          </variablelist>
184        </listitem>
185      </varlistentry>
186    </variablelist>
187  </sect3>
188</sect2>
189