# &appname; Manual V&manrevision;

## Introduction

The &app; application enables you to view image files. &app; provides the following features:

- Support for the following image file formats:

  - 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

  The GdkPixbuf library determines the file formats that &app; can load and save. The above list describes the file formats that are supported by default, you can use plug-ins to extend this list.

- A variety of zoom levels and full screen viewing, with low usage of memory regardless of the zoom level.

- Bonobo embedding technology that enables you to embed image views in other GNOME applications.

- Rotation and flipping of images.

- Collection:

  - Display of EXIF data, this requires `libexif`.

  - Mass modification of all selected images.

- Special JPEG file support, this requires `libjpeg` and `libexif`:

  - Lossless saving of rotated or flipped images.

  - Preservation and update of EXIF data on save.

## Getting Started

### To Start &appname;

You can start &app; in the following ways:

Applications menu

- Choose Graphics Image Viewer .

Command line

- Execute the following command: `eog`

### When You Start &appname;

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.

Additional menus and toolbar buttons are displayed when you open a file.

In &app;, you can perform the same action in several ways. For example, you can open a file in the following ways:

UI Component | Action
Window | Drag a file into the &app; window from another application such as a file manager. Alternatively, double-click on the file name in the file manager, or any GNOME application that allows embedded image views.
Menubar | Choose File Open.
Toolbar | Click on the Open toolbar button.
Shortcut keys | Press Ctrl O.

This manual documents functionality from the menubar.

## Usage

### To Open an Image

To open an image, perform the following steps:

1. Choose File Open .

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 .

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 Directory

To view the images that are contained in a directory, perform the following steps:

1. Choose File Open Directory .

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.

4. To view all of the images in the directory as a slide show, choose View Slide Show . 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 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.

- Use the scrollbars on the window.

### To Resize the Image View

You can use the following methods to resize the view of an image in the &app; window:

- To increase the size of the image view, choose View Zoom In.

- To decrease the size of the image view, choose View Zoom Out.

- To view the image at actual size, choose View Normal Size.

- To resize the image view to fit in the &app; display area, choose View Best Fit.

- 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 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 Save an Image

To save an image to a new filename, choose File Save As . Specify the location and filename in the Filename field in the Save Image dialog, then click Save. You can only save a PNG or JPEG image to another filename of the same image type.

### To Configure the Print Options for an Image

To configure the print options for an image, choose File Print Setup.

The print dialog has the following tabbed sections:

- Paper

- Page

#### Paper

Paper and layout

- Use the Paper size drop-down list to select the size of the paper to which you want to print the file.

  Use the Width spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.

  Use the Height spin box to specify the height of the paper.

  Use the Feed orientation drop-down list to select the orientation of the paper in the printer.

  Use the Page orientation drop-down list to select the page orientation.

  Use the Layout drop-down list to select the page layout. A preview of each layout that you select is displayed in the Preview area.

  Use the Paper Tray drop-down list to select the paper tray.

Preview

- Use the Preview area to see the effect of the options that you select.

Margins

- Use the Top spin box to specify the size of the top margin.

  Use the Left spin box to specify the size of the left margin.

  Use the Right spin box to specify the size of the right margin.

  Use the Bottom spin box to specify the size of the bottom margin.

#### Page

Preview

- Use the Preview area to see the effect of the options that you select.

Scale

- Select the Adjust to ...% of original size option to change the size of the image. Use the spin box to specify the new size of the image.

  Select the Fit to Page option to resize the image to fit on the whole page.

Show

- Select the Cutting help option to display guide lines to indicate where the image is cut.

  Select the Overlap help option to display guide lines to indicate where the image overlaps the page.

  Select the Ordering help option to display guide lines to indicate page order.

  Select the Margins option to display guide lines to indicate image margins.

Center

- Select the Horizontally option to center the image horizontally on the page.

  Select the Vertically option to center the image vertically on the page.

Overlap

- Use the Horizontally by spin box to specify by how much the image can overlap the page horizontally.

  Use the Vertically by spin box to specify by how much the image can overlap the page vertically.

Page order

- Select the Down, then right option to print

  Select the Right, then down option to print

### To Preview an Image

To preview an image, choose File Print Preview .

### To Print an Image

To print an image, choose File Print .

### To Close an Image

To close an image, choose File Close .

If the window is the last &app; window open, the application exits.

To quit &app;, choose File Quit .

When you quit, &app; closes all images opened in the current session.

## Preferences

To configure &app;, choose Edit Preferences . The Eye of Gnome Preferences dialog contains the following tabbed sections:

- eog-prefs-image

- eog-prefs-slideshow

### 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 first image is displayed permanently and the other images are not displayed at all in the slide show.