<?xml version="1.0" encoding="utf-8"?>
<?xml-model href="http://docbook.org/xml/5.0/rng/dbits.rng" schematypens="http://relaxng.org/ns/structure/1.0"?><!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
--><?db.chunk.max_depth 2?><article xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="index" xml:lang="en" lang="is">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <info>
    <title lang="en">Image Viewer Manual</title>

    <copyright its:translate="no">
      <year>2015-2021</year>
      <holder>MATE Documentation Project</holder>
    </copyright>
    <copyright its:translate="no">
      <year>2006</year>
      <year>2007</year>
      <holder>GNOME Documentation Project</holder>
    </copyright>
    <copyright its:translate="no">
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <holder>Sun Microsystems</holder>
    </copyright>
    <copyright its:translate="no">
      <year>2000</year>
      <holder>Eliot Landrum</holder>
    </copyright>
    <copyright its:translate="no">
      <year>2000</year>
      <holder>The Free Software Foundation</holder>
    </copyright>

    <publisher role="maintainer">
      <publishername lang="en">MATE Documentation Project</publishername>
    </publisher>
    <publisher>
      <publishername lang="en">GNOME Documentation Project</publishername>
    </publisher>

   <legalnotice xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="legalnotice" xml:lang="en">
         <para lang="en">
           Permission is granted to copy, distribute and/or modify this
           document under the terms of the GNU Free Documentation
           License (GFDL), Version 1.1 or any later version published
           by the Free Software Foundation with no Invariant Sections,
           no Front-Cover Texts, and no Back-Cover Texts.  You can find
           a copy of the GFDL at this <link xlink:href="https://www.gnu.org/licenses/fdl-1.1.html">link</link> or in the file COPYING-DOCS
           distributed with this manual.
          </para>
          <para lang="en"> This manual is part of a collection of MATE manuals
           distributed under the GFDL.  If you want to distribute this
           manual separately from the collection, you can do so by
           adding a copy of the license to the manual, as described in
           section 6 of the license.
         </para>
 
         <para lang="en">
           Many of the names used by companies to distinguish their
           products and services are claimed as trademarks. Where those
           names appear in any MATE documentation, and the members of
           the MATE Documentation Project are made aware of those
           trademarks, then the names are in capital letters or initial
           capital letters.
         </para>
 
         <para lang="en">
           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
           WITH THE FURTHER UNDERSTANDING THAT:
 
           <orderedlist>
                 <listitem>
                   <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                     EXCEPT UNDER THIS DISCLAIMER; AND
                   </para>
                 </listitem>
                 <listitem>
                   <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                        THE POSSIBILITY OF SUCH DAMAGES.
                   </para>
                 </listitem>
           </orderedlist>
         </para>
        <formalpara>
            <title lang="en">Feedback</title>
            <para lang="en">To report a bug or make a suggestion regarding the <application>Image Viewer</application> application or this manual, follow the directions in the <link xlink:href="help:mate-user-guide/feedback">MATE Feedback Page</link>.</para>
        </formalpara>
   </legalnotice>

   <authorgroup its:translate="no">
       <author>
           <orgname its:translate="yes" lang="en">MATE Documentation Project</orgname>
           <affiliation>
               <orgname its:translate="yes" lang="en">MATE Desktop</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Jens</firstname>
               <surname>Finke</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Angela</firstname>
               <surname>Boyle</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Stuart</firstname>
               <surname>Ellis</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname its:translate="yes" lang="en">Sun</firstname>
               <surname its:translate="yes" lang="en">GNOME Documentation Team</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">Sun Microsystems</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Eliot</firstname>
               <surname>Landrum</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Federico</firstname>
               <surname>Mena Quintero</surname>
           </personname>
           <affiliation>
               <orgname its:translate="yes" lang="en">GNOME Documentation Project</orgname>
           </affiliation>
       </author>	
   </authorgroup>
 
    <revhistory its:translate="no">
    <revision>
		<revnumber>2.9</revnumber>
		<date its:translate="yes" lang="en">July 2015</date>
		<revdescription>
	  		<para role="author" its:translate="yes" lang="en">MATE Documentation Project</para>
	  		<para role="publisher" its:translate="yes" lang="en">MATE Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.8</revnumber>
		<date its:translate="yes" lang="en">February 2007</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">GNOME Documentation Project</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.7</revnumber>
		<date its:translate="yes" lang="en">February 2004</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.6</revnumber>
		<date its:translate="yes" lang="en">November 2003</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.5</revnumber>
		<date its:translate="yes" lang="en">September 2003</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.4</revnumber>
		<date its:translate="yes" lang="en">January 2003</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.3</revnumber>
		<date its:translate="yes" lang="en">October 2002</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.2</revnumber>
		<date its:translate="yes" lang="en">August 2002</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.1</revnumber>
		<date its:translate="yes" lang="en">July 2002</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.0</revnumber>
		<date its:translate="yes" lang="en">May 2002</date>
		<revdescription>
		    <para role="author" its:translate="yes" lang="en">Sun GNOME Documentation Team</para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>1.0</revnumber>
		<date>2000</date>
		<revdescription>
		    <para role="author">Eliot Landrum
	    		  <email>eliot@landrum.cx</email>
		    </para>
		    <para role="author">Federico Mena Quintero
	    		  <email>federico@gnu.org</email>
		    </para>
		    <para role="publisher" its:translate="yes" lang="en">GNOME Documentation Project</para>
		</revdescription>
      </revision>
    </revhistory>
    <releaseinfo lang="en">This manual describes version 1.22 of Image Viewer.
    </releaseinfo>
  <othercredit class="translator"><personname><firstname>Samúel Jón Gunnarsson</firstname></personname><email>sammi@techattack.nu</email></othercredit><copyright><year>2003</year><holder>Samúel Jón Gunnarsson</holder></copyright><othercredit class="translator"><personname><firstname>Sveinn í Felli</firstname></personname><email>sv1@fellsnet.is</email></othercredit><copyright><year>2012-2016</year><holder>Sveinn í Felli</holder></copyright></info>

  <indexterm lang="en">
    <primary>Eye of MATE</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->

