← Back to branch summary

~ubuntu-branches/ubuntu/utopic/kde-workspace/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/kcontrol/joystick/index.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Michał Zając
  • Date: 2011-07-09 08:31:15 UTC
  • Revision ID: james.westby@ubuntu.com-20110709083115-ohyxn6z93mily9fc
Tags: upstream-4.6.90
Import upstream version 4.6.90

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/kcontrol/joystick/index.docbook
 
1
<?xml version="1.0" ?>
 
2
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 
3
"dtd/kdex.dtd" [
 
4
  <!ENTITY % addindex "IGNORE">
 
5
  <!ENTITY % English "INCLUDE">
 
6
]>
 
7
<article lang="&language;">
 
8
<articleinfo>
 
9
<title>Joystick</title>
 
10
<authorgroup>
 
11
<author>
 
12
<firstname>Michael</firstname>
 
13
<surname>Anderson</surname>
 
14
<affiliation>
 
15
<address><email>nosrednaekim@gmail.com</email></address>
 
16
</affiliation>
 
17
</author>
 
18
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
19
</authorgroup>
 
20
 
 
21
<date>2008-05-23</date>
 
22
<releaseinfo>1.0</releaseinfo>
 
23
 
 
24
<keywordset>
 
25
<keyword>KDE</keyword>
 
26
<keyword>System Settings</keyword>
 
27
<keyword>joystick</keyword>
 
28
<keyword>calibrate</keyword>
 
29
</keywordset>
 
30
</articleinfo>
 
31
 
 
32
<sect1 id="kcm_joystick">
 
33
<title><guilabel>Joystick configuration module</guilabel></title>
 
34
 
 
35
<para>This module provides an interface to calibrate your joystick device as well as
 
36
see which functions on your joystick are mapped to which logical button or
 
37
axis.</para>
 
38
 
 
39
<para>
 
40
<screenshot>
 
41
<screeninfo>Here's a screenshot of the joystick module</screeninfo>
 
42
  <mediaobject>
 
43
    <imageobject>
 
44
      <imagedata fileref="joystick-main.png" format="PNG"/>
 
45
    </imageobject>
 
46
    <textobject>
 
47
      <phrase>The joystick module</phrase>
 
48
    </textobject>
 
49
  </mediaobject>
 
50
</screenshot>
 
51
</para>
 
52
 
 
53
<variablelist>
 
54
<varlistentry><term><guilabel>Device</guilabel></term>
 
55
<listitem>
 
56
<para>
 
57
Here you can see the logical location of the device. If you have more
 
58
than one joystick device, you can also select which one to configure.
 
59
</para>
 
60
</listitem>
 
61
</varlistentry>
 
62
 
 
63
<varlistentry><term><guilabel>Position</guilabel></term>
 
64
<listitem>
 
65
<para>
 
66
The plotted location of the X and Y axes of the joystick. Enable <guibutton>Show trace</guibutton>
 
67
to plot the path of the joystick from one point to another.
 
68
</para>
 
69
<tip><para>
 
70
If the joystick cannot reach every point on this graph, or if it does not center correctly, you need to calibrate your device.
 
71
</para></tip> 
 
72
</listitem>
 
73
</varlistentry>
 
74
 
 
75
<varlistentry><term><guilabel>Buttons</guilabel></term>
 
76
<listitem>
 
77
<para>
 
78
A place to see the pressed state of buttons on your joystick and if the buttons
 
79
are mapped correctly. When a joystick button is pressed, <guilabel>PRESSED</guilabel> will appear
 
80
next to the logical number (as the computer sees it) of the button which was
 
81
pressed.
 
82
</para>
 
83
</listitem>
 
84
</varlistentry>
 
85
 
 
86
<varlistentry><term><guilabel>Axes</guilabel></term>
 
87
<listitem>
 
88
<para>
 
89
This displays the numerical values of the axis positions. 0 is centered and the
 
90
maximum and minimum values depend on the joystick and the particular axis.
 
91
</para>
 
92
</listitem>
 
93
</varlistentry>
 
94
 
 
95
<varlistentry><term><guilabel>Calibrate</guilabel></term>
 
96
<listitem>
 
97
<para>
 
98
Clicking on <guibutton>Calibrate</guibutton> will open a dialog to calibrate every axis on your joystick. 
 
99
</para>
 
100
 
 
101
<para>
 
102
<screenshot>
 
103
<screeninfo>Calibrating your joystick</screeninfo>
 
104
  <mediaobject>
 
105
    <imageobject>
 
106
      <imagedata fileref="joystick-calibration.png" format="PNG"/>
 
107
    </imageobject>
 
108
    <textobject>
 
109
      <phrase>Calibrating your joystick</phrase>
 
110
    </textobject>
 
111
  </mediaobject>
 
112
</screenshot>
 
113
</para>
 
114
 
 
115
<para>
 
116
Each axis will have to be moved to the minimum position, then the center, and finally the
 
117
maximum position. A meter in the bottom left corner of the dialog will help
 
118
determine which way increases and which way decreases the values.
 
119
</para>
 
120
</listitem>
 
121
</varlistentry>
 
122
</variablelist>
 
123
</sect1>
 
124
</article>
 
125
 
 
126
<!--
 
127
Local Variables:
 
128
mode: xml
 
129
sgml-minimize-attributes:nil
 
130
sgml-general-insert-case:lower
 
131
sgml-indent-step:0
 
132
sgml-indent-data:nil
 
133
End:
 
134
 
 
135
vim:tabstop=2:shiftwidth=2:expandtab
 
136
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
 
137
-->