<?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 % English "INCLUDE" > <!-- change language only here -->
]>

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

<title>Desktop Effects</title>
<authorgroup>
<author>&Mike.McBride; &Mike.McBride.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2009-02-10</date>
<releaseinfo>&kde; 4.2</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>KControl</keyword>
<keyword>desktop</keyword>
<keyword>effects</keyword>
</keywordset>
</articleinfo>
<sect1 id="desktop-effects">
<title>Desktop Effects</title>

<sect2 id="desktop-effects-intro">
<title>Introduction</title>

<para>This module is used to configure desktop effects
for &kde;.</para>


<para>This panel is divided into three tabs:  <guilabel>General</guilabel>, 
<guilabel>All Effects</guilabel> and <guilabel>Advanced</guilabel>.</para>

<sect3 id="desktop-effects-general">
<title><guilabel>General</guilabel> tab</title>

<para>At the top of this tab is a checkbox labeled <guilabel>Enable 
desktop effects</guilabel>.  If there is no mark in front of this checkbox, then all 
visual effects of this panel are disabled.  To edit any of these effects, simply 
place a mark in this checkbox.</para>

<para>Below that checkbox there are some common settings for the desktop effects like 
improved window management, shadows, various animations, effects for desktop and 
window switching and the animation speed.</para>
<!-- outdated needs a rewrite
<variablelist>
<varlistentry>
<term><guilabel>Combobox effect:</guilabel></term>
<listitem><para>This combobox has two options.  If this option is set to <guilabel>Animate</guilabel> 
then when a combo box is selected, it will appear to scroll down.  If <guilabel>Disable</guilabel> 
is selected, then the combobox list appears instantly.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tool tip effect:</guilabel></term>
<listitem><para>This combobox has three options.  If this option is set to <guilabel>Animate</guilabel> 
then when a tool tip appears, it will have a short animation.  If <guilabel>Fade</guilabel> is 
selected, the tool tip appears to fade from the background.  If <guilabel>Disable</guilabel> 
is selected, then the tool tip appears instantly.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Menu effect:</guilabel></term>
<listitem><para>This combobox has four options.  If this option is set to <guilabel>Animate</guilabel> 
then when a menu list appears, it will appear to scroll downward.  If <guilabel>Fade</guilabel> is 
selected, the menu list appears to fade from the background.  If <guilabel>Make Transparent</guilabel> 
is selected, the menu list will have a transparent look to it.  The details of that transparency is 
configured in the next part of the dialog.  If <guilabel>Disable</guilabel> 
is selected, then the menu list appears instantly.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Menu tear-off handles:</guilabel></term>
<listitem><para>If this option is set to <guilabel>Disable</guilabel>, then no menus can be separated 
from the application. If <guilabel>Application Level</guilabel> is selected, then it is left up 
to each individual application to determine which menus can be torn separated from the application.</para>
<note><para>Many applications do not have tear off menus.  You cannot tell &kde; to force an 
application to allow tear off menus.  This is determined by the authors of the application.</para></note></listitem>
</varlistentry>
</variablelist>

<para>The next checkbox, labeled <guilabel>Menu drop shadow</guilabel> is used to toggle the drop shadow behind all 
&kde; menus.  A drop shadow is a dark, soft line on the bottom and right sides of the menu, which give the menus the 
appearance that the menu is lifted off the application, and the menu is creating a shadow on the application.</para>

<para>The next section only applies if the combobox labeled <guilabel>Menu Effect</guilabel> is set to 
<guilabel>Make Transparent</guilabel>.  You can use the combo box labeled <guilabel>Menu transparency type:</guilabel> 
to select the method &kde; uses to generate the transparency.  You can use the slider to determine the level of 
transparency in menus.  A preview is visible on the right side of this section.</para>
-->
</sect3>

<sect3 id="desktop-alleffects">
<title><guilabel>All Effects</guilabel> tab</title>

<para>The main part of this page is a list of all available effects grouped 
by <guilabel>Accessibility</guilabel>, <guilabel>Appearance</guilabel>, 
<guilabel>Candy</guilabel>, <guilabel>Focus</guilabel> and <guilabel>Tools</guilabel>.
Use the incremental search bar above the list window to find items in the list.</para>

<para>Check an effect in the list to enable it. Display the <guilabel>About</guilabel> 
dialog by clicking the info button at the right side of the list item. 
Some effects have settings options, in this case there is a tool button 
at the left of the info button. Click it to open a configuration dialog.</para>
<!--
<variablelist> 

<varlistentry> 
<term><guilabel>Highlight buttons under mouse.</guilabel></term>
<listitem>
<para>If there is a mark in this checkbox, when the mouse pointer is above a toolbar 
button, that button will be highlighted with a square around the button.  This is a good visual 
indicator of which button will be selected with a mouse click.</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><guilabel>Transparent toolbars when moving</guilabel></term>
<listitem>
<para>As the title suggests, if this option is selected, the toolbars will be transparent when 
you are moving them around on the screen.</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><guilabel>Text position</guilabel></term>
<listitem>
<para>This combo box lets you determine where on the button the text name of the button will appear as the default.  
If <guilabel>Icon Only</guilabel> is selected, then there is no text on the toolbar buttons.  If  <guilabel>Text Only</guilabel> is selected, then the button's icon is replaced with a text name of  the button. If <guilabel>Text Alongside Icons</guilabel> is selected, then the name of the button will be placed to the <emphasis>right</emphasis> of the icon. If <guilabel>Text Under Icons</guilabel> is selected, the default will be to have the text of the button <emphasis>below</emphasis> the icon.</para>
<tip><para>This option only specifies the <emphasis>default</emphasis> location.  Each application can override the setting used in this panel.</para></tip>
</listitem> 
</varlistentry> 

</variablelist>
-->
</sect3>

<sect3 id="desktop-advanced">
<title><guilabel>Advanced</guilabel> tab</title>

<para>On this tab you can select a <guilabel>Compositing type</guilabel> (<guilabel>OpenGL</guilabel> or <guilabel>XRender</guilabel>) 
and set some options for the selected type.
</para>
</sect3>


</sect2>

</sect1>

</article>
