# &app; Manual V&manrevision;

2003-2004
Andrew Burton
gPhoto Project
Andrew
Burton
gPhoto Project

     adburton@users.sourceforge.net

Gtkam Manual V&manrevision;
&date;

Andrew Burton adburton@users.sourceforge.net

gPhoto Project

This manual describes version &appversion; of Gtkam.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

&app; is a convenient and easy-to-use program that lets you view and download photos and movies taken on your digital camera. &app; supports almost 400 cameras.

&app; has the following features:

- Support for both serial and USB cameras.

- Easy access to photos and movies on the camera.

- Support for downloading photos and movies from, and uploading files to, the camera.

- Support for interrogating, and modifying, camera settings.

Some cameras are not supported. You should check the gPhoto website to see whether your camera is supported. Not all features are available on all cameras.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Graphics Gtkam .

Command line

  To start &app; from a command line, type the following command, then press Return:

  `gtkam`

### When You Start &app;

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

#### &app; Start Up Window

The &app; main window. On the left is the camera tree. The file list is on the right.

The &app; window contains the following elements:

Menubar.

  The menus on the menubar contain all of the commands you need to use your camera in &app;.

Toolbar.

  The toolbar contains buttons allowing you to control the zoom of the thumbnails. You can also choose whether or not to show the thumbnails using the thumbnail toggle.

Camera tree pane.

  The camera tree contains a list of all cameras that have been added . If a camera is available, an arrow appears to the left of it's name in the camera tree, and you can click on the arrow to list the folders.

Folder contents pane.

  The right pane lists the contents of the currently-selected folder in the camera tree. You can choose whether thumbnails are shown for each photo by toggling the View Thumbnails checkbox.

## Usage

You can use &app; to perform the following tasks:

### Adding and Removing Cameras

Before you can start viewing and copying photos on your camera, you will need to add a camera. To add a camera, choose Camera Add Camera or right-click anywhere on the camera tree pane and choose Add Camera from the pop-up menu that appears. The Add Camera window is displayed.

#### &app; Add Camera Window

The &app; Add Camera window allows you to add a new camera.

To add a camera, make sure the camera is plugged in and turned on, and click the Detect button. This should automatically detect your camera.

Some cameras can only be detected by &app; in their Playback mode.

Alternatively, you can choose the camera yourself. Click the Model: drop-down list and scroll down to find your camera. The Port: drop-down list will change to only list available ports for the camera that you have access to.

If you do not have read access to the port your camera is plugged in to, you will not be able to use &app; with that camera. Also, some features require write access to the port.

You can choose the Advanced button for additional settings.

- Multiple front-ends — This option allows different programs to access the camera while &app; is running.

- Add — You can type in the location of the port where your camera is located.

- Speed — You can specify the transfer speed used to retrieve photos from your camera. This option is only available for serial cameras.

When you are happy with your choices, click OK to close the window and return to the main window. Alternatively, click Apply to add the camera and stay in this window to make further changes.

Once you have added a camera, it will be available the next time you use &app;.

### Viewing Your Photos

When you select a folder in the camera tree pane by clicking on it with the left mouse button, a list of the files in that folder is displayed on the right. If the file is a photo or a movie, gtkam displays a thumbnail. You can zoom in and out on these thumbnails by clicking on the Zoom buttons.

- View Thumbnails — This toggle box turns the thumbnails on and off when viewing photos.

- Zoom In — Enlarges the thumbnails.

- Zoom 100 — Resizes the thumbnail to their default size.

- Zoom Out — Shrinks the thumbnails.

If you have installed other image viewing applications, you can use these to view photos from within &app;.

### Saving Your Photos

You can save files from your camera to your computer. To save, choose File Save Selected to save the selected file, or File Save All to save all the photos in the selected folder.

#### &app; Save Window

The &app; Save window allows you to save your photos to your computer.

You can use the checkboxes to decide what is saved. By default, only the photo is saved. You can specify additional data to save by checking the appropriate checkbox.

If you want to use your own filenames, rather than those used by the camera, you need to toggle the Use filename(s) provided by the camera off. This allows you to enter your own filename prefix. For example, if you enter 'photo' as the prefix, the photos will be saved as 'photo0001.jpg', 'photo0002.jpg' and so on. If you want to start the numbering scheme higher, change the Start numbering with number to a different value.

If there are files already in the target directory with the same prefix, this number will be automatically set as the next available number.

If you save all the photos, you can change some additional options in the file selection window:

#### &app; Save All Window

The &app; Save All window allows you to save your photos to your computer.

### Deleting Photos

To delete photos, select the file(s) to delete and choose File Delete Selected . To delete all the files in the directory, choose File Delete All. A confirmation window will appear, asking you to confirm the files to be deleted. . If you don't want to delete a file, click the checkbox next to the filename so that no tick is present.

If you delete a file from the camera, it is not possible to undelete it. Please be sure you want to delete the file before you click OK.

### Camera Operations

You can perform a number of operations on your camera by right-clicking on the camera name in the camera tree pane. A pop-up menu will appear with the following options:

- Make Directory... — This option prompts you to enter a filename for a new directory to be created in the current directory on the camera.

  #### &app; Make Directory Window

  The &app; Make Directory window allows you to create a new directory on the camera.

- Remove directory — This option removes the folder selected in the camera tree pane from the camera.

- Capture Image... — This option opens a window which allows you to take a photo.

- Preferences — This option opens a window containing information about the camera and its driver.

- View camera summary... — This option opens a window containing information about the camera.

- Manual

- About — This option displays information about the camera driver and its authors.

- Select Camera — This option opens the window, allowing you to change the settings of the camera.

- Remove Camera — Removes the camera from the list of known cameras. The next time you start &app;, this camera won't be displayed.

## Known Bugs and Limitations

&app; attempts to interact with all digital cameras on the market. Unfortunately, not every camera manufacturer provides details on how their cameras work. Some features may not be available for your camera.

The gPhoto website maintains a list of known bugs. If you find a bug, please let us know.

## About &app;

&app; was written by the gPhoto team. To find more information about &app;, please visit the gPhoto 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.