<!-- ============= Introduction ============================== -->
<section xml:id="eom-introduction"><info><title lang="en">Introduction</title></info>
  
  <para lang="en">The <application>Eye of MATE Image Viewer</application>
  application enables you to view single image files, as well as large image collections.
  </para>

  <section xml:id="eom-tostartapp"><info><title lang="en">Starting Image Viewer</title></info>
    
    <para lang="en">You can start <application>Image Viewer</application> in the following ways:</para>
    <itemizedlist>
      <listitem>
        <para lang="en">Open an image file in <application>Caja</application>.</para>
      </listitem>
      <listitem>
	<para lang="en">Choose <menuchoice><guimenu>Graphics</guimenu>
	<guimenuitem>Image Viewer</guimenuitem></menuchoice>
	from the <guimenu>Applications</guimenu> menu.</para>
      </listitem>
      <listitem>
	<para lang="en">Run <command>eom</command> at the prompt in a terminal
	such as <application>mate-terminal</application>, or from the
	<application>Run Application</application> dialog.</para>
      </listitem>
    </itemizedlist>
  </section>

  <section xml:id="eom-closeapp"><info><title lang="en">Closing Image Viewer</title></info>
    
    <para lang="en">To close the current <application>Image Viewer</application> window choose <menuchoice><guimenu>Image</guimenu>
    <guimenuitem>Close</guimenuitem></menuchoice>, or press
    <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>.</para>
  </section>

  <section xml:id="eom-filetypes"><info><title lang="en">Supported File Types</title></info>
    
    <para lang="en"><application>Image Viewer</application> supports a variety of image file formats. The following image formats can be opened:</para>
		<itemizedlist>
			<listitem><para lang="en">ANI - Animation</para>
			</listitem>
			<listitem><para lang="en">BMP - Windows Bitmap</para>
			</listitem>
			<listitem><para lang="en">GIF - Graphics Interchange Format</para>
			</listitem>
			<listitem><para lang="en">ICO - Windows Icon</para>
			</listitem>
			<listitem><para lang="en">JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para lang="en">PCX - PC Paintbrush </para>
			</listitem>
			<listitem><para lang="en">PNG - Portable Network Graphics </para>
			</listitem>
			<listitem><para lang="en">PNM - Portable Anymap from the PPM Toolkit</para>
			</listitem>
			<listitem><para lang="en">RAS - Sun Raster </para>
			</listitem>
			<listitem><para lang="en">SVG - Scalable Vector Graphics </para>
			</listitem>
			<listitem><para lang="en">TGA - Targa</para>
			</listitem>
			<listitem><para lang="en">TIFF - Tagged Image File Format</para>
			</listitem>
			<listitem><para lang="en">WBMP - Wireless Bitmap</para>
			</listitem>
			<listitem><para lang="en">XBM - X Bitmap</para>
			</listitem>
			<listitem><para lang="en">XPM - X Pixmap</para>
			</listitem>
		</itemizedlist>

  <para lang="en"><application>Image Viewer</application> supports the following formats for saving:</para>
		<itemizedlist>
			<listitem><para lang="en">BMP - Windows Bitmap</para>
			</listitem>
			<listitem><para lang="en">ICO - Windows Icon</para>
			</listitem>
			<listitem><para lang="en">JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para lang="en">PNG - Portable Network Graphics </para>
			</listitem>
		</itemizedlist>
		<para lang="en"><application>Image Viewer</application> may be able to open and save other image formats, depending on your system configuration and other installed software.</para>
  </section>

  <section xml:id="eom-features"><info><title lang="en">Image Viewer Features</title></info>
    
    <para lang="en"><application>Image Viewer</application> has a variety of features to help you view your images.
    You can zoom in and out or view the image full screen. Regardless of
    your zoom level, <application>Image Viewer</application> uses a low amount of memory. You can also
    rotate and flip the image you are viewing.</para>

    <para lang="en">The collection view allows the viewing and editing of large
    image collections. In this view image operations can be applied
    to all selected images at once. </para>

    <para lang="en"><application>Image Viewer</application> has special support for digital camera pictures and
    displays EXIF metadata recorded with the image. This feature
    requires <systemitem class="library">libexif</systemitem> to be
    installed on your system. All modifications made in JPEG images 
    are lossless. That is, saving rotated and flipped JPEG images 
    will not recompress the image. Beside this all available metadata 
    (like EXIF) will be preserved and updated accordingly. </para>
  </section>
