1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                       "http://www.docbook.org/xml/4.3/docbookx.dtd">
4<!-- section history:
5  2007-09-25 AntI: Added 'es'
6  2007-02-04 added 'no' by KoSt
7  2006-08-26 lexa: fixed docbook errors
8  yyyy-mm-tt n.n.: added section for context menu
9-->
10
11<sect1 id="gimp-menus-introduction">
12  <title>Introduction to Menus</title>
13  <indexterm>
14    <primary>Menus</primary>
15    <secondary>Introduction</secondary>
16  </indexterm>
17
18  <!--TODO: add image menubar screenshot(?)-->
19  <!--Done-->
20
21  <para>
22    There are many places in <acronym>GIMP</acronym> where you can
23    find menus. The aim of this chapter is to explain all the commands that
24    are accessible from the image menu bar and the image menu you can get by
25    right clicking in the canvas. All the context menus and the menu entries
26    for the other dialogs are described elsewhere in the chapters that
27    describe the dialogs themselves.
28  </para>
29
30  <sect2>
31    <title>The Image Menu Bar</title>
32    <mediaobject>
33      <imageobject>
34        <imagedata fileref="images/menus/image-menu-bar.png"
35                    format="PNG"/>
36      </imageobject>
37    </mediaobject>
38    <para>
39      This menu bar may contain other entries if you have added script-fus,
40      python-fus or videos to your GIMP.
41    </para>
42  </sect2>
43
44  <sect2 id="context-menus">
45    <title>Context Menus</title>
46
47    <indexterm>
48      <primary>Context menus</primary>
49    </indexterm>
50
51    <para>
52      If you right-click on certain parts of the
53      <acronym>GIMP</acronym> interface, a
54      <quote>context menu</quote> opens, which leads to a variety of
55      functions. Some places where you can access context menus are:
56    </para>
57    <itemizedlist>
58      <listitem>
59        <para>
60          Clicking on an image window displays the Image menu. This is useful
61          when you are working in full-screen mode, without a menubar.
62        </para>
63      </listitem>
64      <listitem>
65        <para>
66          Clicking on a layer in the Layers Dialog or on a channel in the
67          Channels Dialog displays functions for the selected layer or
68          channel.
69        </para>
70      </listitem>
71      <listitem>
72        <para>
73          Right-clicking on the image menubar has the same effect as
74          left-clicking.
75        </para>
76      </listitem>
77      <listitem>
78        <para>
79          Right-clicking on the title bar displays functions which do not
80          belong to <acronym>GIMP</acronym>,
81          but to the window manager program on your computer.
82        </para>
83      </listitem>
84    </itemizedlist>
85  </sect2>
86
87  <sect2 id="tear-off-menus">
88    <title>Tear-off menus</title>
89
90    <indexterm>
91      <primary>Tear-off menus</primary>
92    </indexterm>
93    <indexterm>
94      <primary>Tear-off line</primary>
95    </indexterm>
96
97    <para>
98      There is an interesting property associated with some of the menus in
99      <acronym>GIMP</acronym>.
100      These are any of the menus from the Image context menu you get by
101      right-clicking on the canvas and any of its submenus. (You can tell
102      that a menu item leads to a submenu because there is an
103      <guiicon>
104        <inlinegraphic fileref="images/menus/icon-submenu.png" format="PNG"/>
105      </guiicon>
106      icon next to it.) When you bring up any of these menus, there is a
107      dotted line at the top of it (tear-off line). By clicking on this
108      dotted line, you detach the menu under it and it becomes a separate
109      window.
110    </para>
111
112    <figure>
113      <title>
114        The <quote>windows</quote> submenu and its tear-off submenu
115      </title>
116      <mediaobject>
117        <imageobject>
118          <imagedata fileref="images/menus/local-windows-submenu.png"
119                     format="PNG"/>
120        </imageobject>
121      </mediaobject>
122      <mediaobject>
123        <imageobject>
124          <imagedata fileref="images/menus/detached-submenu.png" format="PNG"/>
125        </imageobject>
126      </mediaobject>
127    </figure>
128
129    <para>
130      Tear-off menus are actually independent. They are always visible, their
131      functions always apply to the current image, and they persist when all
132      of the images are closed. You can close a tear-off submenu by clicking
133      on the dotted line again or closing the window from the window manager
134      on your computer (often by clicking on an X icon in the upper right
135      corner of the window).
136    </para>
137    <para>
138      These tear-off submenus are also created in single-window mode, but are
139      of less interest since they are masked by the window as soon as you
140      click on it.
141    </para>
142  </sect2>
143
144  <sect2 id="tab-menus">
145    <title>Tab menus</title>
146
147    <indexterm>
148      <primary>Tab menus</primary>
149    </indexterm>
150
151    <para>
152      The following type of menus is not related to the image menu bar, but
153      for the sake of completeness:
154    </para>
155    <para>
156      Every <link linkend="gimp-concepts-docks">dockable</link> dialog
157      contains a Tab Menu button, as highlighted below. Pressing this Tab
158      Menu button opens a special menu of tab-related operations, with an
159      entry at the top that opens into the dialog's context menu.
160    </para>
161    <figure>
162      <title>A dockable dialog.</title>
163      <mediaobject>
164        <imageobject>
165          <imagedata format="PNG" fileref="images/menus/tab-menu-button.png"/>
166        </imageobject>
167        <caption>
168          <para>A dialog window with the Tab menu button highlighted.</para>
169        </caption>
170      </mediaobject>
171      <mediaobject>
172        <imageobject>
173          <imagedata format="PNG" fileref="images/menus/tab-menu.png"/>
174        </imageobject>
175        <caption>
176          <para>The Tab menu.</para>
177        </caption>
178      </mediaobject>
179    </figure>
180    <para>
181      See <xref linkend="gimp-dockable-menu"/> to learn more about Tab menus.
182    </para>
183  </sect2>
184
185</sect1>
186