diff --git a/ChangeLog b/ChangeLog index 17d49608..950f8839 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2004-09-18 Jens Finke + + * 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 * shell/eog-window.c (verb_DirOpen_cb): Use gtk_file_chooser_get_uris diff --git a/help/C/eog.xml b/help/C/eog.xml index e878530a..c6163aef 100644 --- a/help/C/eog.xml +++ b/help/C/eog.xml @@ -57,6 +57,14 @@ other legal stuff such as "NO WARRANTY" statement. Please do not change any of this. --> + + Jens + Finke + + GNOME Documentation Project + + jens@triq.net + Angela Boyle @@ -217,9 +225,8 @@ Introduction The Eye of GNOME Image Viewer - application enables you to view image files. Bonobo embedding - technology in &app; allows you to embed image views in other - GNOME applications. + application enables you to view single image files, as well as large image collections. + Starting &appname; @@ -239,17 +246,11 @@ - Quitting &appname; - To quit &app; choose File - Quit, or press - CtrlQ. - This will shut down all &app; windows, closing all images - that are open. - To close just the window you are currently in, choose - FileClose - , or press CtrlW - . If the window is the last &app; window open, the application - exits. + Closing &appname; + To close a &app; window choose File + Close, or press + CtrlW. + This will shut down the window you are currently in. @@ -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: + supported file formats for reading: ANI - Animation @@ -292,6 +293,16 @@ XPM - X Pixmap + + &app; supports the following formats for saving by default: + + ICO - Windows Icon + + JPEG - Joint Photographic Experts Group + + PNG - Portable Network Graphics + + @@ -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. - If you are looking at a collection of images, &app; can display EFIX - data. This feature requires libefix - to be installed on your system. You can also do mass modification of all - the selected images. - &app; also has special support for JPEG image files, which requires - libjpeg and - libefix. This feature allows - lossless saving of rotated and flipped images. It also preserves and - updates EFIX data when you save. + + 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. + + &app; has special support for digital camera pictures and + displays EXIF metadata recorded with the image. This feature + requires libexif to be + installed on your system. If libjpeg 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. @@ -356,8 +372,6 @@ - Additional menus and toolbar buttons are displayed when you - open a file. Most actions in &app; can be performed several ways. For example, you can open a file in the following ways: @@ -411,9 +425,9 @@ - - To View the Images in a Directory - To view the images that are contained in a directory, perform the following steps: + + To View the Images in a Folder + To view all images in a folder, perform the following steps: @@ -454,15 +468,16 @@ You can zoom in or out of the image through a variety of methods. You can use the middle mouse button to scroll in and out. Scrolling down zooms out; scrolling up zooms in. - You can use the zoom buttons in the toolbar. They are also located in the View. You can zoom in and zoom out. Normal will restore the picture to its original size. Best Fit will resize the image so it will fit in the window. - Three zoom options also have shortcuts. To zoom in, Ctrl+ . To zoom out, Ctrl- . To go back to the normal size, Ctrl= . + You can use the zoom buttons in the toolbar. They are also located in the View. You can zoom in and zoom out. Normal will restore the picture to its original unscaled size. Best Fit will resize the image so it will fit in the window and adapt the size on window resizing. + The zoom options also have shortcuts. To zoom in, Ctrl+ or +. To zoom out, Ctrl- or -. To go back to the normal size, Ctrl= or 1. The best fit mode can be entered by pressing F. - To View Image Full Screen - To display the image in full-screen mode, choose ViewFull Screen. 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 Esc or F11 key, or CtrlW. + To View Image Full Screen/Slideshow + To display the image in full-screen mode, choose ViewFull Screen. 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 Esc or F11 key, or CtrlW. To zoom into or pane around the image the same things apply as for the window mode. + If multiple images are displayed (collection view) the &app; enters the slideshow mode when in fullscreen. To advance to the next image press Space or use the right/down cursor keys. The previous image can be reached by pressing Backspace or using the left/up cursor keys. If configured &app; can also auto advance to the next picture after a specified timeout (see ). In this mode the manual navigation still works and the auto advance function can be paused/continued by pressing P. @@ -471,6 +486,9 @@ Manipulating Images + 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 save). + @@ -516,11 +534,29 @@ Undo . + + + + To Delete an Image + To delete an image + + Edit + Delete + . + This operation applies to all currently selected images. You may also use DEL. + &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. + + - Saving and Renaming + Saving + + + &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 libjpeg is available on the system all JPEG image modifications are done without loss of image information. + @@ -530,26 +566,59 @@ File Save . - The first time that you save an image, specify the location and filename in the Name field in the Save Image dialog, then click Save - After you have saved an image once you will not be asked for this information again. + The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved. - - - To Rename an Image - To rename an image, choose + + + To Save an Image under Different Name + To save an image under a different name or convert it to a different file type File Save As . - Specify the location and filename in the Name field in the Save Image dialog, then click Save. You can only save an image to another filename of the same image type. + Specify the filename in the Name field in the Save Image dialog, then click Save. 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 Browse for other folders. This allows further folder navigation and the specification of the file type from the drop down box. + + &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 Save As is called for more than one image: +
+ Save As Dialog + + + + + + + Shows Eye of GNOME Save As dialog when saving a bunch of images. + + + +
+ The folder in which the images will be saved is specified by Destination Folder. Initially the folder is set to + to the current folder. The Browse button opens a standard open folder dialog for browsing the filesystem. The + resulting filename for each image is specified by Filename Format. The filename schema is constructed by simple + characters and special tags. The following special tags are available: + + Filename (%f) - Original filename without the fileformat suffix. + + Counter (%n) - Auto-incremented number (starts at specified counter start). + + + Everything but these special tags are considered normal text. + The image format is determined by the drop-down box after the schema definition. Select a specific image format or use the + as is option to state the the same format as the original file should be used. + + The Options section allows to remove all space characters by underscores in the resulting filename if Replace spaces by underscore is checked. The Start counter at spin box determines at which number the counter starts if you use the %n tag for the file format specification. + The File Name Preview section of the dialog shows the resulting file name according to the above settings for an example filename from the bunch of selected images. + + + Preferences - Preferences can be changed by going to EditPreferences. You will be able to change the options for image viewing and slide shows. + Preferences can be changed by going to EditPreferences. You will be able to change the options for image viewing and slide shows. The changes apply to all open windows instantly. @@ -597,7 +666,7 @@ Select the Loop sequence 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. - Use the Show next image automatically after ... seconds 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. + Use the Show next image automatically after ... seconds 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 fullscreen/slideshow) diff --git a/help/C/figures/eog_save_as_window.png b/help/C/figures/eog_save_as_window.png new file mode 100644 index 00000000..fc7edb1b Binary files /dev/null and b/help/C/figures/eog_save_as_window.png differ diff --git a/help/C/figures/eog_start_window.png b/help/C/figures/eog_start_window.png index b05535b3..a3e41d83 100644 Binary files a/help/C/figures/eog_start_window.png and b/help/C/figures/eog_start_window.png differ