EoG Manual Update for GNOME 2.8
- From: "Stuart Ellis" <s ellis fastmail co uk>
- To: gnome-doc-list gnome org
- Subject: EoG Manual Update for GNOME 2.8
- Date: Mon, 13 Sep 2004 01:19:26 +0100
Please find attached "eog.xml", DocBook file.
This supercedes earlier patch and is the complete DocBook for Eye of
GNOME 2.8, incorporating patch from Angela Boyle and other fixes.
--
Stuart Ellis
s ellis fastmail co uk
<?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.6.1">
<!ENTITY manrevision "2.8">
<!ENTITY date "September 2004">
<!ENTITY app "<application>Eye of GNOME</application>">
<!ENTITY appname "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>&appname; Manual V&manrevision;</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>Angela</firstname>
<surname>Boyle</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname>
<email>aboyle aboyle com</email>
</affiliation>
</author>
<author>
<firstname>Stuart</firstname>
<surname>Ellis</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname>
<email>s ellis ftml net</email>
</affiliation>
</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>
<email>eliot landrum cx</email>
</affiliation>
</author>
<author>
<firstname>Federico</firstname>
<surname>Mena Quintero</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname>
<email>federico gnu org</email>
</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>
<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>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 &app; application enables you to view image files. Bonobo embedding technology in &app; allows you to embed image views in other GNOME applications.</para>
<!--============ To Start ======================= -->
<sect2 id="eog-tostartapp">
<title>To Start &appname;</title>
<para>You can start &app; in the following ways:</para>
<variablelist>
<varlistentry>
<term>&app; menu</term>
<listitem>
<para>Choose
<menuchoice>
<guimenu>Applications</guimenu>
<guisubmenu>Graphics</guisubmenu>
<guimenuitem>Image Viewer</guimenuitem>
</menuchoice>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Command line</term>
<listitem>
<para>Execute the following command: <command>eog</command></para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!--============ To Quit ======================= -->
<sect2 id="eog-closeapp">
<title>To Quit &app;</title>
<para>To quit &app;, which will shut down all windows that are open, go to <menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice>, or press <keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>. All the images open in the current session will be closed.</para>
<para>To close just the window you are currently in, go to <menuchoice><guimenu>File</guimenu><guimenuitem>Close</guimenuitem></menuchoice>, or press <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. If the window is the last &app; window open, the application exits.</para>
</sect2>
<!--============ Supported File Types ======================= -->
<sect2 id="eog-filetypes">
<title>Supported File Types</title>
<para>&app; supports a variety of image file formats. The GdkPixbuf library determines file formats eog can load and save; however, you can use plug-ins to extend the list. The following list is the default file formats:</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>
</sect2>
<!--============ Features ======================= -->
<sect2 id="eog-features">
<title>&app; Features</title>
<para>&app; has a variety of features to help you view your images. You can zoom in and out at a variety of levels 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>If you are looking at a collection of images, &app; can display EFIX data. This feature requires <literal>libefix</literal>. You can also do mass modification on all the selected images.</para>
<para>&app; also has special support for jpeg files, requiring both <literal>libjpeg</literal> and <literal>libefix</literal>. This feature allows lossless saving of rotated and flipped images. It also preserves and updates EFIX data when you save.</para>
</sect2>
</sect1>
<!--============== When You Start ===========-->
<sect1 id="eog-whenyoustart">
<title>When You Start &appname;</title>
<para>When you start &app;, the following window is displayed.</para>
==== Figure ====
<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>
==== End of 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>
<note>
<para>Additional menus and toolbar buttons are displayed when you open a file.</para>
</note>
</para>
<para>
In &app;, you can perform the same action in several ways. For example, you can open a file in the following ways:
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>UI Component</para></entry>
<entry colname="COLSPEC1" align="left">
<para>Action</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para>Window</para></entry>
<entry><para>Drag a file into the &app; window from another application or window.</para>
<para>Alternatively, double-click on the file name a window, or any GNOME application that allows embedded image views.</para>
</entry>
</row>
<row valign="top">
<entry><para>Menubar</para></entry>
<entry><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>.</para>
</entry>
</row>
<row valign="top">
<entry><para>Toolbar</para></entry>
<entry><para>Click on the <guibutton>Open</guibutton> toolbar button. </para></entry>
</row>
<row valign="top">
<entry><para>Shortcut keys</para></entry>
<entry><para>Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</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-directory">
<title>To View the Images in a Directory</title>
<para>To view the images that are contained in a directory, 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 size. <guilabel>Best Fit</guilabel> will resize the image so it will fit in the window.</para></listitem>
<listitem><para>Three zoom options also have shortcuts. To zoom in, <keycombo> <keycap>Ctrl</keycap><keycap>+</keycap> </keycombo>. To zoom out, <keycombo> <keycap>Ctrl</keycap><keycap>-</keycap> </keycombo>. To go back to the normal size, <keycombo> <keycap>Ctrl</keycap><keycap>=</keycap> </keycombo>.</para></listitem>
</itemizedlist>
</sect2>
<!--=========== To View Image Fullscreen ==================== -->
<sect2 id="eog-fullscreen">
<title>To View Image Full Screen</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>.</para>
</sect2>
</sect1>
<!-- ============= Manipulating Images ============================== -->
<sect1 id="eog-manipulate">
<title>Manipulating Images</title>
<!--============ 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>
</sect1>
<!-- ============= Saving ============================== -->
<sect1 id="eog-save-rename">
<title>Saving and Renaming</title>
<!--============ 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 first time that you save an image, specify the location and filename in the <guilabel>Name</guilabel> field in the <guilabel>Save Image</guilabel> dialog, then click <guibutton>Save</guibutton></para>
<para>After you have saved an image once you will not be asked for this information again.</para>
</sect2>
<!--============ To Rename an Image ======================= -->
<sect2 id="eog-rename-image">
<title>To rename an Image</title>
<para>To rename an image, choose
<menuchoice>
<guimenu>File</guimenu>
<guisubmenu>Save As</guisubmenu>
</menuchoice>.
Specify the location and filename in the <guilabel>Name</guilabel> field in the <guilabel>Save Image</guilabel> dialog, then click <guibutton>Save</guibutton>. You can only save an image to another filename of the same image type.</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.</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 first image is displayed permanently and the other images are not displayed at all in the slide show.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
</article>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
