summaryrefslogtreecommitdiffstats
path: root/doc/kmplot/configuration.docbook
blob: ce6f2a5eb2aeee8630400c32f3ec17ae94d478d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
<chapter id="configuration">
<title>Configuring &kmplot;</title> 
<para>To access the &kmplot; configuration
dialog, select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
&kmplot;...</guimenuitem></menuchoice>. A number of settings (<guimenuitem>Colors...</guimenuitem>,
<guimenuitem>Coordinate System...</guimenuitem>, <guimenuitem>Scaling...</guimenuitem> and
<guimenuitem>Fonts...</guimenuitem>) can only be changed
from the <guimenu>Edit</guimenu> menu. </para>

<sect1 id="general-config">
<title><guilabel>General</guilabel> Configuration</title>
<para>Here you can set global settings which automatic will be saved when you exit &kmplot;. In the first page you can set calculation-precision, angle-mode (radians and degrees), background color and zoom in and zoom out factors. </para>

<screenshot>
<screeninfo>screenshot of the &kmplot; settings dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settingsdlg.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>screenshot of the &kmplot; settings dialog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>The second page let you define you own constants.  &kmplot; saves the constants in the same file as &kcalc; does. That means you can create a constant in  &kmplot;, close the program and load it in &kcalc; and vice versa.  &kmplot; only supports constant names that consist of one capital character and if you in &kcalc; define a constant name that is not one character, the name will be truncated. E.g, if you already have the constants "apple" and "bananas" in &kcalc;, they will be renamed to "A" and "B" in &kmplot;.</para>

</sect1>


<sect1 id="colors-config">
<title><guilabel>Colors</guilabel> Configuration</title>
<para>In the <guilabel>Coords</guilabel> tab of the <guilabel>Colors</guilabel>
configuration dialog, you can change the colors of the axes and grid of the
main &kmplot; area.</para>

<screenshot>
<screeninfo>screenshot of the colors configuration dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-colors.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>screenshot of the colors configuration dialog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>In the <guilabel>Default Function Colors</guilabel> tab, you can change the colors used
for the graphs of the ten functions allowed in &kmplot;.</para>
</sect1>

<sect1 id="coords-config">
<title><guimenuitem>Coordinate System</guimenuitem> Configuration</title>

<sect2 id="axes-config">
<title>The <guilabel>Axes</guilabel> Configuration</title>
<para>
<variablelist>

<varlistentry>
<term><guilabel>X-Axis</guilabel></term>
<listitem>
<para>Sets the range for the x-axis scale. You can choose one of the
predefined ranges, or select <guilabel>Custom</guilabel> to make your
own. Note that in the <guilabel>Custom</guilabel> boxes, you can use the
predefined functions and constants (see <xref linkend="func-predefined"/>) as
the extremes of the range (&eg;, set <guilabel>Min:</guilabel> to
<userinput>2*pi</userinput>). You can even use functions you have defined to
set the extremes of the axis range. For example, if you have defined a function
<userinput>f(x)=x^2</userinput>, you could set <guilabel>Min:</guilabel> to
<userinput>f(3)</userinput>, which would make the lower end of the range equal
to 9.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Y-Axis</guilabel></term>
<listitem>
<para>Sets the range for the y-axis. See <quote>X-Axis</quote> above.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Axis-line width:</guilabel></term>
<listitem>
<para>Sets the width of the lines representing the axes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tic width:</guilabel></term>
<listitem>
<para>Sets the width of the lines representing tics on the axes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tic length:</guilabel></term>
<listitem>
<para>Sets the length of the lines representing tics on the axes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show labels</guilabel></term>
<listitem>
<para>If checked, the names (x, y) of the axes are shown on the plot and the axes' tics are labeled.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show extra frame</guilabel></term>
<listitem>
<para>If checked, the plot area is framed by an extra line.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show axes</guilabel></term>
<listitem>
<para>If checked, the axes are visible.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show arrows</guilabel></term>
<listitem>
<para>If checked, the axes are displayed with arrows at their ends.</para>
</listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

<sect2 id="grid-config">
<title>The <guilabel>Grid</guilabel> Configuration</title>
<para>You can set the <guilabel>Grid Style</guilabel> to one of four options:
<variablelist>

<varlistentry>
<term><guilabel>None</guilabel></term>
<listitem>
<para>No gridlines are drawn on the plot area</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Lines</guilabel></term>
<listitem>
<para>Straight lines form a grid of squares on the plot area.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Crosses</guilabel></term>
<listitem>
<para>Crosses are drawn to indicate points where x and y have integer values
(&eg;, (1,1), (4,2) &etc;).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Polar</guilabel></term>
<listitem>
<para>Lines of constant radius and of constant angle are drawn on the plot
area.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>The <guilabel>Line width</guilabel> option is used to set the width of
the lines of the grid.</para>
</sect2>

</sect1>

<sect1 id="scaling-config">
<title><guilabel>Scaling</guilabel> Configuration</title>

<screenshot>
<screeninfo>screenshot of the scaling configuration dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-scaling.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>screenshot of the scaling configuration dialog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>For each axis, you can set the <guilabel>Scaling:</guilabel> and
<guilabel>Printing:</guilabel> of one tic.  The <guilabel>Scaling:</guilabel>
option selects how many units apart the axis tics will be (and therefore, how
far apart grid lines will be drawn), and the <guilabel>Printing:</guilabel>
option selects the length of one tic when displayed on the screen or
printed. In this way, these options can be used to change the size of the graph
on screen or on a page: For example, doubling the <guilabel>Printing:</guilabel>
setting whilst keeping the <guilabel>Scaling:</guilabel> setting the same will
result in the graph doubling in in height or width.</para>
</sect1>

<sect1 id="font-config">
<title><guilabel>Fonts</guilabel> Configuration</title>

<screenshot>
<screeninfo>screenshot of the fonts configuration dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-fonts.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>screenshot of the fonts configuration dialog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para><guilabel>Header table:</guilabel> sets the font for the information table
shown in &kmplot; printouts, and <guilabel>Axis font:</guilabel> and <guilabel>Axis font size:</guilabel>
sets the font and its size used for all labels on the axes in the plot area.</para>
</sect1>

</chapter>