<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.8">
  <!ENTITY manrevision "2.8">
  <!ENTITY date "September 2004">
  <!ENTITY app "<application>Image Viewer</application>">
  <!ENTITY appname "Image Viewer">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&appname; Manual</title>

    <copyright> 
      <year>2002</year> 
      <year>2003</year> 
      <year>2004</year> 
      <holder>Sun Microsystems</holder> 
    </copyright> 
    <copyright> 
      <year>2000</year> 
      <holder>Eliot Landrum</holder> 
    </copyright>
    <copyright> 
      <year>2000</year> 
      <holder>The Free Software Foundation</holder> 
    </copyright>	 
<!-- translators: uncomment this:

  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->
   <authorgroup>
   <author> 
	<firstname>Jens</firstname> 
	<surname>Finke</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname>
	</affiliation>
	<email>jens@triq.net</email> 
   </author>
   <author> 
	<firstname>Angela</firstname> 
	<surname>Boyle</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname>
	</affiliation>
	<email>aboyle@aboyle.com</email> 
   </author>
   <author> 
	<firstname>Stuart</firstname> 
	<surname>Ellis</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname>
	</affiliation>
	<email>s.ellis@ftml.net</email> 
   </author>
   <author> 
	<firstname>Sun</firstname> 
	<surname>GNOME Documentation Team</surname> 
	<affiliation> 
	  <orgname>Sun Microsystems</orgname>  
	</affiliation> 
   </author> 
   <author> 
	<firstname>Eliot</firstname> 
	<surname>Landrum</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	</affiliation> 
	<email>eliot@landrum.cx</email>
   </author> 
   <author> 
	<firstname>Federico</firstname> 
	<surname>Mena Quintero</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	</affiliation> 
	<email>federico@gnu.org</email> 
   </author>	
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <email>translator@gnome.org</email> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>
 
    <revhistory>
    <revision> 
		<revnumber>&appname; Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
	  		<para role="author">GNOME Documentation Project</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision>
		<revnumber>&appname; Manual V2.7</revnumber>
		<date>February 2004</date>
		<revdescription>
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.6</revnumber> 
		<date>November 2003</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.5</revnumber> 
		<date>September 2003</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.4</revnumber> 
		<date>January 2003</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.3</revnumber> 
		<date>October 2002</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.2</revnumber> 
		<date>August 2002</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>Eye of GNOME Manual V2.1</revnumber> 
		<date>July 2002</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision> 
		<revnumber>Eye of GNOME Manual V2.0</revnumber> 
		<date>May 2002</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision> 
		<revnumber>Eye of GNOME User's Guide</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">GNOME Documentation Project</para>
		</revdescription> 
      </revision> 
    </revhistory> 
    <releaseinfo>This manual describes version &appversion; of &appname;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &appname; application or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm>
    <primary>Eye of GNOME</primary> 
  </indexterm> 

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

