You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
352 lines
7.7 KiB
352 lines
7.7 KiB
<?xml version="1.0" ?>
|
|
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
|
|
<!ENTITY kappname "&kruler;">
|
|
<!ENTITY package "tdegraphics">
|
|
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
|
|
<!ENTITY % addindex "IGNORE">
|
|
]>
|
|
|
|
<book lang="&language;">
|
|
|
|
<bookinfo>
|
|
<title>The &kruler; Handbook</title>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Lauri</firstname>
|
|
<surname>Watts</surname>
|
|
<affiliation>
|
|
<address><email>&Lauri.Watts.mail;</email></address>
|
|
</affiliation>
|
|
</author>
|
|
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
|
|
<legalnotice>&FDLNotice;</legalnotice>
|
|
|
|
<copyright>
|
|
<year>2001</year>
|
|
<holder>&Lauri.Watts;</holder>
|
|
</copyright>
|
|
|
|
<date>2005-12-10</date>
|
|
<releaseinfo>3.5</releaseinfo>
|
|
|
|
<!-- Abstract about this handbook -->
|
|
|
|
<abstract>
|
|
<para>
|
|
&kruler; can be used to measure objects on the screen.
|
|
</para>
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>KDE</keyword>
|
|
<keyword>KRuler</keyword>
|
|
<keyword>tdegraphics</keyword>
|
|
</keywordset>
|
|
|
|
</bookinfo>
|
|
|
|
<chapter id="introduction">
|
|
<title>Introduction</title>
|
|
|
|
<para>&kruler; is a very simple application, with only one aim in life. To
|
|
measure distances on your screen.</para>
|
|
|
|
<para>To start &kruler;, choose <menuchoice><guimenu>Graphics</guimenu>
|
|
<guisubmenu>More Applications</guisubmenu>
|
|
<guimenuitem>KDE Screen Ruler</guimenuitem></menuchoice> from your
|
|
<guimenu>K</guimenu> menu.</para>
|
|
|
|
<para>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.</para>
|
|
|
|
<para>When you move the mouse over &kruler;, your cursor will turn into an
|
|
elongated arrow, with a circle at one end. As you move the cursor, &kruler; will
|
|
display how far from the point marked <guilabel>0</guilabel> the circle on the
|
|
end of the cursor currently is. &kruler; will also display the
|
|
&HTML; color code of the color currently under the circle.
|
|
This is very useful for picking out colors from an image. If you move the
|
|
mouse far enough that the arrow cursor is no longer touching &kruler;, the
|
|
cursor will revert to normal, allowing you to carry on working with your other
|
|
applications.</para>
|
|
|
|
<para>You can change the orientation using the context menu, described in the
|
|
next chapter.</para>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="menu-reference">
|
|
<title>Menu Reference</title>
|
|
|
|
<para>Clicking with the &RMB; on the ruler will pop up a context menu, with the
|
|
following entries:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>This submenu contains entries that allow you to change the orientation of
|
|
&kruler;</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>N</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>North</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns &kruler; so the ruler is horizontal, and the measurements are on the
|
|
top (North) of the ruler</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>E</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>East</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns &kruler; so the ruler is vertical, and the measurements are on the
|
|
right (East) of the ruler</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>S</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>South</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns &kruler; so the ruler is horizontal, and the measurements are on the
|
|
bottom (South) of the ruler</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>W</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>West</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns &kruler; so the ruler is vertical, and the measurements are on the
|
|
left (West) of the ruler</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>R</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>Turn Right</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns the ruler 90 Degrees to the right. For example, if it is oriented
|
|
South, it will rotate to be oriented West.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycap>L</keycap>
|
|
</shortcut>
|
|
<guisubmenu>Orientation</guisubmenu>
|
|
<guimenuitem>Turn Left</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Turns the ruler 90 Degrees to the left. For example, if it is oriented
|
|
West, it will rotate to be oriented South.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<guisubmenu>Length</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>This submenu contains entries that allow you to change the length of
|
|
&kruler;</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul">&Ctrl;
|
|
<keycap>S</keycap></keycombo>
|
|
</shortcut>
|
|
<guisubmenu>Length</guisubmenu>
|
|
<guimenuitem>Short</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Makes &kruler; short - about 385 pixels long.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
|
|
</shortcut>
|
|
<guisubmenu>Length</guisubmenu>
|
|
<guimenuitem>Medium</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Makes &kruler; a medium length - about 640 pixels long.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
|
|
</shortcut>
|
|
<guisubmenu>Length</guisubmenu>
|
|
<guimenuitem>Tall</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Makes &kruler; long - about 960 pixels in length.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
|
|
</shortcut>
|
|
<guisubmenu>Length</guisubmenu>
|
|
<guimenuitem>Full Screen Width</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Makes &kruler; the same size as your screen width.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Choose Color...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Displays the standard &kde; color picker dialog, where you can choose the
|
|
background color for &kruler;.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>F</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Choose Font...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Displays the standard &kde; font dialog where you can choose the font for
|
|
&kruler;.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<guisubmenu>Help</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
&help.menu.documentation;
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Quit</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para><action>Quits</action> &kruler;</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="credits-and-license">
|
|
<title>Credits and Licenses</title>
|
|
|
|
<para>&kruler;</para>
|
|
|
|
<para>Copyright 2000, 2001 Till Krech <email>till@snafu.de</email></para>
|
|
|
|
<para>Thanks to Gunnstein Lye <email>gl@ez.no</email> for the initial port to
|
|
&kde; 2</para>
|
|
|
|
<para>Documentation Copyright &Lauri.Watts;
|
|
&Lauri.Watts.mail;</para>
|
|
|
|
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
|
|
|
&underFDL;
|
|
&underGPL;
|
|
|
|
</chapter>
|
|
|
|
<appendix id="installation">
|
|
<title>Installation</title>
|
|
|
|
&install.intro.documentation;
|
|
|
|
&install.compile.documentation;
|
|
|
|
</appendix>
|
|
|
|
&documentation.index;
|
|
</book>
|