2000 2001 DOCUMENTATION WRITER 2 1999 2000 DOCUMENTATION WRITER 1 GNOME Documentation Project &legal; Documentation Writer 2 GNOME Documentation Project

doc-writer2@gnome.org

Documentation Writer 1 GNOME Documentation Project

doc-writer1@gnome.org

MY-GNOME-APPLICATION Manual V&manrevision; &date; Documentation Writer 2 docwriter2@gnome.org GNOME Documentation Project Full title of previous manual. Release date of previous manual. Documentation Writer 1 docwriter1@gnome.org GNOME Documentation Project This manual describes version &appversion; of MY-GNOME-APPLICATION. To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page. MY-GNOME-APP mygnomeapp 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 TIFF - Tagged Image File Format XPM - X Pixmap 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. This is a note. You can start &app; in the following ways: Applications menu Choose Submenu Name My-GNOME-APPLICATION . Command line To start &app; from a command line, type the following command, then press Return: myapp 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;, the following window is displayed.

Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and scrollbars. Menubar contains File, View, Settings, and Help menus.

The &app; window contains the following elements: Menubar. The menus on the menubar contain all of the commands you need to work with files in &app;. Toolbar. The toolbar contains a subset of the commands that you can access from the menubar. Statusbar. The statusbar displays information about current &app; activity and contextual information about the menu items. You can use the &app; application to perform the following tasks: To open an image, choose File Open Image . 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 Create New Window . Choose File Open Image 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. The application displays the name of the image file and the size of the image in pixels in the titlebar of the window. If you try to open an image file format that &app; does not recognize, the application displays an error message. This is a caution. 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 Zoom 1:1 . To enlarge or shrink the view of an image so that the image fits the &app; window, choose View Fit to Window . To enlarge or shrink the image to a specific zoom factor, choose View Zoom factor , then choose the appropriate zoom factor from the drop-down list. 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 . This is a tip. 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 close an image, choose File Close This Window . 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 Exit . This is a warning. To configure &app;, choose Settings Preferences . The Preferences dialog contains the following tabbed sections: Interpolation type Use this drop-down list box to specify the interpolation method that &app; uses when the application resizes images. Select one of the following options: Nearest neighbor This method of interpolation takes a location in the original image and replicates the pixel that is nearest to this location. When you zoom in on an image, the pixels are replicated. When you zoom out of an image, the image loses some of its detail. Bilinear This 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. Hyperbolic This is a high-quality, slow method of interpolation. The application performs interpolation on the image in the manner described in Digital Image Warping by George Wolberg. Default: Nearest neighbor. Transparency type Use this drop-down list box to specify how &app; displays transparent or partially opaque backgrounds in images. Select one of the following options: Dark checks This option displays black and dark gray checks. Midtone checks This option displays dark gray and light gray checks. Light checks This option displays light gray and white checks. Black only This option displays solid black. Gray only This option displays solid gray. White only This option displays solid white. Default: Dark checks. Check size Use this drop-down list box to specify the size of the checks to use to display transparent or partially opaque backgrounds in images. This option is only relevant if you choose Dark checks, Midtone checks, or Light checks from the Transparency type drop-down list box. Select one of the following options: Small Medium Large Default: Small. Dither type Use this drop-down list box to specify the dithering method to use to display images. Dithering is a technique that is used to simulate colors in the original image file but that your system can not display. Select one of the following options: None This option does not use dithering. Normal (pseudocolor) This option performs dithering on pseudocolor displays, which use a limited palette of colors. Maximum (high color) This option performs dithering on pseudocolor and high color displays. Default: None. Two-pass scrolling Select this option to render an image in two passes when you scroll the image quickly. The first pass renders a low quality version of the image. The second pass renders a full quality version of the image over the low quality version. Two-pass scrolling enables you to view at least a low quality version of the image at all times regardless of how quickly you scroll the image. Default: unselected. You can set the following viewer preferences: The Image Windows group contains the preferences that you can set to view images in image windows. Use scrollbars Use this drop-down list box to specify when to use scrollbars to scroll through an image. Select one of the following options: Never This option never displays scrollbars. You can use the arrow keys on the keyboard or the mouse to scroll through the image. Only if image does not fit This option displays scrollbars when the image is larger than the image window. Default: Never. Pick window size and zoom factor automatically Select this option to resize the image window to fit the image or to resize the image to fit the image window. If the image is small, &app; resizes the image window to fit the image. If the image is large, &app; resizes the image to fit the image window. Default: unselected. Open images in a new window Select this option to open a new &app; window each time you open an image. If you do not select this option, &app; replaces the existing image with the new image when you open an image. Default: unselected. The Full Screen group contains the preferences that you can set to view images in full screen mode. Use scrollbars Use this drop-down list box to specify when to use scrollbars to scroll through an image. Select one of the following options: Never This option never displays scrollbars. You can use the arrow keys on the keyboard or the mouse to scroll through the image. Only if image does not fit This option displays scrollbars when the image is larger than the full screen. Default: Never. Use 1:1 zoom factor Select this option to use the 1:1 zoom factor when you open an image. The 1:1 zoom factor displays the image at its actual size. Default: selected. Use same zoom factor as image window Select this option to use the same zoom factor that the application uses to display the image in an image window. Default: unselected. Fit all images to screen Select this option to resize images to fill the full screen when you open the images in full screen mode. Default: unselected. Fit standard-sized images to screen Select this option to automatically resize images that are the same size as standard screens so that the images fill the full screen when you open them in full screen mode. If you select this option, &app; ignores the settings for the previous three options when you open an image that is the same size as a standard screen. Examples of standard screen sizes are 640 x 480 pixels, 1024 x 768 pixels, and so on. Default: unselected. Put a bevel around the edge of the screen Select this option to display a 3D beveled border around the full screen view of an image. Default: unselected. &app; was written by GNOME-HACKER (hacker@gnome.org). To find more information about &app;, please visit the MY-GNOME-APP Web page. To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document. This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.