<page xmlns="http://projectmallard.org/1.0/"
      type="topic"
      id="preferences">
<info>
  <link type="guide" xref="index#topics"/>
  <desc>How to customize Parlatype</desc>
  <credit type="author">
    <name>Gabor Karsay</name>
    <email>gabor.karsay@gmx.at</email>
  </credit>
  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>

<title>Preferences</title>

<p>You can reach the preferences window in the Application Menu (next to <gui>Activities</gui> in the top left corner. There are three tabs: <gui>Waveform</gui>, <gui>Controls</gui> and <gui>Window</gui>.</p>

<section id="waveform">
<title>Waveform</title>

<media type="image" src="figures/parlatype-prefs-waveform.png"/>

<list>
<item><p>Resolution: The resolution of the waveform image is given in pixels per second, e.g. the default resolution of 100 means, that one second is shown with a width of 100 pixels.</p></item>
<item><p>Fixed vs. moving cursor: There are two modes, how to follow the cursor. On slower systems a moving cursor might be smoother.</p></item>
<item><p>Show time scale: Turn the time scale on or off.</p></item>
</list>
</section>

<section id="controls">
<title>Controls</title>

<media type="image" src="figures/parlatype-prefs-controls.png"/>

<list>
<item><p>Jump back on pause: <app>Parlatype</app> will rewind a few seconds on each pause, this way you can easier resume typing. Set this value to 0 if you don't want this behaviour.</p></item>
<item><p>Jump back: Configures how many seconds to skip when the <gui>Jump back</gui> button is pressed.</p></item>
<item><p>Jump forward: Configures how many seconds to skip when the <gui>Jump forward</gui> button is pressed.</p></item>
</list>
</section>

<section id="window">
<title>Window</title>

<media type="image" src="figures/parlatype-prefs-window.png"/>

<list>
<item><p>Remember size: On start-up <app>Parlatype</app> sets the window size to the size it had the last time.</p></item>
<item><p>Remember position: On start-up <app>Parlatype</app> can position its window where you had it when you closed <app>Parlatype</app> last time.</p></item>
<item><p>Start on top: This will put <app>Parlatype</app> on start-up on top of other windows. This might be useful if you are working with a maximized word processor and still want to see the <app>Parlatype</app> window.</p></item>
</list>

<note>
<p><gui>Remember position</gui> and <gui>Start on top</gui> are not available on Wayland.</p>
</note>

</section>

</page>