</section>

<!--============== When You Start ===========-->
<section xml:id="eom-whenyoustart"><info><title lang="en">Getting Started</title></info>
  
  <para lang="en">When you start <application>Image Viewer</application>, the following window is displayed:</para>
  <figure xml:id="mainwindow-fig" its:translate="no"><info><title its:translate="yes" lang="en">Image Viewer Start Up Window</title></info>
		<screenshot>
		  <mediaobject>
		    <imageobject>
		      <imagedata fileref="figures/eom_start_window.png" format="PNG"/>
		    </imageobject>
		    <textobject>
		      <phrase its:translate="yes" lang="en">Shows <application>Image Viewer</application> main window. Contains titlebar, menubar, toolbar, and display area. Menubar contains File, Edit, View, and Help menus.</phrase>
		    </textobject>
		  </mediaobject>
		</screenshot>
  </figure>
  <para lang="en">The <application>Image Viewer</application> window contains the following elements:</para>
  <variablelist>
	<varlistentry>
  	  <term lang="en">Menubar</term>
 	  <listitem>
	    <para lang="en">The menus on the menubar contain all the commands that you need to work with images in <application>Image Viewer</application>.</para>
	  </listitem>
 	</varlistentry>
	<varlistentry>
	  <term lang="en">Toolbar</term>
	  <listitem>
	    <para lang="en">The toolbar contains a subset of the commands that you can access from the menubar. To show or hide the toolbar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Toolbar</guimenuitem></menuchoice>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term lang="en">Display area</term>
	  <listitem>
 	    <para lang="en">The display area shows the image file.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term lang="en">Statusbar</term>
	  <listitem>
	    <para lang="en">The statusbar provides information about the image. To show or hide the statusbar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term lang="en">Image Collection</term>
	  <listitem>
	    <para lang="en">The image collection shows you all supported images in the current working directory. It shows up once an image has been loaded. To show or hide the collection, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Image Collection</guimenuitem></menuchoice> or press <keycombo><keycap>Ctrl</keycap><keycap>F9</keycap></keycombo>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term lang="en">Side Pane</term>
	  <listitem>
	    <para lang="en">The side pane provides further information about the current image, for example EXIF metadata (if available). It shows up after an image has been loaded. To show or hide the side pane, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Side Pane</guimenuitem></menuchoice> or press <keycap>F9</keycap>.</para>
	  </listitem>
	</varlistentry>
  </variablelist>
  <para lang="en">Most actions in <application>Image Viewer</application> can be performed several ways.  For example,
  you can open a file in the following ways:</para>
  <itemizedlist>
    <listitem><para lang="en">Drag an image file into the <application>Image Viewer</application> window from another
    application or window.</para></listitem>
    <listitem><para lang="en">Double-click on an image file in the file manager
    or other application.</para></listitem>
    <listitem><para lang="en">Choose <menuchoice><guimenu>Image</guimenu>
    <guimenuitem>Open</guimenuitem></menuchoice> and select an image file
    in the <application>Load Image</application> dialog.</para></listitem>
    <listitem><para lang="en">Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap>
    </keycombo> and select an image file in the <application>Load
    Image</application> dialog.</para></listitem>
  </itemizedlist>
