# The &kooka; Manual

## Introduction

&kooka; is a &kde; application that enables easy scanning using SANE libraries. Therefore,SANE the package must be installed to use &kooka;. Clear and concise use was the focus of its development.

Character recognition is also provided by the built-in text recognition program gocr. Install gocr to use this functionality. After character recognition is complete, the recognized material can be opened in the text editor &kate; with just one click, where you can edit the contents.

## Application Instructions

The web site http://www.mostang.com/sane has information about supported scanners. Refer to it before purchasing a scanner, if possible.

### The &kooka; Main Window

The &kooka; Main Window

Start &kooka; from a console by simply entering ``kooka``. Create a link on the &kde; desktop, which uses a scanner icon, if desired.

The main window in &kooka; consists of three frames. At the top, see both icon and a menu panels. Use the mouse to enlarge or reduce the windows as needed.

- The navigation window consists of two tabs, which allow you to switch between the Preview and the integrated file browser called the Gallery. The working directory is displayed in the lower part of the window along with the directory where the scan will be saved.

- Make your scanner-dependent settings, which are dependent on the scanner you have connected, in the lower left window. Usually, these are settings for resolution, brightness and contrast, scanning mode (⪚, color, gray, or binary), and for gamma values.

  Configure your settings here first. Afterwards, initiate the preview scan with Preview. If the Preview tab in the upper window is selected, see the results there.

  Select the various formats in the preview image itself to define the final dimensions. The User setting is recommended for this, so you select the area to scan in the preview display with the mouse.

  After this is done, click Scan to scan the selection made in the preview. After scanning, you will be asked in which format to save the image whether to make this your standard format (without being prompted to confirm your selection in the future).

  If you checked that you do not want to be asked about the save format, the memory assistant will no longer appear. To change the format some time in the future, select Settings Configure Kooka... Save Image Always show memory assistant

- The large window shows how the image appears after a final scan.

## Command References

### The main &kooka; Toolbar

#### The File Menu

&Ctrl;P File Print

- Prints the displayed image.

File Create Directory...

- Create a directory to hold your images.

File Save Image

- Save the image selected underneath the Kooka Gallery.

  See the Save section for details.

File Delete Image

- Delete the image selected underneath the Kooka Gallery.

File Unload Image

- Remove the image displayed in the Image Viewer.

&Ctrl;Q File Quit

- Quit &kooka;.

#### The Image Menu

&Ctrl;G Image Open image in graphic application

- Enter a graphics application for opening your scanned image directly. Recommended applications include The GIMP.

&Ctrl;O Image OCR image...

- Start the window for optical character recognition (OCR). If you have gocr installed, then the path to it should be in the path line. This starts the character recognition for the preview image or for the highlighted area.

&Ctrl;C Image OCR on selection...

- A window will reappear for the character recognition. Here, however, the character recognition is only for the area highlighted in the final scan.

&Ctrl;I Image Scale to Width

- This proportionally scales the image in the large canvas to the width of the display.

&Ctrl;H Image Scale to Height

- Proportionately scales the image to the height of the display.

&Ctrl;S Image Original Size

- Restores the original scan size by reducing or enlarging the image in the display.

  There are additional methods of scaling an image: right click the image display. Redefine the three named options and set the enlargement itself. This can also be done in the Preview window.

&Ctrl;N Image Create from selection

- If the scanned image includes more than you want to appear in the final image, use this tool to crop your image by marking your selection in the larger image display to the right then selecting this tool. The image is cropped according to your selection. You may already be familiar with this function from The GIMP crop tool.

&Ctrl;V Image Mirror image vertically

- Flip image vertically.

&Ctrl;M Image Mirror image horizontally

- Flip image horizontally.

&Ctrl;B Image Mirror both directions

- Flip image both horizontally and vertically.

&Ctrl;R Image Rotate image clockwise

- Rotate the image ninety degrees clockwise.

&Ctrl;W Image Rotate image counter-clockwise

- Rotate the image ninety degrees counterclockwise.

