graphics/eog
graphics/eog
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/eog synced 2024-10-18 14:04:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

help/C/eog.xml, help/C/figures/eog_save_as_window.png, Updated. Now it

Browse source 
2004-09-18  Jens Finke  <jens@triq.net>

	* help/C/eog.xml,
	* help/C/figures/eog_save_as_window.png,
	* help/C/figures/eog_start_window.png: Updated. Now it really matches
	  eog 2.8.
This commit is contained in:
Jens Finke 2004-09-18 15:30:01 +00:00 committed by Jens Finke
parent 15563e4650
commit 2dc8c0b35c
4 changed files with 119 additions and 43 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
ChangeLog
View file

@ -1,3 +1,10 @@
2004-09-18 Jens Finke <jens@triq.net>
* help/C/eog.xml,
* help/C/figures/eog_save_as_window.png,
* help/C/figures/eog_start_window.png: Updated. Now it really matches
eog 2.8.
2004-09-13 Jens Finke <jens@triq.net>
* shell/eog-window.c (verb_DirOpen_cb): Use gtk_file_chooser_get_uris

155
help/C/eog.xml
View file

@ -57,6 +57,14 @@
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>
@ -217,9 +225,8 @@
<sect1 id="eog-introduction">
<title>Introduction</title>
<para>The <application>Eye of GNOME Image Viewer</application>
application enables you to view image files. Bonobo embedding
technology in &app; allows you to embed image views in other
GNOME applications.</para>
application enables you to view single image files, as well as large image collections.
</para>
<sect2 id="eog-tostartapp">
<title>Starting &appname;</title>
@ -239,17 +246,11 @@
</sect2>
<sect2 id="eog-closeapp">
<title>Quitting &appname;</title>
<para>To quit &app; choose <menuchoice><guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem></menuchoice>, or press
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>.
This will shut down all &app; windows, closing all images
that are open.</para>
<para>To close just the window you are currently in, choose
<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>
<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">
@ -259,7 +260,7 @@
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:</para>
supported file formats for reading:</para>
<itemizedlist>
<listitem><para>ANI - Animation</para>
</listitem>
@ -292,6 +293,16 @@
<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">
@ -300,15 +311,20 @@
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>If you are looking at a collection of images, &app; can display EFIX
data. This feature requires <systemitem class="library">libefix</systemitem>
to be installed on your system. You can also do mass modification of all
the selected images.</para>
<para>&app; also has special support for JPEG image files, which requires
<systemitem class="library">libjpeg</systemitem> and
<systemitem class="library">libefix</systemitem>. This feature allows
lossless saving of rotated and flipped images. It also preserves and
updates EFIX data when you save.</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>
@ -356,8 +372,6 @@
</listitem>
</varlistentry>
</variablelist>
<note><para>Additional menus and toolbar buttons are displayed when you
open a file.</para></note>
<para>Most actions in &app; can be performed several ways. For example,
you can open a file in the following ways:</para>
<itemizedlist>
@ -411,9 +425,9 @@
</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>
<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>
@ -454,15 +468,16 @@
<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>
<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</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>
<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>
@ -471,6 +486,9 @@
<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">
@ -516,11 +534,29 @@
<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 and Renaming</title>
<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">
@ -530,26 +566,59 @@
<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>
The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved.</para>
</sect2>
<!--============ To Rename an Image ======================= -->
<sect2 id="eog-rename-image">
<title>To Rename an Image</title>
<para>To rename an image, choose
<!--============ 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 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>
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.</para>
<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">
@ -597,7 +666,7 @@
<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>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>

BIN
help/C/figures/eog_save_as_window.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 18 KiB

BIN
help/C/figures/eog_start_window.png
View file

Binary file not shown.
Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 7.2 KiB