</section>


<!-- ============= Viewing Images ============================== -->
<section xml:id="eom-view"><info><title lang="en">Viewing Images</title></info>
	

	<!--=========== To Open an Image ============================= -->
	<section xml:id="eom-open-image"><info><title lang="en">Opening an Image</title></info>
		
                <para lang="en">To open an image, perform the following steps:</para>
                <orderedlist inheritnum="ignore" continuation="restarts">
                  <listitem>
                    <para lang="en">
                      Choose <menuchoice> <guimenu>Image</guimenu><guimenuitem>Open</guimenuitem> </menuchoice>, or press <keycombo> <keycap>Ctrl</keycap><keycap>O</keycap> </keycombo>.  </para>
                  </listitem>
                  <listitem>
                    <para lang="en">
                      In the <guilabel>Open Image</guilabel> dialog, select the file you want to open.
                    </para>
                  </listitem>
                  <listitem>
                    <para lang="en">
                      Click <guibutton>Open</guibutton>. <application>Image Viewer</application> displays the name of the image file in the titlebar of the window.
                    </para>
                  </listitem>
                </orderedlist>
                <para lang="en"> 
	          To open another image, choose <menuchoice> <guimenu>Image</guimenu><guimenuitem>Open</guimenuitem> </menuchoice> again. <application>Image Viewer</application> opens each image in a new window.
                </para>
	</section>

	<!--=========== To View the Images in a Directory ==================== -->
	<section xml:id="eom-open-folder"><info><title lang="en">Viewing the Images in a Folder</title></info>
		
		<para lang="en">To view all images in a folder, perform the following steps:</para>
                <orderedlist inheritnum="ignore" continuation="restarts">
                  <listitem>
                    <para lang="en">
                      Open one of the images in the folder (see <xref linkend="eom-open-image"/>).  </para>
                  </listitem>
                  <listitem>
                    <para lang="en">
                      Open the image collection by choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Image Collection</guimenuitem></menuchoice> or pressing <keycombo><keycap>Ctrl</keycap><keycap>F9</keycap></keycombo>.
                    </para>
                  </listitem>
		</orderedlist>
	     <para lang="en">The collection shows thumbnails of all supported images in the folder. You can browse the images by clicking on an image in the collection, by choosing the appropriate option in the <guimenu>Go</guimenu> menu or by pressing <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo> or <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo>.</para>
             <para lang="en">To view all the directory images in fullscreen, choose <menuchoice> <guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem> </menuchoice> or press <keycap>F11</keycap>. To view them as a slide show, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem></menuchoice> or press <keycap>F5</keycap>. To return to the collection view, press the <keycap>Esc</keycap> key. For more information about how to customize the slide show, see <xref linkend="eom-prefs-slideshow"/>.
                    </para>
	</section>

	<!--============ To Scroll an Image ======================= -->
	<section xml:id="eom-scroll-image"><info><title lang="en">Scrolling an Image</title></info>
		
		<para lang="en">To scroll around an image that is larger than the image window or full screen view, you can use the following methods:</para>
		<itemizedlist>
			<listitem><para lang="en">Use the arrow keys on the keyboard.</para>
			</listitem>
			<listitem><para lang="en">Drag the image to move it in the window. (This means you drag the image in the opposite direction you want to scroll in: to scroll down the image, drag it upwards in the window.)</para>
			</listitem>
			<listitem><para lang="en">Use the scrollbars on the window.</para>
			</listitem>
		</itemizedlist>
	</section>

	<!--=========== To Zoom In and Out ==================== -->
	<section xml:id="eom-zoom"><info><title lang="en">Zooming</title></info>
		
		<para lang="en">You can zoom in or out of the image in the following ways:</para>
			<itemizedlist>
				<listitem><para lang="en">Use the <mousebutton>scroll wheel</mousebutton> on your mouse. Scrolling down zooms out; scrolling up zooms in.</para></listitem>
 			  <listitem><para lang="en">Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem></menuchoice> or <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom Out</guimenuitem></menuchoice>.
 			    To restore the image to its original size, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Normal Size</guimenuitem></menuchoice>.
 			    To make the image fit in the window, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Best Fit</guimenuitem></menuchoice>.</para></listitem>				
 				<listitem><para lang="en">Use the zoom buttons in the toolbar.
 			 <guilabel>Normal</guilabel> will restore the picture to its original unscaled size.
 			 <guilabel>Fit</guilabel> will resize the image so it will fit in the window if it is too large.</para></listitem>

				<listitem><para lang="en">Use the keyboard. To zoom in, <keycombo> <keycap>Ctrl</keycap><keycap>+</keycap> </keycombo> or <keycap>+</keycap>. To zoom out, <keycombo> <keycap>Ctrl</keycap><keycap>-</keycap> </keycombo> or <keycap>-</keycap>. To go back to the normal size, <keycombo> <keycap>Ctrl</keycap><keycap>0</keycap> </keycombo> or <keycap>1</keycap>. To scale the image to fit the window, press <keycap>F</keycap>.</para></listitem>
			</itemizedlist>
			<para lang="en">When an image is zoomed to fit the window, resizing the window will also change the zoom level, so the image still fits the window.</para>
	</section>

	<!--=========== To View Image Fullscreen ==================== -->
	<section xml:id="eom-fullscreen"><info><title lang="en">Viewing an Image Full Screen/Slideshow</title></info>
		
		<para lang="en">To show the image using the entire screen,  choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice>.</para>
		<para lang="en">No panels, window frames, or menubars are visible when an image is shown like this. To return to the normal view, press <keycap>Esc</keycap>, or <keycap>F11</keycap>.</para>
		<para lang="en">You can zoom or scroll around the image in the same way as when it is shown in a window, using the mouse or the keyboard.</para>
		<para lang="en">If you have multiple images in your collection you can press <keycap>Space</keycap> or use the right/left cursor keys to advance to the next image. The previous image can be reached by pressing <keycap>Backspace</keycap> or using the left/up cursor keys.</para>
	<para lang="en">In this case you can also use the slideshow mode, where <application>Image Viewer</application> automatically switches to the next image in your collection. You can start a slideshow by choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem></menuchoice> or by pressing <keycap>F5</keycap>. The slideshow can be paused/continued by pressing <keycap>P</keycap>. To stop the slideshow, press the <keycap>Esc</keycap> or <keycap>F5</keycap> key, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. For more information about how to customize the slide show, see <xref linkend="eom-prefs-slideshow"/>. </para>
	</section>