<!-- ============= Introduction ============================== -->
<sect1 id="eog-introduction">
  <title>Introduction</title>
  <para>The <application>Eye of GNOME Image Viewer</application>
  application enables you to view single image files, as well as large image collections.
  </para>

  <sect2 id="eog-tostartapp">
    <title>Starting &appname;</title>
    <para>You can start &app; in the following ways:</para>
    <itemizedlist>
      <listitem>
	<para>Choose <menuchoice><guimenu>Graphics</guimenu>
	<guimenuitem>Image Viewer</guimenuitem></menuchoice>
	from the <guimenu>Applications</guimenu> menu.</para>
      </listitem>
      <listitem>
	<para>Run <command>eog</command> at the prompt in a terminal
	such as <application>gnome-terminal</application>, or from the
	<application>Run Application</application> dialog.</para>
      </listitem>
    </itemizedlist>
  </sect2>

  <sect2 id="eog-closeapp">
    <title>Closing &appname;</title>
    <para>To close a &app; window choose <menuchoice><guimenu>File</guimenu>
    <guimenuitem>Close</guimenuitem></menuchoice>, or press
    <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>.
    This will shut down the window you are currently in.</para>
  </sect2>

  <sect2 id="eog-filetypes">
    <title>Supported File Types</title>
    <para>&app; supports a variety of image file formats. The
    <systemitem class="library">GdkPixbuf</systemitem> library determines
    which file formats &app; can load and save.  If the appropriate plugins
    are installed on your system, &app; will be able to open more image
    formats than those listed below.  The following list is the default
    supported file formats for reading:</para>
		<itemizedlist>
			<listitem><para>ANI - Animation</para>
			</listitem>
			<listitem><para>BMP - Windows Bitmap</para>
			</listitem>
			<listitem><para>GIF - Graphics Interchange Format</para>
			</listitem>
			<listitem><para>ICO - Windows Icon</para>
			</listitem>
			<listitem><para>JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para>PCX - PC Paintbrush </para>
			</listitem>
			<listitem><para>PNG - Portable Network Graphics </para>
			</listitem>
			<listitem><para>PNM - Portable Anymap from the PPM Toolkit</para>
			</listitem>
			<listitem><para>RAS - Sun Raster </para>
			</listitem>
			<listitem><para>SVG - Scaleable Vector Graphics </para>
			</listitem>
			<listitem><para>TGA - Targa</para>
			</listitem>
			<listitem><para>TIFF - Tagged Image File Format</para>
			</listitem>
			<listitem><para>WBMP - Wireless Bitmap</para>
			</listitem>
			<listitem><para>XBM - X Bitmap</para>
			</listitem>
			<listitem><para>XPM - X Pixmap</para>
			</listitem>
		</itemizedlist>

  <para>&app; supports the following formats for saving by default:</para>
		<itemizedlist>
			<listitem><para>ICO - Windows Icon</para>
			</listitem>
			<listitem><para>JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para>PNG - Portable Network Graphics </para>
			</listitem>
		</itemizedlist>
  </sect2>

  <sect2 id="eog-features">
    <title>&appname; Features</title>
    <para>&app; 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, &app; uses a low amount of memory. You can also
    rotate and flip the image you are viewing.</para>

    <para>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>&app; 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. If <systemitem
    class="library">libjpeg</systemitem> is also available all JPEG
    image modifications 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>
  </sect2>
</sect1>

<!--============== When You Start ===========-->
<sect1 id="eog-whenyoustart">
  <title>Getting Started</title>
  <para>When you start &app;, the following window is displayed:</para>
  <figure id="mainwindow-fig">
		<title>&appname; Start Up Window</title>
		<screenshot>
		  <mediaobject>
		    <imageobject>
		      <imagedata fileref="figures/eog_start_window.png" format="PNG"/>
		    </imageobject>
		    <textobject>
		      <phrase>Shows Eye of GNOME main window. Contains titlebar, menubar, toolbar, and display area. Menubar contains File, Edit, View, and Help menus.</phrase>
		    </textobject>
		  </mediaobject>
		</screenshot>
  </figure>
  <para>The &app; window contains the following elements:</para>
  <variablelist>
	<varlistentry>
  	  <term>Menubar</term>
 	  <listitem>
	    <para>The menus on the menubar contain all of the commands that you need to work with files in &app;.</para>
	  </listitem>
 	</varlistentry>
	<varlistentry>
	  <term>Toolbar</term>
	  <listitem>
	    <para>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>Display area</term>
	  <listitem>
 	    <para>The display area displays the image file.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Statusbar</term>
	  <listitem>
	    <para>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>
  </variablelist>
  <para>Most actions in &app; can be performed several ways.  For example,
  you can open a file in the following ways:</para>
  <itemizedlist>
    <listitem><para>Drag an image file into the &app; window from another
    application or window.</para></listitem>
    <listitem><para>Double-click on an image file in the file manager
    or other application.</para></listitem>
    <listitem><para>Choose <menuchoice><guimenu>File</guimenu>
    <guimenuitem>Open</guimenuitem></menuchoice> and select an image file
    in the <application>Load Image</application> dialog.</para></listitem>
    <listitem><para>Click on the <guibutton>Open</guibutton> toolbar button
    and select an image file in the <application>Load Image</application>
    dialog.</para></listitem>
    <listitem><para>Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap>
    </keycombo> and select an image file in the <application>Load
    Image</application> dialog.</para></listitem>
  </itemizedlist>
