1 files changed, 229 insertions, 0 deletions
diff --git a/doc/krita/settings.docbook b/doc/krita/settings.docbook
new file mode 100644
index 00000000..fd72d68d
--- /dev/null
+++ b/doc/krita/settings.docbook
@@ -0,0 +1,229 @@
+<chapter id="settings">
+
+<title>Settings</title>
+
+<para>This chapter describes the various settings that affect the way &krita;
+functions and looks.</para>
+
+<sect1 id="settings-preferences">
+<title>The <guilabel>Preferences</guilabel> dialog</title>
+
+<para>
+A number of options to configure &krita; are available via the
+<guilabel>Preferences</guilabel> dialog, which is available via
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+&krita;...</guimenuitem></menuchoice>. The dialog is divided into several
+sections, which you can open via the sidebar at the left, shown below.
+</para>
+
+<para>
+<screenshot>
+<screeninfo>The available <guilabel>Preferences</guilabel> sections</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-sidebar.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The available <guilabel>Preferences</guilabel> sections</phrase>
+</textobject>
+<caption><para>The available <guilabel>Preferences</guilabel> sections</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<sect2 id="settings-preferences-general">
+<title>The <guilabel>General</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>General</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-general.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>General</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>General</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+This section offers three options. First of all, the setting in the
+<guilabel>Cursor shape:</guilabel> dropdown box determines what the drawing
+cursor looks like. You can choose between a cursor resembling the actual tool
+you are working with, a normal cursor, a crosshair, and a brush-shaped cursor.
+Then you can select the <guilabel>Palette Behavior</guilabel>. You can set
+here when palettes may be <quote>docked</quote> (set aside at a window
+border): always (<guilabel>Allow docking</guilabel>), never
+(<guilabel>Allow only floating</guilabel>), or when there is enough space
+(<guilabel>Allow docking only on large screens</guilabel>). The last option is
+<guilabel>Palette font size:</guilabel> which determines the text size used in
+the palettes. Set this to a larger value if you have trouble reading the text,
+with the side effect that the palettes will take more space.
+</para>
+
+</sect2>
+
+<sect2 id="settings-preferences-display">
+<title>The <guilabel>Display</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>Display</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-display.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>Display</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>Display</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+This section contains just one option. If your graphics card and driver have
+OpenGL support, you can enable it here to make drawing faster (the
+processor of yor graphics card will take over part of the calculations). Be
+warned, though: there are a few cases where enabling OpenGL is known to
+introduce erratic behavior.
+</para>
+
+</sect2>
+
+<sect2 id="settings-preferences-colormanagement">
+<title>The <guilabel>Color Management</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>Color Management</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-color.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>Color Management</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>Color Management</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+Here you can set various options related to colorspaces in rendering, editing
+and printing of images. The topmost option can be used to set the default
+color model for creating new images (useful if you usually want to create CMYK
+images, for instance). Use the <guilabel>Display</guilabel> options to let
+&krita; know what color profile your monitor uses, and how rendering should be
+done. Under <guilabel>Printing</guilabel>, you can set the color model and
+profile for your printer. The next option determines what &krita; should do
+when you paste an image into it that was copied from another application. If
+<guilabel>Use Blackpoint compensation</guilabel> is checked, whenever a
+colorspace conversion is needed, the black points of the source and
+destination colorspaces are matched.
+</para>
+
+</sect2>
+
+<sect2 id="settings-preferences-performance">
+<title>The <guilabel>Performance</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>Performance</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-performance.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>Performance</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>Performance</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+Two options are available here. The <guilabel>Maximum number of tiles kept in
+memory</guilabel> setting indicates how many tiles (image subparts) &krita;
+will keep in memory. The default setting should be reasonable, if you are low
+or very high on memory, you may want to decrease or increase this option,
+respectively. The <guilabel>Swappiness:</guilabel> option determines how eager
+&krita; will be to swap to disk.
+</para>
+
+</sect2>
+
+<sect2 id="settings-preferences-tablet">
+<title>The <guilabel>Tablet</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>Tablet</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-tablet.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>Tablet</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>Tablet</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+If you have a tablet device attached, you can enable it and set its pressure
+sensitivity in this section.
+</para><para>
+You need to activate the tablet devices you want to use with &krita;. There
+are three supported devices: the cursor, the eraser and the stylus. You can
+activate them using the tablet sections. Only use the configuration options of
+a device if you use a non-Wacom tablet, and if the behavior of the tablet is
+unexpected, like moving when you press on the tablet for instance. In this
+situation, you can use the dialog to make sure you have a correct interaction:
+values (position, pressure, tilt...) are sent from the tablet to the computer
+in a given order, it might happen that some tablets do not use the default
+order. You can set this in the configuration options of a device.
+</para>
+
+</sect2>
+
+<sect2 id="settings-preferences-grid">
+<title>The <guilabel>Grid</guilabel> section</title>
+
+<para>
+<screenshot>
+<screeninfo>The <guilabel>Grid</guilabel> section</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-grid.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>The <guilabel>Grid</guilabel> section</phrase>
+</textobject>
+<caption><para>The <guilabel>Grid</guilabel> section</para></caption>
+</mediaobject>
+</screenshot>
+</para>
+
+<para>
+In this section, you can fine-tune &krita;'s grid. The line styles for the
+grid can be set in the <guilabel>Styles</guilabel> option set.
+<guilabel>Colors</guilabel> allows you to choose the line colors for the grid.
+The horizontal and vertical spacing between the main lines can be set under
+<guilabel>Spacing</guilabel>, as well as the amount of subdivisions (in how
+many smaller parts a grid section is subdivided). Furthermore you can set the
+<guilabel>Offset</guilabel>: usually the grid is painted starting at the top
+left corner, if you want the first main grid lines not to start there, you can
+enter an offset (displacement) here.
+</para>
+
+</sect2>
+
+</sect1>
+
+</chapter>