</section>


<!-- ============= Manipulating Images ============================== -->
<section xml:id="eom-manipulate"><info><title lang="en">Manipulating Images</title></info>
	

	<para lang="en">All image manipulations apply to all selected images at once. The modifications are done
	in memory and alter the original files on disk only when the images are saved with the save function (see <xref linkend="eom-save-image"/>).
	</para>

	<!--============ To Flip an Image ======================= -->
	<section xml:id="eom-flip"><info><title lang="en">Flipping an Image</title></info>
		
		<para lang="en">To flip an image along the horizontal axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Horizontal</guimenuitem>
		</menuchoice>.</para>
		<para lang="en">To flip an image along the vertical axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Vertical</guimenuitem>
		</menuchoice>.</para>
	</section>

	<!--============ To Rotate an Image ======================= -->
	<section xml:id="eom-rotate"><info><title lang="en">Rotating an Image</title></info>
		
		<para lang="en">To rotate an image 90 degrees in a clockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Clockwise</guimenuitem>
		</menuchoice>.</para>
		<para lang="en">To rotate an image 90 degrees in an anticlockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Counterclockwise</guimenuitem>
		</menuchoice>.</para>
	</section>

	<!--============ To Undo an Action ======================= -->
	<section xml:id="eom-undo"><info><title lang="en">Undoing an Action</title></info>
		
		<para lang="en">To undo a flip or rotate action, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Undo</guimenuitem>
		</menuchoice> or press 
		<keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
		.</para>
	</section>

	<!--============ To Delete An Image ======================== -->
	<section xml:id="eom-delete-image"><info><title lang="en">Deleting an Image</title></info>
		
		<para lang="en">To move an image to the Trash, choose
			<menuchoice>
			<guimenu>Edit</guimenu>
			<guimenuitem>Move to Trash</guimenuitem>
			</menuchoice>.
			This moves the file to the Trash folder. Multiple images can also be moved to the trash in the same way: select them all first.</para>
	    <para lang="en">To restore an image from the Trash, open the Trash folder in <application>Caja</application> file manager and move the image file to another folder. To delete the image permanently, empty the Trash. To find out more about using the Trash, see the <link xlink:href="help:mate-user-guide/caja-trash">Desktop User Guide</link>.</para>
				
			<note><para lang="en">You can also use the <keycap>Del</keycap> key to move an image to the Trash, in which case you will be asked for confirmation.</para></note>
			
	</section>
