doc/kmplot/configuration.docbook

   1 <chapter id="configuration">
   2 <title>Configuring &kmplot;</title>
   3 <para>To access the &kmplot; configuration
   4 dialog, select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
   5 KmPlot...</guimenuitem></menuchoice>. A number of settings can also be changed
   6 from options in the <guimenu>Edit</guimenu> menu, as well. </para>
   7
   8 <note>
   9 <para>Settings changed in the &kmplot; configuration dialog become the
  10 default for &kmplot;, and only take effect when a new plot is started. Settings
  11 changed in the <guimenu>View</guimenu> menu take effect immediately, but do not
  12 persist after &kmplot; is exited.</para>
  13 </note>
  14
  15 <sect1 id="general-config">
  16 <title><guilabel>General</guilabel> Configuration</title>
  17 <para>Here you can set global settings which automatic will be saved when you exit &kmplot;. In the first tab you can set calculation-precision, angle-mode (radians and degrees), background color and zoom in and zoom out factors. </para><para>The second tab let you define you own constants.  &kmplot; saves the constains 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 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>
  18
  19 <screenshot>
  20 <screeninfo>Here is a screenshot of the &kmplot; welcome window</screeninfo>
  21         <mediaobject>
  22           <imageobject>
  23             <imagedata fileref="settingsdlg.png" format="PNG"/>
  24           </imageobject>
  25           <textobject>
  26             <phrase>Screenshot</phrase>
  27           </textobject>
  28         </mediaobject>
  29 </screenshot>
  30
  31 </sect1>
  32
  33
  34 <sect1 id="colors-config">
  35 <title><guilabel>Colors</guilabel> Configuration</title>
  36 <para>In the <guilabel>Coords</guilabel> tab of the <guilabel>Colors</guilabel>
  37 configuration option, you can change the colors of the axes and grid of the
  38 main &kmplot; area.</para>
  39 <para>In the <guilabel>Functions</guilabel> tab, you can change the colors used
  40 for the graphs of the ten functions allowed in &kmplot;.</para>
  41 </sect1>
  42
  43 <sect1 id="coords-config">
  44 <title><guilabel>Coords</guilabel> Configuration</title>
  45
  46 <sect2 id="axes-config">
  47 <title>The <guilabel>Axes</guilabel> Configuration</title>
  48 <para>
  49 <variablelist>
  50
  51 <varlistentry>
  52 <term><guilabel>X-Axis</guilabel></term>
  53 <listitem>
  54 <para>Sets the range for the x-axis scale. You can choose one of the
  55 predefined ranges, or select <guilabel>Custom</guilabel> to make your
  56 own. Note that in the <guilabel>Custom</guilabel> boxes, you can use the
  57 predefined functions and constants (see <xref linkend="func-predefined"/>) as
  58 the extremes of the range (&eg;, set <guilabel>min:</guilabel> to
  59 <userinput>2*pi</userinput>). You can even use functions you have defined to
  60 set the extremes of the axis range. For example, if you have defined a function
  61 <userinput>f(x)=x^2</userinput>, you could set <guilabel>min:</guilabel> to
  62 <userinput>f(3)</userinput>, which would make the lower end of the range equal
  63 to 9.</para>
  64 </listitem>
  65 </varlistentry>
  66
  67 <varlistentry>
  68 <term><guilabel>Y-Axis</guilabel></term>
  69 <listitem>
  70 <para>Sets the range for the y-axis. See <quote>X-Axis</quote> above.</para>
  71 </listitem>
  72 </varlistentry>
  73
  74 <varlistentry>
  75 <term><guilabel>Axes line width</guilabel></term>
  76 <listitem>
  77 <para>Sets the width of the lines representing the axes.</para>
  78 </listitem>
  79 </varlistentry>
  80
  81 <varlistentry>
  82 <term><guilabel>Tic width</guilabel></term>
  83 <listitem>
  84 <para>Sets the width of the lines representing tics on the axes.</para>
  85 </listitem>
  86 </varlistentry>
  87
  88 <varlistentry>
  89 <term><guilabel>Tic length</guilabel></term>
  90 <listitem>
  91 <para>Sets the length of the lines representing tics on the axes.</para>
  92 </listitem>
  93 </varlistentry>
  94
  95 <varlistentry>
  96 <term><guilabel>Labels</guilabel></term>
  97 <listitem>
  98 <para>If checked, the names (x, y) of the axes are shown on the plot.</para>
  99 </listitem>
 100 </varlistentry>
 101
 102 </variablelist>
 103 </para>
 104
 105 </sect2>
 106
 107 <sect2 id="grid-config">
 108 <title>The <guilabel>Grid</guilabel> Configuration</title>
 109 <para>You can set the <guilabel>Grid Style</guilabel> to one of four options:
 110 <variablelist>
 111
 112 <varlistentry>
 113 <term><guilabel>No Grid</guilabel></term>
 114 <listitem>
 115 <para>No gridlines are drawn on the plot area</para>
 116 </listitem>
 117 </varlistentry>
 118
 119 <varlistentry>
 120 <term><guilabel>Lines</guilabel></term>
 121 <listitem>
 122 <para>Straight lines form a grid of squares on the plot area.</para>
 123 </listitem>
 124 </varlistentry>
 125
 126 <varlistentry>
 127 <term><guilabel>Crosses</guilabel></term>
 128 <listitem>
 129 <para>Crosses are drawn to indicate points where x and y have integer values
 130 (&eg;, (1,1), (4,2) &etc;).</para>
 131 </listitem>
 132 </varlistentry>
 133
 134 <varlistentry>
 135 <term><guilabel>Polar Grid</guilabel></term>
 136 <listitem>
 137 <para>Lines of constant radius and of constant angle are drawn on the plot
 138 area.</para>
 139 </listitem>
 140 </varlistentry>
 141 </variablelist>
 142 </para>
 143 <para>The <guilabel>Line width</guilabel> option is used to set the width of
 144 the lines of the grid.</para>
 145 </sect2>
 146
 147 <sect2 id="font-config">
 148 <title>The <guilabel>Fonts</guilabel> Configuration</title>
 149 <para><guilabel>Header table</guilabel> sets the font for the information table
 150 shown in &kmplot; printouts, and <guilabel>Axes labels</guilabel> sets the font
 151 used for all labels on the axes in the plot area.</para>
 152 </sect2>
 153
 154 </sect1>
 155
 156 <sect1 id="scaling-config">
 157 <title><guilabel>Scaling</guilabel> Configuration</title>
 158
 159 <para>For each axis, you can set the <guilabel>Scaling</guilabel> and
 160 <guilabel>Printing</guilabel> of one tic.  The <guilabel>Scaling</guilabel>
 161 option selects how many units apart the axis tics will be (and therefore, how
 162 far apart grid lines will be drawn), and the <guilabel>Printing</guilabel>
 163 option selects the length of one tic when displayed on the screen or
 164 printed. In this way, these options can be used to change the size of the graph
 165 on screen or on a page: For example, doubling the <guilabel>Printing</guilabel>
 166 setting whilst keeping the <guilabel>Scaling</guilabel> setting the same will
 167 result in the graph doubling in in height or width.</para>
 168 </sect1>
 169
 170 </chapter>
 171
 172 <!--
 173 Local Variables:
 174 mode: sgml
 175 sgml-minimize-attributes:nil
 176 sgml-general-insert-case:lower
 177 sgml-indent-step:0
 178 sgml-indent-data:nil
 179 sgml-parent-document:("index.docbook" "BOOK" "CHAPTER")
 180 End:
 181 -->