</sect1>


<!-- ============= Viewing Images ============================== -->
<sect1 id="eog-view">
	<title>Viewing Images</title>

	<!--=========== To Open an Image ============================= -->
	<sect2 id="eog-open-image">
		<title>To Open an Image</title>
                <para>To open an image, perform the following steps:</para>
                <orderedlist>
                  <listitem>
                    <para>
                      Choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice>, or press <keycombo> <keycap>Ctrl</keycap><keycap>O</keycap> </keycombo>.  </para>
                  </listitem>
                  <listitem>
                    <para>
                      In the <guilabel>Load Image</guilabel> dialog, select the file you want to open.
                    </para>
                  </listitem>
                  <listitem>
                    <para>
                      Click <guibutton>Open</guibutton>. &app; displays the name of the image file in the titlebar of the window.
                    </para>
                  </listitem>
                </orderedlist>
                <para> 
	          To open another image, choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice> again. &app; opens each image in a new window. To explicitly open a new window, choose <menuchoice> <guimenu>File</guimenu><guimenuitem>New</guimenuitem> </menuchoice>, or click the <guibutton>New</guibutton> button, or press <keycombo> <keycap>Ctrl</keycap><keycap>N</keycap> </keycombo>.
                </para>
                <para>
	          If you try to open an image file format that &app; does not recognize, the application displays an error message.
                </para>
	</sect2>

	<!--=========== To View the Images in a Directory ==================== -->
	<sect2 id="eog-open-folder">
		<title>To View the Images in a Folder</title>
		<para>To view all images in a folder, perform the following steps:</para>
                <orderedlist>
                  <listitem>
                    <para>
                      Choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open Directory</guimenuitem> </menuchoice>, or press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.  </para>
                  </listitem>
                  <listitem>
                    <para>
                      In the <guilabel>Open Folder</guilabel> dialog, select the directory you want to open.
                    </para>
                  </listitem>
                  <listitem>
                    <para>
                      Click <guibutton>Open</guibutton>.  &app; displays all of the images in the directory in one &app; window. This is known as the collection view.
                    </para>
                  </listitem>
		</orderedlist>
             <para>To view all of the images in the directory as a slide show, choose <menuchoice> <guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem> </menuchoice>. To return to the collection view, press the <keycap>Esc</keycap> or <keycap>F11</keycap> key, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. For more information about how to customize the slide show, see <xref linkend="eog-prefs-slideshow"/>.
                    </para>
	</sect2>

	<!--============ To Scroll an Image ======================= -->
	<sect2 id="eog-scroll-image">
		<title>To Scroll an Image</title>
		<para>To scroll around an image that is larger than the image window or full screen window, you can use the following methods:</para>
		<itemizedlist>
			<listitem><para>Use the arrow keys on the keyboard.</para>
			</listitem>
			<listitem><para>Drag the image opposite to the direction in which you want to scroll. For example, if you want to scroll down the image, drag the image upwards in the window.</para>
			</listitem>
			<listitem><para>Use the scrollbars on the window.</para>
			</listitem>
		</itemizedlist>
	</sect2>

	<!--=========== To Zoom In and Out ==================== -->
	<sect2 id="eog-zoom">
		<title>To Zoom In or Out</title>
		<para>You can zoom in or out of the image through a variety of methods.</para>
			<itemizedlist>
				<listitem><para>You can use the middle mouse button to scroll in and out. Scrolling down zooms out; scrolling up zooms in.</para></listitem>
 				<listitem><para>You can use the zoom buttons in the toolbar. They are also located in the <guimenu>View</guimenu>. You can zoom in and zoom out. <guilabel>Normal</guilabel> will restore the picture to its original unscaled size. <guilabel>Best Fit</guilabel> will resize the image so it will fit in the window and adapt the size on window resizing.</para></listitem>
				<listitem><para>The zoom options also have shortcuts. 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>=</keycap> </keycombo> or <keycap>1</keycap>. The best fit mode can be entered by pressing <keycap>F</keycap>.</para></listitem>
			</itemizedlist>
	</sect2>

	<!--=========== To View Image Fullscreen ==================== -->
	<sect2 id="eog-fullscreen">
		<title>To View Image Full Screen/Slideshow</title>
		<para>To display the image in full-screen mode, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice>. Full-screen mode displays the image in a window that fills the full screen. The window does not contain a window frame, titlebar, menubar, or toolbar. To exit from this mode, press the <keycap>Esc</keycap> or <keycap>F11</keycap> key, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. To zoom into or pane around the image the same things apply as for the window mode.</para>
	<para>If multiple images are displayed (collection view) the &app; enters the slideshow mode when in fullscreen. To advance to the next image press <keycap>Space</keycap> or use the right/down cursor keys. The previous image can be reached by pressing <keycap>Backspace</keycap> or using the left/up cursor keys. If configured &app; can also auto advance to the next picture after a specified timeout (see <xref linkend="eog-prefs-slideshow"/>). In this mode the manual navigation still works and the auto advance function can be paused/continued by pressing <keycap>P</keycap>.</para>
	</sect2>