</section> 

<!-- ============= Saving Images ============================== -->
<section xml:id="eom-save-rename"><info><title lang="en">Saving Images</title></info>
	

	<para lang="en">
	<application>Image Viewer</application> always tries to choose the save method with the least impact to the image data. For example, if an otherwise unmodified image is saved under a different name in the same format, the file is simply copied. If <systemitem class="library">libjpeg</systemitem> is available on the system all JPEG image modifications are done without loss of image information.
	</para>

<!--============ To Save an Image ======================= -->
	<section xml:id="eom-save-image"><info><title lang="en">Saving an Image</title></info>
		
		<para lang="en">To save an image, choose 
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save</guimenuitem>
			</menuchoice>.
		The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved.</para>
	</section>

	<!--============ To Save As an Image ======================= -->
	<section xml:id="eom-save-as-image"><info><title lang="en">Saving an Image under a Different Name</title></info>
		
		<para lang="en">To save an image under a different name, or convert it to a different file type, choose
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save As</guimenuitem>
			</menuchoice>.</para>
		<para lang="en">Specify the filename in the <guilabel>Name</guilabel> field in the <guilabel>Save Image</guilabel> dialog, then click <guibutton>Save</guibutton>. The file is saved in the current folder by default. <application>Image Viewer</application> tries to determine the file type from the given filename suffix. If the image should be saved in another folder or the file type detection failed, expand the dialog by clicking on <guilabel>Browse for other folders</guilabel>. This allows further folder navigation and the specification of the file type from the drop down box.</para>
		<para lang="en">You can save multiple images at once: see the next section.</para>
	</section>    

	<!--============ To Save As an Image ======================= -->
	<section xml:id="eom-save-as-multiple"><info><title lang="en">Saving Multiple Images</title></info>
		
		<para lang="en">Saving multiple images at once allows you to convert several images to a different format, or give them similar filenames.</para>
		<para lang="en">To save multiple images, select the images and choose 
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save As</guimenuitem>
			</menuchoice>. 		
		The following window is displayed:</para>
  		<figure xml:id="saveas-dialog-fig" its:translate="no"><info><title its:translate="yes" lang="en">Save As dialog for multiple images</title></info>
			<screenshot>
			  <mediaobject>
			    <imageobject>
			      <imagedata fileref="figures/eom_save_as_window.png" format="PNG"/>
			    </imageobject>
			    <textobject>
			      <phrase its:translate="yes" lang="en">Shows Eye of MATE <guilabel>Save As</guilabel> dialog when saving multiple images.</phrase>
			    </textobject>
			  </mediaobject>
			</screenshot>
  		</figure>
		<para lang="en">The folder in which the images will be saved is specified by the <guilabel>Destination folder</guilabel> drop-down box. Initially the folder is set to the current folder. Select <guilabel>Other...</guilabel> from the drop-down list to open a standard open folder dialog for browsing the filesystem. The resulting filename for each image is specified by <guilabel>Filename format</guilabel>. The filename schema is constructed by simple
		characters and special tags. The following special tags are available: </para>
		<itemizedlist>
			<listitem><para lang="en"><guilabel>Filename (%f)</guilabel> - Original filename without the fileformat suffix.</para>
			</listitem>
			<listitem><para lang="en"><guilabel>Counter (%n)</guilabel> - Auto-incremented number (starts at specified counter start).</para>
			</listitem>			
		</itemizedlist>	
		<para lang="en">Everything but these special tags are considered normal text.</para>
		<para lang="en">The image format is determined by the drop-down box after the schema definition. Select a specific image format or use the 
		<guilabel>as is</guilabel> option to state that the same format as the original file should be used.</para>
	
		<para lang="en">The <guilabel>Options</guilabel> section allows to remove all space characters by underscores in the resulting filename if <guilabel>Replace spaces with underscores</guilabel> is checked. The <guilabel>Start counter at</guilabel> spin box determines at which number the counter starts if you use the %n tag for the file format specification.</para>
		<para lang="en">The <guilabel>File Name Preview</guilabel> section of the dialog shows the resulting file name according to the above settings for an example filename from the selected images.
		</para>
	</section>



