# &app; 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:

  - BMP - Windows Bitmap

  - GIF - Graphics Interchange Format

  - ICO - Windows Icon

  - JPEG - Joint Photographic Experts Group

  - 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

  - XBM - X Bitmap

  - XPM - X Pixmap

  You can view images in the formats that are listed above but you can only use the image saving feature for PNG and JPEG formats.

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

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

- Choose Graphics &app; Image Viewer .

Command line

- To run &app; and open a file from a command line, type the following command, then press Return:

  `eog` `filename.jpg`

  where `filename.jpg` is the name of the file you want to open.

  &app; opens each file that you specify in a new window.

### When You Start &app;

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

#### &app; Start Up Window Before You Open a File

Shows Eye of GNOME main window

## Usage

### To Open an Image

To open an image, choose File Open . The Open Image dialog is displayed. Select the file that you want to open, then click OK.

To open another image in a new window, choose File New Window . Choose File Open to select the file that you want to open. You can also drag an image from another application such as a file manager to the &app; window. If the &app; window is empty, the application displays the image in the window. If the window is not empty, the application starts a new window to display the file.

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, choose File Open . The Open Image dialog is displayed. Select the directory that you want to open, then click OK. &app; displays the images that the directory contains in the &app; window.

### 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 Change the Zoom Factor

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

- To enlarge the view of an image, choose View Zoom In .

- To shrink the view of an image, choose View Zoom Out .

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

- To enlarge or shrink the view of an image so that the image fits the &app; window, 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 key or Ctrl W.

### To Flip Over 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 Save an Image

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

### 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; and close all of the windows that you opened in the current session, choose File Quit .

## Preferences

To configure &app;, choose Edit Preferences .

Image Interpolation

- Select the Interpolate image on zoom (better quality but slower) 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.

Transparency

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

  - As check pattern

    This option displays any transparent parts of the image in a check pattern.

  - As custom color

    This option 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

    This option displays any transparent parts of the image in the background color of the &app; application.