</sect1>


<!-- ============= Manipulating Images ============================== -->
<sect1 id="eog-manipulate">
	<title>Manipulating Images</title>

	<para>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="eog-save-image">save</xref>).
	</para>

	<!--============ To Flip an Image ======================= -->
	<sect2 id="eog-flip">
		<title>To Flip an Image</title>
		<para>To flip an image along the horizontal axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Horizontal</guimenuitem>
		</menuchoice>.</para>
		<para>To flip an image along the vertical axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Vertical</guimenuitem>
		</menuchoice>.</para>
	</sect2>

	<!--============ To Rotate an Image ======================= -->
	<sect2 id="eog-rotate">
		<title>To Rotate an Image</title>
		<para>To rotate an image 90 degrees in a clockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Clockwise</guimenuitem>
		</menuchoice>.</para>
		<para>To rotate an image 90 degrees in an anticlockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Counter Clockwise</guimenuitem>
		</menuchoice>.</para>
		<para>To rotate an image 180 degrees in a clockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate 180 Degrees</guimenuitem>
		</menuchoice>.</para>
	</sect2>

	<!--============ To Undo an Action ======================= -->
	<sect2 id="eog-undo">
		<title>To Undo an Action</title>
		<para>To undo a flip or rotate action, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Undo</guimenuitem>
		</menuchoice>.</para>
	</sect2>

	<!--============ To Delete An Image ======================== -->
	<sect2 id="eog-delete-image">
		<title>To Delete an Image</title>
		<para>To delete an image 
			<menuchoice>
			<guimenu>Edit</guimenu>
			<guisubmenu>Delete</guisubmenu>
			</menuchoice>.
			This operation applies to all currently selected images. You may also use <keycap>DEL</keycap>.
			&app; will ask you to confirm this operation before deleting the images from disk. After deletion the images can be restored from trash. Only when the trash is emptied the files are really lost.
		</para>
	</sect2>
</sect1> 