</section>

<section xml:id="eom-print"><info><title lang="en">Printing Images</title></info>
	
	<section xml:id="eom-print-pagesettings"><info><title lang="en">Setting your Page Settings</title></info>
		
		<para lang="en">Before printing you need to set the page settings you would like to use. To do that choose <menuchoice><guimenu>Image</guimenu><guimenuitem>Print</guimenuitem></menuchoice>.</para>
		<para lang="en">In the <guilabel>Page Setup</guilabel> dialog you can now choose paper size and orientation. If possible, configure your printer to have the page borders set correctly.</para>
	</section>

	<section xml:id="eom-print-image"><info><title lang="en">Printing an Image</title></info>
		
		<para lang="en">To print an image, perform the following steps:</para>
		<orderedlist inheritnum="ignore" continuation="restarts">
			<listitem>
				<para lang="en">Select <menuchoice><guimenu>Image</guimenu><guimenuitem>Print</guimenuitem></menuchoice></para>
			</listitem>
			<listitem>
				<para lang="en">In the <guilabel>Print</guilabel> dialog, select the printer you want to use from the list.</para>
			</listitem>
			<listitem>
				<para lang="en">Click <guilabel>Print</guilabel>. <application>Image Viewer</application> starts printing now.</para>
			</listitem>
		</orderedlist>
		<para lang="en">Images that are too large for the page are automatically scaled down to fit the page. Images that are smaller than the page are centered on it.</para>
		<important>
			<para lang="en">Please note that <application>Image Viewer</application> is currently lacking progress reporting while printing. During that time the user interface might become unresponsive for a short time.</para>
		</important>
	</section>

	<section xml:id="eom-print-settings"><info><title lang="en">Arranging an Image on the Page</title></info>
		
		<para lang="en">Maybe you don't want your image centered or want it scaled down even further. To do that you need to open the <guilabel>Print</guilabel> dialog (see <xref linkend="eom-print-image"/>) and then select the <guilabel>Image Settings</guilabel> tab which offers you the following options:</para>
		<itemizedlist>
			<listitem>
				<para lang="en">The options in the <guilabel>Position</guilabel> section allow you to change the images position on the page.</para>
			</listitem>
			<listitem>
				<para lang="en">It is also possible to position the image on the page by dragging it around in the <guilabel>Preview</guilabel> field.</para>
			</listitem>
			<listitem>
				<para lang="en">The options in the <guilabel>Size</guilabel> section allow you to scale your image to your liking. Scaling is limited by either the image size or by the page size, depending on what condition is met first.</para>
			</listitem>
			<listitem>
				<para lang="en">The <guilabel>Unit</guilabel> option allows you to change the metric unit which is used by the options on the <guilabel>Image Settings</guilabel> tab. When you change this option the other fields values are converted accordingly.</para>
			</listitem>
		</itemizedlist>
	</section>
		
