<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>

<authorgroup>
<author
>&Mark.Donohoe;</author>
<author
>&Martin.R.Jones;</author>
<!-- <author
>&Duncan.H;</author
> -->
<author
>&Mike.McBride;</author>

<othercredit role="translator"
><firstname
>John</firstname
><surname
>Knight</surname
><affiliation
><address
><email
>anarchist_tomato@herzeleid.net</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</authorgroup>

<date
>2003-09-28</date>
<releaseinfo
>3.2</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</keyword>
<keyword
>background</keyword>
<keyword
>wallpaper</keyword>
</keywordset>
</articleinfo>

<sect1 id="background">

<title
>Background</title>

<para
>The Background module allows you to configure colours or wallpapers for your desktop background.</para>
 
<para
>It is comprised of four areas:</para>
 
<orderedlist>
<listitem>
<para
>Desktop selection area</para>
</listitem>
<listitem>
<para
>The background Preview Monitor</para>
</listitem>
<listitem>
<para
>An area for determining the background colour</para>
</listitem>
<listitem>
<para
>An area for selecting background images</para>
</listitem>
</orderedlist>

<variablelist>
<varlistentry>
<term
>Selecting the desktop</term>
<listitem>
<para
>The drop down box labelled <guilabel
>Setting for desktop:</guilabel
> is used to select the desktop you want to configure. You can select any of the desktops individually, or you can select <guilabel
>All Desktops</guilabel
> and the changes you make will be applied to all desktops.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Preview Monitor</term>
<listitem>
<para
>This is a preview window. It will give you a sense of what to expect with each change.</para>
</listitem>
</varlistentry
>	

<varlistentry>
<term
><guilabel
>Background</guilabel
></term>
<listitem>
<para
>This section allows you to load a wallpaper on top of the colour gradient chosen in the section below.</para>

<para
>There are three choices available here:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>No Picture</guilabel
></term>
<listitem>
<para
>No picture background will be shown. The colour and pattern choices below will still take effect.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Picture</guilabel
></term>
<listitem>
<para
>A single picture will be used as the background for the selected desktops.</para>
<para
>How this picture is positioned and scaled can be fine tuned below.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Slide show</guilabel
></term>
<listitem>
<para
>&kde; allows you to have an automatic slide show of wallpaper images. To enable this option, press the <guibutton
>Setup...</guibutton
> button. In the resulting dialogue you may choose any image or folder of images available on your computer, using the <guibutton
>Add...</guibutton
> button to navigate your file system. <guibutton
>Remove</guibutton
> will remove the currently selected entry from the list.</para
> 

<para
>You may choose the length of time any image is displayed in the <guilabel
>Change picture after:</guilabel
> box, and you may choose <guibutton
>Show pictures in random order</guibutton
> if you don't want them displayed in the order they are listed.</para>

<tip
><para
>Displaying wallpaper requires that the image be kept in memory. If you are low on memory, using a small, tiled image or none at all is recommended.</para>

<para
>Scaling or centreing a small image still requires an image the size of your display to be maintained in memory.</para
></tip>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Options</guilabel
></term>
<listitem>

<variablelist
><!-- Positioning -->
<varlistentry>
<term
>Centred</term>
<listitem
><para
>The image will be centred on the screen without changing the size of the image. The background colours will be present anywhere the image does not cover.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
>Tiled</term>
<listitem
><para
>The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Centre Tiled</term>
<listitem
><para
>The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upward, downward to the right, and to the left.</para>
</listitem
></varlistentry>
<varlistentry>
<term
>Centred Maxpect</term>
<listitem
><para
>The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Tiled Maxpect</term>
<listitem>
<para
>The image will be placed in the corner of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. If there is any space over, the image will be duplicated to fill it. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Scaled</term>
<listitem
><para
>The image will be scaled to fit the desktop. It will be stretched to fit to all four corners. This may distort the image.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Centred Auto fit</term>
<listitem>
<para
>If the picture fits the desktop size, this mode works like the centred option. If the picture is larger than the desktop then it is scaled down to fit while keeping the aspect ratio. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist
><!-- Colors -->
<varlistentry>
<term
><guilabel
>Colours:</guilabel
></term>
<listitem>
<para
>The first drop down box allows you to choose the type of colour, gradient, or pattern to display under (or in place of) wallpaper.</para>
<tip
><para
>If you are going to be using a picture as a wallpaper, you can skip this section of the dialogue box.</para
> 
<para
>However, if your chosen wallpaper does not cover the entire desktop, the chosen colours will still show in the remaining space.</para
></tip>