&Ctrl;D Image Rotate image 180 degrees

- Rotates image 180 degrees.

#### The Settings Menu

Settings Show Toolbar

- Removes the top toolbar to give additional viewing area.

Settings Show Statusbar

- Removes the bottom statusbar to give additional viewing area.

#### Configuring Shortcuts

The Settings Configure Shortcuts... allows you to specify key bindings

Below is an example of how to configure a short cut for deleting an image.

Picture of shortcut dialog

- Click on the custom button.

- Next click on the primary button.

- Do `CTRLX` and the dialog should disappear. The keybinding is now entered.

Picture of keybinding dialog

Pressing the keys `CTRLX` now deletes the image selected underneath Kooka Gallery.

#### Configuring Toolbars

The Settings Configure Toolbars... Is used to add additional buttons to the toolbars.

Picture of toolbars dialog

- To add a button to the File toolbar,

  Picture of toolbars dialog

  make sure Main Toolbar is displayed in the top combo box.

- Click on one of the items in the left hand pane. This item will now have a blue background showing that it has been selected.

- Next click on the Right arrow button to place it in the right pane.

- Click on `Apply` and then click on `OK`

The new Item should be in the toolbar. Picture of toolbars dialog

#### Configuring Kooka

The Settings Configure Kooka...

Kooka Startup Preferences

- You may want to uncheck Show the scanner selection box on next startup, if you have only one scanner. If you have only one computer you may also want to uncheck Query network for available scanners.

Thumbnail View

- Here the size and the shading of the thumbnails can be adjusted; as well as the background. For example, you might want to reduce the size of the thumbnails if you are scanning many pages from a book.

## Save

More on Saving Images

The method for saving an image is somewhat different in &kooka; than in many other applications. Click the Gallery tab to open a small file browser. This is the directory `~/.kde/share/apps/ScanImages/` In the lower portion of the window, your current subdirectory in the gallery is shown. This is where all scanned images are first saved as files. When starting &kooka; for the first time, you will only see the `ScanImages`. Create subdirectories by right clicking this folder. The selected folder, highlighted in blue, is the first save location of the scanned images. The scans are labeled in ascending numerical order as in `kscan_0001` and `kscan_0002`.

To save an image permanently, left click the name. Next, give a new name and the appropriate ending for the image format chosen when scanning. If you enter a different extension, you will get a message that it does not correspond to the scanned format. Although you can still save the image under this name, it will retain its original format. At present, On-the-fly conversion is not offered.

If you do not want to use this method of managing your images in `~/.kde/share/apps/ScanImages/`, you can, of course, save them to another location. To do this, right click the image name and select Save. Choose any path here. In addition, close or permanently delete images here.

To incorporate other images in the gallery, add them in &konqueror; by dragging and dropping. Open &konqueror; to the directory containing the desired images. Then add them to the &kooka; gallery by dragging them and dropping them into the gallery.

## Character Recognition

As already mentioned, the gocr must be installed. Scan a preview of your document in grayscale or color. You can only scan in binary mode if you have a pure white sheet of paper with black print. Next, highlight the text to be recognized in the preview window. Then, do your final scan in binary mode with Scan.

Now click the second icon from the left, , in the icon panel, OCR on Selection..., or select this item in the Image menu. For your first try, do not change the default settings shown in the emerging OCR window. These are usually appropriate and meet most needs. Now click Start character recognition. You will now see a window containing the OCR results. The quality depends heavily on that of the document itself.

The gocr Window

The text can now be opened by clicking the button with the &kate; editor. After the final scan, mark a selection in the image display to the right to load just a part of the text or image to the OCR. Next, in the icon panel, click the third button from the right or click in the menu on OCR on selection. Now proceed as described in the previous section.

The Results of the OCR

## Credits and License

&kooka;

Copyright for the application 2001-2002 Klaas Freitag freitag@suse.de

Copyright for the documentation 2002 Martin Sommer msommer@suse.de

&underFDL; &underGPL;

## Installation

&install.intro.documentation; &install.compile.documentation;