doc/gwenview/interface.docbook

   1 <chapter id="interface">
   2 <title>The interface</title>
   3
   4 <section id='image_operations'><title>Image Operations</title>
   5 <para>Gwenview has a few features which are available in both Browse, View, and
   6 Full Screen view. Gwenview has the capability to do basic alteration of your
   7 images.</para>
   8 <itemizedlist>
   9 <listitem><para>Rotate: A rotate operation will rotate the image either to the left
  10 or to the right, depending on whether you do
  11   <menuchoice>
  12     <shortcut>
  13 <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
  14     </shortcut>
  15     <guimenu>Edit</guimenu>
  16     <guimenuitem>Rotate Right</guimenuitem>
  17   </menuchoice>
  18 or
  19   <menuchoice>
  20     <shortcut>
  21 <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
  22     </shortcut>
  23     <guimenu>Edit</guimenu>
  24     <guimenuitem>Rotate Left</guimenuitem>
  25   </menuchoice> </para></listitem>
  26
  27 <listitem><para>
  28  <menuchoice>
  29   <guimenu>Edit</guimenu>
  30   <guimenuitem>Mirror</guimenuitem>
  31  </menuchoice>:
  32  This operation will reflect the image along the vertical
  33 axis, as if you were seeing it in a mirror.</para></listitem>
  34
  35 <listitem><para>
  36  <menuchoice>
  37   <guimenu>Edit</guimenu>
  38   <guimenuitem>Flip</guimenuitem>
  39  </menuchoice>:
  40 This operation will reflect the image upside-down (a
  41 reflection along the horizontal axis)</para></listitem>
  42
  43 <listitem><para>
  44  <menuchoice>
  45   <guimenu>Edit</guimenu>
  46   <guimenuitem>Resize</guimenuitem>
  47  </menuchoice>:
  48 This operation will allow you to shrink or expand the image. Note that if you
  49 increase the size of an image, it may appear
  50 blurry and/or pixelated.</para></listitem>
  51
  52 <listitem><para>
  53  <menuchoice>
  54   <guimenu>Edit</guimenu>
  55   <guimenuitem>Crop</guimenuitem>
  56  </menuchoice>:
  57  This operation lets you discard parts of the image you don't want.
  58 </para></listitem>
  59
  60 </itemizedlist>
  61 </section>
  62
  63 <section id='browse_mode'><title>Browse Mode</title>
  64
  65 <para>When in Browse Mode, you can easily navigate through your files and folders.
  66   The preview window shows thumbnails of the images in the current folder, as
  67   well as subfolders. </para>
  68
  69
  70 <screenshot>
  71   <screeninfo>Browse Mode Screenshot</screeninfo>
  72   <mediaobject>
  73     <imageobject>
  74       <imagedata fileref="browse_mode.png" format="PNG" />
  75     </imageobject>
  76   </mediaobject>
  77 </screenshot>
  78
  79 <para>
  80   Moving the mouse over an image shows buttons to rotate the image as well as
  81   a button to enter Fullscreen Mode. Clicking on an image takes you into View
  82   Mode. The sidebar on the right does not appear
  83   by default, but its appearance can be toggled using
  84   <menuchoice>
  85     <shortcut>
  86       <keycap>F11</keycap>
  87     </shortcut>
  88     <guimenu>View</guimenu>
  89     <guimenuitem>Show/Hide Sidebar</guimenuitem>
  90   </menuchoice>
  91   or using the <guiicon>Show/Hide Sidebar</guiicon> button. Note that the
  92   option will appear as either <guiicon>Show Sidebar</guiicon> or <guiicon>Hide
  93   Sidebar</guiicon>, depending on whether the sidebar is currently shown. The
  94   slider at the bottom right allows you to change the size of the image
  95   thumbnails. You can also filter the images by filename using the box on the
  96   lower left. The toolbar (left) appears in both Browse mode as well as View
  97   mode and contains the most commonly used actions. </para>
  98 <itemizedlist>
  99 <listitem><para>Browse: Switches to Browse Mode.</para></listitem>
 100 <listitem><para>View: Switches to View Mode.</para></listitem>
 101 <listitem><para>Full Screen: Switches to Full Screen Mode.</para></listitem>
 102 <listitem><para>Go to Previous Image: Clicking this icon will go
 103 to the previous image in the folder.</para></listitem>
 104
 105 <listitem><para>Go to Next Image: Clicking this button will go to
 106 the next image in the folder.</para></listitem>
 107
 108 <listitem><para>Rotate Left/Right: Same as discussed in
 109 Image Operations</para></listitem>
 110
 111 <listitem><para>Show Sidebar: Shows the sidebar (right) which
 112 displays information about the current image.</para></listitem>
 113 </itemizedlist>
 114
 115 </section>
 116
 117 <section id='view_mode'><title>View Mode</title>
 118 <para>View Mode displays one image at a time. At the bottom, there is the
 119 Thumbnail Bar, which allows you to scroll through the images in the current
 120 folder. The Thumbnail Bar can be minimized by clicking on the Thumbnail Bar
 121 button. Clicking again will restore it. </para>
 122
 123 <screenshot>
 124   <screeninfo>View Mode Screenshot</screeninfo>
 125   <mediaobject>
 126     <imageobject>
 127       <imagedata fileref="view_mode.png" format="PNG" />
 128     </imageobject>
 129   </mediaobject>
 130 </screenshot>
 131
 132 <para>The slider at the bottom right controls the zoom of the image. The
 133 <guiicon>Zoom to Fit</guiicon> button and the <guiicon>Actual Size</guiicon>
 134 button are next to the zoom slider and are two preset zoom levels. The
 135 <guiicon>Zoom to Fit</guiicon> button zooms the current image to fit the size
 136 of the window, and the <guiicon>Actual Size</guiicon> button zooms the image to
 137 the actual pixel size.</para>
 138
 139 <tip><para>You can start directly in View mode by starting &kappname; from a
 140 context menu like Open With in another program or by launching it from the
 141 command line with an image as an argument.</para> </tip>
 142
 143 </section>
 144
 145 <section id='fullscreen_mode'><title>Full Screen Mode</title>
 146
 147 <para>The Full Screen Mode shows a slideshow of your images. Access Full Screen
 148 Mode by clicking on the button that appears when you move the mouse over the
 149 thumbnails in Browse Mode, by pressing the <guiicon>Full Screen</guiicon>
 150 button on the taskbar, or by
 151   <menuchoice>
 152     <shortcut>
 153 <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
 154     </shortcut>
 155     <guimenu>View</guimenu>
 156     <guimenuitem>Full Screen Mode</guimenuitem>
 157   </menuchoice>.</para>
 158
 159 <screenshot>
 160   <screeninfo>Full Screen Mode Screenshot</screeninfo>
 161   <mediaobject>
 162     <imageobject>
 163       <imagedata fileref="fullscreen_mode.png" format="PNG" />
 164     </imageobject>
 165   </mediaobject>
 166 </screenshot>
 167
 168 <para>The top bar will hide itself automatically; to show it simply move the
 169 mouse to the top of the screen. If the mouse cursor is over the top bar, it
 170 will not autohide. Most of the buttons on the bar are the same as the ones on
 171 the toolbar in Browse or View Modes, except for the <guiicon>Exit Full
 172 Screen Mode</guiicon> button which returns you to the &kappname; window, the
 173 <guiicon>Start/Stop Slideshow</guiicon> button, and the
 174 <guiicon>Configure Full Screen Mode</guiicon> button which shows a
 175 small settings dialog that allows you to easily and quickly configure the
 176 slideshow. The slideshow controls there are: </para>
 177
 178 <itemizedlist>
 179         <listitem><para>The Interval slider controls how long &kappname; will show
 180         an image before it move to the next one.</para></listitem>
 181         <listitem><para>If the Loop checkbox is checked, when the end of the
 182         slideshow is reached, it will continue from the beginning instead of
 183         stopping. </para></listitem>
 184         <listitem><para>If the Random checkbox is checked, instead of progressing
 185         through the folder alphabetically, images will be shown in random
 186         order.</para></listitem>
 187 </itemizedlist>
 188
 189 <para>Also in the top bar is an area that shows you the other images in the
 190 current folder. Clicking on one will display it.</para>
 191
 192 </section>
 193
 194
 195 </chapter>
 196 <!-- vim: set ft=xml: -->