# The &kruler; Handbook

## Introduction

&kruler; is a very simple application, with only one aim in life. To measure pixel distances on your screen. It is useful for working on layout of dialogs, web pages &etc;

To start &kruler;, choose Applications Utilities More Applications Screen Ruler from your application menu.

&kruler; &kruler;

Clicking with the &LMB; on the &kruler; will turn the cursor to a cross with four arrows and enables you to drag &kruler; around the screen.

When you move the mouse over &kruler;, your cursor will turn into a red arrow. As you move the cursor, &kruler; will display how far from the origin the cursor currently is.

You can resize the ruler by moving the mouse over the handle on the left or right edges of &kruler; (the top or bottom edges when it is oriented vertically), holding down the &LMB; and dragging the handle.

You can change the orientation in two different ways:

- Clicking the &MMB; switches the ruler from vertical to horizontal orientation
- Using the context menu, described in the next chapter

## Menu Reference

Clicking with the &RMB; on the ruler will pop up a context menu, with the following entries:

Rotate

- Switches &kruler; from vertical to horizontal orientation.

Scale

- This option lets you set the ruler scale to Right to Left (D), Center Origin (C), Offset (O) and Percentage.

  Changing the offset via the mousewheel is also possible when holding the &LMB;.

Opacity

- This menu item displays a slider to change the opacity of &kruler;.

Configure Shortcuts...

- The Configure Shortcut dialog allows you to assign shortcuts to &kruler; actions, and configure the shortcuts already assigned.

  For more information, read the section about the Shortcuts of the &kde; Fundamentals.

Configure &kruler;...

- &kruler;'s settings dialog &kruler;'s settings dialog

  In this dialog you can change the background color and font and enable the tray icon.

&Ctrl;W Close

- Hides &kruler;. It can be shown again using the icon in the system tray. The context menu displays this item only when Show tray icon is checked in the settings dialog.

&Ctrl;Q Quit

- Quits &kruler;

&kruler; has the common &kde; Help menu item, for more information read the section about the Help Menu of the &kde; Fundamentals.

## Keyboard Handling

You can move the ruler using the arrow key buttons.

You can move the mouse cursor, and thus the indicator, by holding down &Alt; and using the arrow buttons.

Hold down &Shift; while doing one of those to move faster.

## Credits and License

&kruler;

Copyright 2000, 2001 Till Krech till@snafu.de

Copyright 2009 Mathias Soeken msoeken@tzi.de

Thanks to Gunnstein Lye gl@ez.no for the initial port to &kde; 2

Documentation Copyright &Lauri.Watts; &Lauri.Watts.mail;

&underFDL; &underGPL;
&documentation.index;