path: root/help/C/eog.xml

<?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 "1.0.2">
  <!ENTITY manrevision "2.4">
  <!ENTITY date "January 2003">
  <!ENTITY app "Eye of GNOME">
]>
<!-- 
      (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>&app; Manual V&manrevision;</title>       

    <copyright> 
      <year>2003</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>2002</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>Sun</firstname> 
	<surname>GNOME Documentation Team</surname> 
	<affiliation> 
	  <orgname>Sun Microsystems</orgname> 
	  <address> <email>gdocteam@sun.com</email> </address> 
	</affiliation> 
   </author> 
   <author> 
	<firstname>Eliot</firstname> 
	<surname>Landrum</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>eliot@landrum.cx</email> </address> 
	</affiliation> 
   </author> 
   <author> 
	<firstname>Federico</firstname> 
	<surname>Mena Quintero</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>federico@gnu.org</email> </address> 
	</affiliation> 
   </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> 
	  <address> <email>translator@gnome.org</email> </address> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>
 
    <revhistory>
    <revision> 
		<revnumber>&app; Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
	  		<para role="author">Sun GNOME Documentation Team
	    		<email>gdocteam@sun.com</email>
	  		</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
	    		<email>gdocteam@sun.com</email>
	  		</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
	    		<email>gdocteam@sun.com</email>
	  		</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
	    		<email>gdocteam@sun.com</email>
	  		</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
	    		<email>gdocteam@sun.com</email>
	  		</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 &app;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; 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>&app;</application> application enables you to view image files. 
	<application>&app;</application> provides the following features:</para>
	<itemizedlist>
		<listitem><para>Support for the following image file formats:</para>
			<itemizedlist>
				<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>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>XBM - X Bitmap</para>
				</listitem>
				<listitem><para>XPM - X Pixmap</para>
				</listitem>
			</itemizedlist>
			<note><para>You can view images in the formats that are listed above but you 
			can only use the image saving feature for PNG and JPEG formats.</para></note>
		</listitem>
		<listitem><para>A variety of zoom levels and full screen viewing, with low usage of 
		memory regardless of the zoom level. </para>
		</listitem>
		<listitem><para>Bonobo embedding technology that enables you to embed image views in 
		other GNOME applications. </para>
		</listitem>
	</itemizedlist>
</sect1>

<!-- =========== Getting Started ============================== -->

<sect1 id="eog-getting-started">
	<title>Getting Started</title>
	<sect2 id="eog-tostartapp">
	<title>To Start &app;</title>
	<para>You can start <application>&app;</application> in the following ways:</para>
		<variablelist>
			<varlistentry>
			<term><guimenu>Applications</guimenu> menu</term>
			<listitem>
			<para>Choose 
			<menuchoice>
			<guisubmenu>Graphics</guisubmenu>
			<guimenuitem>&app; Image Viewer</guimenuitem>
			</menuchoice>. </para>
			</listitem>
			</varlistentry>
			<varlistentry>
			<term>Command line</term>
			<listitem>
			<para>To run <application>&app;</application> and open a file from a command line, 
			type the following command, then press <keycap> Return</keycap>:</para>
			<para><command>eog</command> <replaceable>filename.jpg</replaceable></para>
			<para>where <replaceable>filename.jpg</replaceable> is the name of the file you want to open.</para>
			<para><application>&app;</application> opens each file that you specify in a new window.</para>
			</listitem>
			</varlistentry>
		</variablelist>
	</sect2>
	<sect2 id="eog-whenyoustart">
	<title>When You Start &app;</title>
	<para>When you start <application>&app;</application>, the following window is displayed.</para>
		<!-- ==== Figure ==== -->
		<figure id="mainwindow-fig">
		<title>&app; Start Up Window Before You Open a File</title>
		<screenshot>
		  <mediaobject>
		    <imageobject>
		      <imagedata fileref="figures/eog_start_window.png" format="PNG"/>
		    </imageobject>
		    <textobject>
		      <phrase>Shows Eye of GNOME main window</phrase>
		    </textobject>
		  </mediaobject>
		</screenshot>
		</figure>
		<!-- ==== End of Figure ==== -->

	</sect2>
</sect1>

<!-- ================ Usage ================================ -->

<sect1 id="eog-usage">
	<title>Usage</title>

	<!--=========== To Open an Image ============================= -->
	<sect2 id="eog-open-image">
		<title>To Open an Image</title>
		<para>To open an image, choose 
		<menuchoice>
		<guimenu>File</guimenu>
		<guimenuitem>Open</guimenuitem>
		</menuchoice>. 
		The <guilabel>Open Image</guilabel> dialog is displayed. Select the file that you 
		want to open, then click <guibutton>OK</guibutton>. </para>
		<para>To open another image in a new window, choose 
		<menuchoice>
		<guimenu>File</guimenu>
		<guimenuitem>New Window</guimenuitem>
		</menuchoice>. 
		Choose 
		<menuchoice>
		<guimenu>File</guimenu>
		<guimenuitem>Open</guimenuitem>
		</menuchoice> 
		to select the file that you want to open. You can also drag an image from another 
		application such as a file manager to the <application>&app;</application> window. 
		If the <application>&app;</application> window is empty, the application displays 
		the image in the window. If the window is not empty, the application starts a new 
		window to display the file. </para>
		<para>If you try to open an image file format that <application>&app;</application> 
		does not recognize, the application displays an error message.</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 in the opposite direction 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>

	<sect2 id="eog-change-zoom">
	<title>To Change the Zoom Factor</title>
	<para>You can use the following methods to resize the view of an image in the 
		<application>&app;</application> window:</para>
		<itemizedlist>
			<listitem><para>To enlarge the view of an image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guimenuitem>Zoom In</guimenuitem>
			</menuchoice>.</para>
			</listitem>
			<listitem><para>To shrink the view of an image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guimenuitem>Zoom Out</guimenuitem>
			</menuchoice>.</para>
			</listitem>
			<listitem><para>To view the image at its actual size, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guimenuitem>Zoom 1:1</guimenuitem>
			</menuchoice>. </para>
			</listitem>
			<listitem><para>To enlarge or shrink the view of an image so that the 
			image fits the <application>&app;</application> window, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guimenuitem>Zoom to Fit</guimenuitem>
			</menuchoice>.</para>
			</listitem>
			<listitem><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> key or <keycombo><keycap>Ctrl</keycap>
			<keycap>W</keycap></keycombo>.</para>
			</listitem>
		</itemizedlist>
	</sect2>	
			
	<sect2 id="eog-change-interpolation">
		<title>To Change the Interpolation Method</title>
		<para>To change the interpolation method for the image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guimenuitem>Interpolation</guimenuitem>
			</menuchoice>, 
		then select the interpolation method you require. 
		Select one 
of the following options:</para>
			<itemizedlist>
			<listitem><para><guimenuitem>Nearest Neighbor</guimenuitem> </para>
			<para>This method of interpolation takes a location in the original image and replicates the 
			pixel that is nearest to this location. When you zoom in on an image, the pixels are replicated. 
			When you zoom out of an image, the image loses some of its detail. </para>
			</listitem>
			<listitem><para><guimenuitem>Tiles</guimenuitem> </para>
			<para>No information available at time of publication.</para>
			</listitem>
			<listitem><para><guimenuitem>Bilinear</guimenuitem> </para>
			<para>This is a simple and fast method of interpolation. When you zoom in on an image, 
			<application>&app;</application> uses up to four adjacent pixels to compute the colors of 
			the new pixels. When you zoom out of an image, <application>&app;</application> averages 
			regions of color in the existing image to compute the colors of the pixels. </para>
			</listitem>
			<listitem><para><guimenuitem>Hyperbolic</guimenuitem> </para>
			<para>This is a high-quality, slow method of interpolation. The application performs interpolation 
			on the image in the manner described in Digital Image Warping by George Wolberg.</para>
			</listitem>
			</itemizedlist>
		<!-- <para>The default interpolation method is 
		<guimenuitem>Nearest Neighbor</guimenuitem>.</para>
 -->
	</sect2>	
	
	<sect2 id="eog-change-dither">
		<title>To Change the Dithering Method</title>
		<para>To change the dithering method for the image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guisubmenu>Dither</guisubmenu>
			</menuchoice>, 
		then select the dithering method you require.
		Select one of the following options:</para>
			<itemizedlist>
			<listitem><para><guimenuitem>None</guimenuitem> </para>
			<para>This option does not use dithering. </para>
			</listitem>
			<listitem><para><guimenuitem>Normal (pseudocolor)</guimenuitem> </para>
			<para>This option performs dithering on pseudocolor displays, which use a limited palette of colors. </para>
			</listitem>
			<listitem><para><guimenuitem>Maximum (high color)</guimenuitem> </para>
			<para>This option performs dithering on pseudocolor and high color displays. </para>
			</listitem>
		</itemizedlist>
		<!-- <para>The default dithering method is <guimenuitem>None</guimenuitem>.</para>	-->
	</sect2>
	
	<sect2 id="eog-change-check-type">
		<title>To Change the Check Type</title>
		<para>To change the check type that <application>&app;</application>
		uses to display transparent or partially opaque backgrounds in the image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guisubmenu>Check type</guisubmenu>
			</menuchoice>, 
		then select the check type you require.
		Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>Dark</guimenuitem> </para>
			<para>This option displays black and dark gray checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Midtone</guimenuitem> </para>
			<para>This option displays dark gray and light gray checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Light</guimenuitem> </para>
			<para>This option displays light gray and white checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Black</guimenuitem> </para>
			<para>This option displays solid black.</para>
			</listitem>
			<listitem><para><guimenuitem>Gray</guimenuitem> </para>
			<para>This option displays solid gray.</para>
			</listitem>
			<listitem><para><guimenuitem>White</guimenuitem> </para>
			<para>This option displays solid white.</para>
			</listitem>
		</itemizedlist>
		<!-- <para>The default check type is <guimenuitem>Dark</guimenuitem>.</para> -->
	</sect2>
	
	<sect2 id="eog-change-check-size">
		<title>To Change the Check Size</title>
		<para>To change the check size that <application>&app;</application>
		uses to display transparent or partially opaque backgrounds in the image, choose 
			<menuchoice>
			<guimenu>View</guimenu>
			<guisubmenu>Check size</guisubmenu>
			</menuchoice>, 
		then select the check size you require.
		This option is only relevant if you choose <guimenuitem>Dark checks</guimenuitem>, 
		<guimenuitem>Midtone checks</guimenuitem>, or <guimenuitem>Light checks</guimenuitem> from the 
		<guisubmenu>Check type</guisubmenu> menu. Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>Small</guimenuitem></para>
			</listitem>
			<listitem><para><guimenuitem>Medium</guimenuitem></para>
			</listitem>
			<listitem><para><guimenuitem>Large</guimenuitem></para>
			</listitem>
		</itemizedlist>
		<!-- <para>The default check size is <guimenuitem>Small</guimenuitem>.</para>
 -->
	</sect2>
	
	<sect2 id="eog-save-image">
		<title>To Save an Image</title>
		<para>To save an image to a new filename, choose 
			<menuchoice>
			<guimenu>File</guimenu>
			<guisubmenu>Save As</guisubmenu>
			</menuchoice>.
		Specify the location and filename in <guilabel>Selection</guilabel> field, then click 
		<guibutton>OK</guibutton>. You can only save a PNG or JPEG image to another filename
		of the same image type. </para>
		
	</sect2>

	<sect2 id="eog-close-image">
		<title>To Close an Image</title>
		<para>To close an image, choose 
		<menuchoice>
		<guimenu>File</guimenu>
		<guimenuitem>Close</guimenuitem>
		</menuchoice>. 
		If the window is the last <application>&app;</application> window open, the application exits. </para>
		<para>To quit <application>&app;</application> and close all of the windows that you 
		opened in the current session, choose 
		<menuchoice>
		<guimenu>File</guimenu>
		<guimenuitem>Quit</guimenuitem>
		</menuchoice>.
		</para>
	</sect2>

</sect1>

<sect1 id="eog-prefs">	
<title>Preferences</title>
	<para>To configure <application>&app;</application>, choose <menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Preferences</guimenuitem>
		</menuchoice>.
	</para>
	
	<variablelist>
	<varlistentry>
		<term><guilabel>Interpolation</guilabel></term>
		<listitem>
		<para>Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>Nearest Neighbor</guimenuitem> </para>
			<para>This method of interpolation takes a location in the original image and replicates the 
			pixel that is nearest to this location. When you zoom in on an image, the pixels are replicated. 
			When you zoom out of an image, the image loses some detail. </para>
			</listitem>
			<listitem><para><guimenuitem>Tiles</guimenuitem> </para>
			<para>No information available at time of publication.</para>
			</listitem>
			<listitem><para><guimenuitem>Bilinear</guimenuitem> </para>
			<para>This is a simple and fast method of interpolation. When you zoom in on an image, 
			<application>&app;</application> uses up to four adjacent pixels to compute the colors of 
			the new pixels. When you zoom out of an image, <application>&app;</application> averages 
			regions of color in the existing image to compute the colors of the pixels. </para>
			</listitem>
			<listitem><para><guimenuitem>Hyperbolic</guimenuitem> </para>
			<para>This is a high-quality, slow method of interpolation. The application performs interpolation 
			on the image in the manner described in Digital Image Warping by George Wolberg.</para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term><guilabel>Dither</guilabel></term>
		<listitem>
		<para>Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>None</guimenuitem> </para>
			<para>This option does not use dithering. </para>
			</listitem>
			<listitem><para><guimenuitem>Normal (pseudocolor)</guimenuitem> </para>
			<para>This option performs dithering on pseudocolor displays, which use a limited palette of colors. </para>
			</listitem>
			<listitem><para><guimenuitem>Maximum (high color)</guimenuitem> </para>
			<para>This option performs dithering on pseudocolor and high color displays. </para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term><guilabel>Check type</guilabel></term>
		<listitem>
		<para>Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>Dark</guimenuitem> </para>
			<para>This option displays black and dark gray checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Midtone</guimenuitem> </para>
			<para>This option displays dark gray and light gray checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Light</guimenuitem> </para>
			<para>This option displays light gray and white checks.</para>
			</listitem>
			<listitem><para><guimenuitem>Black</guimenuitem> </para>
			<para>This option displays solid black.</para>
			</listitem>
			<listitem><para><guimenuitem>Gray</guimenuitem> </para>
			<para>This option displays solid gray.</para>
			</listitem>
			<listitem><para><guimenuitem>White</guimenuitem> </para>
			<para>This option displays solid white.</para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>		
	<varlistentry>
		<term><guilabel>Check size</guilabel></term>
		<listitem>
		<para>This option is only relevant if you choose <guimenuitem>Dark checks</guimenuitem>, 
		<guimenuitem>Midtone checks</guimenuitem>, or <guimenuitem>Light checks</guimenuitem> from the 
		<guilabel>Check type</guilabel> drop-down list. Select one of the following options:</para>
		<itemizedlist>
			<listitem><para><guimenuitem>Small</guimenuitem></para>
			</listitem>
			<listitem><para><guimenuitem>Medium</guimenuitem></para>
			</listitem>
			<listitem><para><guimenuitem>Large</guimenuitem></para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>	
	</variablelist>
		

</sect1>


</article>