<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>
<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>
<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><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>
<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>
<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><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>
<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><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>
<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><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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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 (⪚ <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>
<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>TDEDIR</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>TDEHOME</envar>/share/apps/kdesktop/patterns/</filename></para>
<para>For best results, the pattern should be a grayscale PNG file.</para>