<variablelist>
<varlistentry>
<term
><guilabel
>Single Colour</guilabel
></term>
<listitem
><para
>By choosing this mode, you select one colour using the first colour bar, and the entire background is covered with this one colour.</para
></listitem
> 
</varlistentry>
<varlistentry>
<term
><guilabel
>Horizontal Gradient</guilabel
></term>
<listitem
><para
>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel
>Primary Colour</guilabel
> on the left edge of the screen, and slowly transform into the colour selected by <guilabel
>Blend Colour</guilabel
> by the time it gets to the right edge of the screen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Vertical Gradient</guilabel
></term>
<listitem
><para
>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel
>Primary Colour</guilabel
> on the top edge of the screen, and slowly transform into the colour selected by <guilabel
>Blend Colour</guilabel
> as it moves to the bottom of the screen.</para
></listitem
> 
</varlistentry>
<varlistentry>
<term
><guilabel
>Pyramid Gradient</guilabel
></term>
<listitem
><para
>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel
>Primary Colour</guilabel
> in each corner of the screen, and slowly transform into the colour selected by <guilabel
>Blend Colour</guilabel
> as it moves to the centre of the screen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Pipecross Gradient</guilabel
></term>
<listitem
><para
>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel
>Primary Colour</guilabel
> in each corner of the screen, and slowly transform into the colour selected by <guilabel
>Blend Colour</guilabel
> as it moves to the centre of the screen. The shape of this gradient is different than the pyramid gradient.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Elliptic Gradient</guilabel
></term>
<listitem
><para
>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel
>Blend Colour</guilabel
> in the centre of the screen, and slowly transform into the colour selected by <guilabel
>Primary Colour</guilabel
> as it moves to the edges, in an elliptical pattern.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><replaceable
>Pattern</replaceable
></term>
<listitem>
<para
>The rest of the list are the names of various patterns or textures you can choose.</para
> 
<para
>Click on <guibutton
>OK</guibutton
>, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <link linkend="bkgnd-patterns"
>Adding, Removing and Modifying Patterns</link
>.</para>

<para
>Select the primary colour with the first colour bar. If you have chosen a pattern that requires two colours to be set the secondary colour can be set by pressing the appropriate button.</para>
</listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>
</variablelist>

<variablelist>
<varlistentry>
<term
><guilabel
>Blending:</guilabel
></term>
<listitem>
<para
>The drop down box labelled <guilabel
>Blending:</guilabel
> contains the options to make a smooth transition (blend) from the wallpaper as it changes to the background.</para>

<orderedlist>
<listitem
><para
>A drop down box allows you to select the blending mode. Many of the modes are similar to blending modes for background colours. Select your mode from the list, and the preview window shows you what it will look like.</para
></listitem
> 
<listitem
><para
>The <guilabel
>Balance</guilabel
> slider adjusts the blending. The results can be seen in the preview window.</para
></listitem>
<listitem
><para
>The <guilabel
>Reverse roles</guilabel
> can reverse the role of the picture and the background for some types of blending.</para>
</listitem>
</orderedlist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

<sect2 id="bkgnd-advanced">
<title
>Advanced options</title>
<para
>Located below the preview monitor is a button labeled <guibutton
>Advanced Options...</guibutton
>.</para>

<para
>To use an external program to determine and change the background of &kde;, simply select <guilabel
>Use the following program for drawing the background</guilabel
>. Available &kde; programs are listed, select one to enable it. To modify your choice, for example to change the refresh times, you may press the <guibutton
>Modify...</guibutton
> button.</para>

<para
>To add a third party application (&eg; <application
>XEarth</application
> you may use the <guibutton
>Add...</guibutton
> button. A dialogue will open allowing you to choose your application, and fill in other data about it. You may remove any entries from this list by selecting it and pressing the <guibutton
>Remove</guibutton
> button.</para>

<para
>Using third party external programs to modify or change the background is beyond the scope of this document, see their respective documentation for the format of command-line switches and other configuration information.</para>

<para
>Also in this section you may choose to set the colour of text that is used for icons on the desktop. If you find icon text difficult to read against a wallpaper or pattern, you can choose a solid colour to show beneath text, or enable a shadow under the text to enhance its appearance.</para>

<para
>Finally you can set the <guilabel
>Size of the background cache:</guilabel
>. The default (2048 KB) is usually a safe choice.</para>

</sect2>

<sect2 id="bkgnd-patterns">
<title
>Adding, Removing and Modifying Patterns</title>

<para
>A pattern is a picture file which &kde; uses as a template to draw your background. The picture file provides the shapes, but &kde; provides the colours. &kde; is packaged with several patterns, and you also can add new patterns.</para>

<para
>To add a new pattern that is available to every user on your computer, simply place the file in <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/kdesktop/patterns/</filename
></para>

<para
>Copy a <literal role="extension"
>.desktop</literal
> file from this folder, and name it the same as your new pattern image file. Modify the contents to suit your new pattern.</para>

<para
>To add a new pattern for a single user, add the files to <filename class="directory"
>$<envar
>KDEHOME</envar
>/share/apps/kdesktop/patterns/</filename
></para>

<para
>For best results, the pattern should be a grayscale PNG file.</para>

</sect2>

</sect1>

</article>