# &appname; Manual

## Introduction

The Eye of GNOME Image Viewer application enables you to view single image files, as well as large image collections.

### Starting &appname;

You can start &app; in the following ways:

- Choose Graphics Image Viewer from the Applications menu.

- Run `eog` at the prompt in a terminal such as gnome-terminal, or from the Run Application dialog.

### Closing &appname;

To close a &app; window choose File Close, or press Ctrl W. This will shut down the window you are currently in.

### Supported File Types

&app; supports a variety of image file formats. The `GdkPixbuf` 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:

- ANI - Animation

- BMP - Windows Bitmap

- GIF - Graphics Interchange Format

- ICO - Windows Icon

- JPEG - Joint Photographic Experts Group

- PCX - PC Paintbrush

- PNG - Portable Network Graphics

- PNM - Portable Anymap from the PPM Toolkit

- RAS - Sun Raster

- SVG - Scaleable Vector Graphics

- TGA - Targa

- TIFF - Tagged Image File Format

- WBMP - Wireless Bitmap

- XBM - X Bitmap

- XPM - X Pixmap

&app; supports the following formats for saving by default:

- ICO - Windows Icon

- JPEG - Joint Photographic Experts Group

- PNG - Portable Network Graphics

### &appname; Features

&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.

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.

## Getting Started

When you start &app;, the following window is displayed:

### &appname; Start Up Window

Shows Eye of GNOME main window. Contains titlebar, menubar, toolbar, and display area. Menubar contains File, Edit, View, and Help menus.

The &app; window contains the following elements:

Menubar

- The menus on the menubar contain all of the commands that you need to work with files in &app;.

Toolbar

- The toolbar contains a subset of the commands that you can access from the menubar. To show or hide the toolbar, choose View Toolbar.

Display area

- The display area displays the image file.

Statusbar

- The statusbar provides information about the image. To show or hide the statusbar, choose View Statusbar.

Most actions in &app; can be performed several ways. For example, you can open a file in the following ways:

- Drag an image file into the &app; window from another application or window.

- Double-click on an image file in the file manager or other application.

- Choose File Open and select an image file in the Load Image dialog.

- Click on the Open toolbar button and select an image file in the Load Image dialog.

- Press Ctrl O and select an image file in the Load Image dialog.

## Viewing Images

### To Open an Image

To open an image, perform the following steps:

1. Choose File Open , or press Ctrl O .

2. In the Load Image dialog, select the file you want to open.

3. Click Open. &app; displays the name of the image file in the titlebar of the window.

To open another image, choose File Open again. &app; opens each image in a new window. To explicitly open a new window, choose File New , or click the New button, or press Ctrl N .

If you try to open an image file format that &app; does not recognize, the application displays an error message.

### To View the Images in a Folder

To view all images in a folder, perform the following steps:

1. Choose File Open Directory , or press Shift Ctrl O.

2. In the Open Folder dialog, select the directory you want to open.

3. Click Open. &app; displays all of the images in the directory in one &app; window. This is known as the collection view.

To view all of the images in the directory as a slide show, choose View Full Screen . To return to the collection view, press the Esc or F11 key, or Ctrl W. For more information about how to customize the slide show, see eog-prefs-slideshow.

### To Scroll an Image

To scroll around an image that is larger than the image window or full screen window, you can use the following methods:

- Use the arrow keys on the keyboard.

- 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.

- Use the scrollbars on the window.

### To Zoom In or Out

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 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/Slideshow

To display the image in full-screen mode, choose View Full 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 Ctrl W. 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 eog-prefs-slideshow). In this mode the manual navigation still works and the auto advance function can be paused/continued by pressing P.

## 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 eog-save-imagesave).

### To Flip an Image

To flip an image along the horizontal axis of the image, choose Edit Flip Horizontal .

To flip an image along the vertical axis of the image, choose Edit Flip Vertical .

### To Rotate an Image

To rotate an image 90 degrees in a clockwise direction, choose Edit Rotate Clockwise .

To rotate an image 90 degrees in an anticlockwise direction, choose Edit Rotate Counter Clockwise .

To rotate an image 180 degrees in a clockwise direction, choose Edit Rotate 180 Degrees .

### To Undo an Action

To undo a flip or rotate action, choose Edit 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

&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.

### To Save an Image

To save an image, choose File Save . The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved.

### 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 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 Edit Preferences. You will be able to change the options for image viewing and slide shows. The changes apply to all open windows instantly.

### Image View

Image Interpolation

- Select the Interpolate image on zoom 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.

Transparent Parts

- Select one of the following options to determine how &app; displays transparent parts of an image:

  - As check pattern

    Displays any transparent parts of the image in a check pattern.

  - As custom color

    Displays any transparent parts of the image in a solid color that you specify. Click on the color selector button to select a color.

  - As background

    Displays any transparent parts of the image in the background color of the &app; application.

### Slide Show

Image Zoom

- Select the Allow zoom greater than 100% initially 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.

Sequence

- 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 auto advance function is disabled and only manual browsing is available (see eog-fullscreenfullscreen/slideshow)