# The &kmag; Handbook

Sarang
Lakare

    sarang@users.sf.net

2000
2002
Sarang Lakare
&FDLNotice;
2003-09-16
0.20.00

&kmag; is a screen magnifier. You can use &kmag; to magnify a part of the screen just as you would use a lens to magnify a newspaper fine-print or a photograph. This application is useful for a variety of people: from researchers to artists to web-designers to people with low vision. This document will try to be a complete reference manual for using &kmag;.

KDE
kmag
K Magnifier

## Introduction

&kmag; is a screen magnifier for the K Desktop Environment (&kde;). It can be used to magnify a part of the screen. This application can be useful to various people: People with low vision can use this application to magnify a part of the screen which they are unable to view clearly, artists can use this application to zoom into the graphics they produce and verify it at the pixel level, image-processing researchers can use this application to zoom into images and study them closely. Other than these, &kmag; can be used for various other purposes &eg; is possible to use the application for grabbing a portion of the screen and saving it to the disk (with an option of zooming the screen captured).

&kmag; is a very powerful application with new features being added all the time. It is optimized for use on low processing power machines.

## Using &kmag;

Here's a screen shot of &kmag;
Screen shot of &kmag;

After running &kmag; you will get a window similar to the one show above. The main window of &kmag; shows the magnified (or zoomed) contents. We refer to this window as the zoom window. The zoomed image shown inside the zoom window is captured from a part of the screen. The part of the screen which is magnified is referred to as the selection window.

You can use &kmag; to magnify the same part of the screen all the time, or you can let &kmag; magnify the region around the mouse cursor (think of it as a moving lens). The default mode of operation is the former. To see the marking of the part of the screen that is being magnified, you can select Selection Window. It is always better to turn Selection Window off once you know the placement of the selection window.

To magnify the contents around the mouse cursor, select Follow Mouse. Now as you move the mouse, you will see that the screen around the mouse cursor is magnified and shown in the magnifier window.

If you would prefer not to see the mouse cursor in the zoomed image, select Hide Mouse Cursor. Please note that &kmag; cannot yet find out the current cursor shape. Thus, it shows the default &kde;/&Qt; cursor.

### Changing the part of the screen to be magnified

When not in Follow Mouse mode, the selection window can be changed as needed. The selection window can be moved or resized. This can be done using the mouse in the following way:

Left mouse button

  By keeping this mouse button pressed and moving the mouse, you can grab and drag the contents of the zoom window.

&Shift;Left or Middle mouse button.

  By using this combination, you can change the position of the selection window on the screen. As soon as you use the above combination, you will see the current position of the selection window. You can now move the mouse to drag the selection window around. When you are satisfied with its position, just leave all the buttons that you had pressed.

&Ctrl;Left mouse button

  By using this combination, you can resize the selection window. Keep in mind that the top-left corner of the selection window is kept constant and the bottom-right corner is movable.

### More &kmag; features

&kmag; comes with lots of features. Its possible to print the zoomed image directly to a printer, save the image to a file, copy the zoomed image to the clipboard (which can be later used to paste in other applications), show different mouse cursors and more.

## Command Reference

&kmag; automatically uses all your default shortcuts for saving file, opening new window, printing, starting/stopping refresh (reload button in &konqueror;), zoom-in, zoom-out &etc;

### Default Keyboard Shortcuts

&Ctrl;S | This will save the contents of the zoom window to a file.
F5 | This will start the refresh of the zoom window if it is stopped, or stops the refresh of the zoom window if the refresh is currently on.
&Ctrl;P | This will open the print dialog for printing the contents of the zoom window.
&Ctrl;C | This will copy the zoom window contents to the clipboard.
&Ctrl;- | Zoom out
&Ctrl;&Shift;+ | Zoom in

## Credits and License

&kmag;

Program copyright 2001-2003 Sarang Lakare sarang@users.sf.net

Contributors:

- Michael Forster forster@fmi.uni-passau.de (original author)

- Olaf Schmidt ojschmidt@kde.org

Documentation copyright 2002 Sarang Lakare sarang@users.sf.net

&underFDL; &underGPL;

## Installation

### How to obtain &kmag;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

&documentation.index;