</section>
<section xml:id="eom-toolbareditor"><info><title lang="en">Personalizing The Toolbar</title></info>
	
	<para lang="en">Image Viewer's default toolbar contains only a basic set of items to keep it simple. But you can modify the toolbar if you prefer a different set.</para>
	<section xml:id="eom-toolbareditor-use"><info><title lang="en">Modifying the Toolbar</title></info>
		
		<para lang="en">If you want to modify the toolbar you need to open the toolbar editor by going to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Toolbar</guimenuitem></menuchoice>. The following window will pop up:</para>
		<figure xml:id="toolbar-editor-fig" its:translate="no"><info><title its:translate="yes" lang="en">The toolbar editor window</title></info>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="figures/eom_toolbar_editor_window.png" format="PNG"/>
					</imageobject>
					<textobject>
						<phrase its:translate="yes" lang="en">Shows Eye of MATE toolbar editor window.</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
		</figure>
		<para lang="en">It contains the items that are not in the toolbar and the separator item. You can now edit the toolbar:</para>
		<itemizedlist>
			<listitem>
				<para lang="en">To add new items to the toolbar, drag them from the toolbar editor to the toolbar.</para>
			</listitem>
			<listitem>
				<para lang="en">To remove items from the toolbar, drag them from the toolbar to the toolbar editor.</para>
			</listitem>
			<listitem>
				<para lang="en">To rearrange items on the toolbar, drag them to their new position on the toolbar.</para>
			</listitem>
		</itemizedlist>
		<para lang="en">When you have finished editing the toolbar, click the <guibutton>Close</guibutton> button in the toolbar editor window. This will close the toolbar editor and make your modified toolbar active.</para>
		</section>
		<section xml:id="eom-toolbareditor-reset"><info><title lang="en">Resetting the Toolbar</title></info>
			
			<para lang="en">To revert your changes to the toolbar and return to the default layout, perform the following steps:</para>
			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para lang="en">Open the toolbar editor (see <xref linkend="eom-toolbareditor-use"/>).</para>
				</listitem>
				<listitem>
					<para lang="en">Click the <guibutton>Reset to Default</guibutton> button.</para>
				</listitem>
				<listitem>
					<para lang="en">Click the <guibutton>Close</guibutton> button to close the toolbar editor. The toolbar has been reset to the default layout now.</para>
				</listitem>
			</orderedlist>
		</section>
</section>
<section xml:id="eom-prefs"><info><title>Kjörstillingar</title></info>
	
	<para lang="en">Preferences can be changed by going to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. You will be able to change the options for image viewing and slide shows. The changes apply to all open windows instantly.</para>

	<!--============ Image View ======================= -->
  <section xml:id="eom-prefs-image"><info><title>Myndasýn</title></info>
         
	<variablelist>
	<varlistentry>
		<term lang="en"><guilabel>Image Enhancements</guilabel></term>
		<listitem>
		<para lang="en">Select the <guilabel>Smooth images when zoomed</guilabel> option to enable image smoothing when you change the image's zoom factor. If you select this option, your images will be smoothed to improve their display quality while viewing them with <application>Image Viewer</application>.</para>
                <para lang="en">If you select the <guilabel>Automatic orientation</guilabel> option, your images will be rotated on loading according to their metadata. For example portraits are automatically rotated upright. Note that this function requires a correctly set orientation tag in the image's metadata and thus does not work with all images. The rotation is not saved until you save the rotated image (see <xref linkend="eom-save-rename"/>).</para>
		</listitem>
	</varlistentry>

	<varlistentry>
		<term lang="en"><guilabel>Transparent Parts</guilabel></term>
		<listitem>
		<para lang="en">Select one of the following options to determine how <application>Image Viewer</application> displays transparent parts of an image:</para>
		<itemizedlist>
			<listitem><para lang="en"><guilabel>As check pattern</guilabel> </para>
			<para lang="en">Displays any transparent parts of the image in a check pattern.</para>
			</listitem>
			<listitem><para lang="en"><guilabel>As custom color</guilabel> </para>
			<para lang="en">Displays any transparent parts of the image in a solid color that you specify. Click on the color selector button to select a color. </para>
			</listitem>
			<listitem><para lang="en"><guimenuitem>As background</guimenuitem> </para>
			<para lang="en">Displays any transparent parts of the image in the background color of the <application>Image Viewer</application> application. </para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>		
	</variablelist>
  </section>
		
	<!--============ Slide Show ==================-->                                                                                               
  <section xml:id="eom-prefs-slideshow"><info><title>Skyggnusýning</title></info>
         
	<variablelist>
	<varlistentry>
		<term lang="en"><guilabel>Image Zoom</guilabel></term>
		<listitem>
		<para lang="en">Select the <guilabel>Expand images to fit screen</guilabel> option to enlarge images to fit the screen during the slide show. If you do not select this option, images that are smaller than the screen size are not resized to fit the screen.</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term lang="en"><guilabel>Sequence</guilabel></term>
		<listitem>
		<para lang="en">Select the <guilabel>Loop sequence</guilabel> option to cycle endlessly through the list of images during the slide show. If you do not select this option, the slide show returns to the collection view after the last image is displayed.
</para>
		<para lang="en">Use the <guilabel>Switch image after ... seconds</guilabel> spin box to specify how long each image is displayed during the slide show. If you set this value to zero, the auto advance function is disabled and only manual browsing is available (see <xref linkend="eom-fullscreen"/>).
</para>
		</listitem>
	</varlistentry>		
	</variablelist>
  </section>
</section>
</article>