<!-- ============= Saving ============================== -->
<sect1 id="eog-save-rename">
	<title>Saving</title>

	<para>
	&app; always tries to choose the save method with 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 ======================= -->
	<sect2 id="eog-save-image">
		<title>To Save an Image</title>
		<para>To save an image, choose 
			<menuchoice>
			<guimenu>File</guimenu>
			<guisubmenu>Save</guisubmenu>
			</menuchoice>.
		The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved.</para>
	</sect2>

	<!--============ To Save As an Image ======================= -->
	<sect2 id="eog-save-as-image">
		<title>To Save an Image under Different Name</title>
		<para>To save an image under a different name or convert it to a different file type
			<menuchoice>
			<guimenu>File</guimenu>
			<guisubmenu>Save As</guisubmenu>
			</menuchoice>.
		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. &app; 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>&app; can also save multiple images at once. This way a bunch of images can be converted to a different format or apply another name schema. The following window will be displayed if <guilabel>Save As</guilabel> is called for more than one image:</para>
  		<figure id="saveas-dialog-fig">
			<title>Save As Dialog</title>
			<screenshot>
			  <mediaobject>
			    <imageobject>
			      <imagedata fileref="figures/eog_save_as_window.png" format="PNG"/>
			    </imageobject>
			    <textobject>
			      <phrase>Shows Eye of GNOME <guilabel>Save As</guilabel> dialog when saving a bunch of images.</phrase>
			    </textobject>
			  </mediaobject>
			</screenshot>
  		</figure>
		<para>The folder in which the images will be saved is specified by <guilabel>Destination Folder</guilabel>. Initially the folder is set to 
		to the current folder. The <guilabel>Browse</guilabel> button opens 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><guilabel>Filename (%f)</guilabel> - Original filename without the fileformat suffix.</para>
			</listitem>
			<listitem><para><guilabel>Counter (%n)</guilabel> - Auto-incremented number (starts at specified counter start).</para>
			</listitem>			
		</itemizedlist>	
		<para>Everything but these special tags are considered normal text.</para>
		<para>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 the the same format as the original file should be used.</para>
	
		<para>The <guilabel>Options</guilabel> section allows to remove all space characters by underscores in the resulting filename if <guilabel>Replace spaces by underscore</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>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 bunch of selected images.
		</para>
	</sect2>



</sect1>

<sect1 id="eog-prefs">
	<title>Preferences</title>
	<para>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 ======================= -->
  <sect2 id="eog-prefs-image">
         <title>Image View</title>
	<variablelist>
	<varlistentry>
		<term><guilabel>Image Interpolation</guilabel></term>
		<listitem>
		<para>Select the <guilabel>Interpolate image on zoom</guilabel> option to enable image interpolation when you change the zoom factor for the image. If you select this option, &app; uses bilinear interpolation. Bilinear interpolation is a simple and fast method of interpolation. When you zoom in on an image, &app; uses up to four adjacent pixels to compute the colors of the new pixels. When you zoom out of an image, &app; averages regions of color in the existing image to compute the colors of the pixels. </para>
		</listitem>
	</varlistentry>

	<varlistentry>
		<term><guilabel>Transparent Parts</guilabel></term>
		<listitem>
		<para>Select one of the following options to determine how &app; displays transparent parts of an image:</para>
		<itemizedlist>
			<listitem><para><guilabel>As check pattern</guilabel> </para>
			<para>Displays any transparent parts of the image in a check pattern.</para>
			</listitem>
			<listitem><para><guilabel>As custom color</guilabel> </para>
			<para>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><guimenuitem>As background</guimenuitem> </para>
			<para>Displays any transparent parts of the image in the background color of the &app; application. </para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>		
	</variablelist>
  </sect2>
		
	<!--============ Slide Show ==================-->                                                                                               
  <sect2 id="eog-prefs-slideshow">
         <title>Slide Show</title>
	<variablelist>
	<varlistentry>
		<term><guilabel>Image Zoom</guilabel></term>
		<listitem>
		<para>Select the <guilabel>Allow zoom greater than 100% initially</guilabel> option to resize all 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><guilabel>Sequence</guilabel></term>
		<listitem>
		<para>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>Use the <guilabel>Show next image automatically 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="eog-fullscreen">fullscreen/slideshow</xref>)
</para>
		</listitem>
	</varlistentry>		
	</variablelist>
  </sect2>
</sect1>
</article>
