kwin/doc/kwineffects/index.docbook
Nate Graham b9612ca0b7 kcms/kwineffects: use new term "Peek at Desktop"
The widget was renamed a while back, but the KCM still used the old
term to refer to it when letting the user choose the visual effect that
it shows the user. Let's change that.

BUG: 463087
FIXED-IN: 5.27
2022-12-29 18:03:02 +00:00

86 lines
3.7 KiB
XML

<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
"dtd/kdedbx45.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>
<article id="kwineffects" lang="&language;">
<articleinfo>
<title>Desktop Effects</title>
<authorgroup>
<author>&Mike.McBride; &Mike.McBride.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<date>2021-04-09</date>
<releaseinfo>Plasma 5.20</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
<keyword>KControl</keyword>
<keyword>desktop</keyword>
<keyword>effects</keyword>
</keywordset>
</articleinfo>
<!--FIXME Compositor Enable compositor on startup necessary to have effects?-->
<para>This module is used to enable and configure desktop effects
for Plasma.</para>
<para>The main part of this page is a list of all available effects grouped
by <guilabel>Accessibility</guilabel>, <guilabel>Appearance</guilabel>,
<guilabel>Focus</guilabel>, <guilabel>Peek at Desktop Animation</guilabel>, <guilabel>Tools</guilabel>,
<guilabel>Virtual Desktop Switching Animation</guilabel>, <guilabel>Window Management</guilabel>,
and <guilabel>Window Open/Close Animation</guilabel>.</para>
<para>Use the incremental search bar above the list window to find items in the list.</para>
<para>Normally there is no reason for users to change that, but
there is a <inlinemediaobject><imageobject><imagedata fileref="configure-effects.png" format="PNG"/>
</imageobject></inlinemediaobject> configuration button to modify the filtering of the list to show
also those effects.
</para>
<para>The easiest way of installing new effects is by using the built-in
KNewStuff support in &kwin;. Press the <guibutton>Get New Desktop Effects</guibutton> button to open
a dialog with a list of available effects from the Internet and to install and uninstall effects.</para>
<note><para>Please keep in mind that changing these sensible defaults can break your system.</para>
</note>
<para>Check an effect in the list to enable it. Display information about Author and License by
clicking the <inlinemediaobject><imageobject><imagedata fileref="dialog-information.png" format="PNG"/>
</imageobject> </inlinemediaobject> info button at the right side of the list item.</para>
<para>Some effects have settings options, in this case there is a <inlinemediaobject><imageobject>
<imagedata fileref="configure-effects.png" format="PNG"/></imageobject></inlinemediaobject> configure button
at the left of the info button. Click it to open a configuration dialog.</para>
<para>To see a video preview of an effect click on the <inlinemediaobject><imageobject><imagedata fileref="video.png" format="PNG"/>
</imageobject></inlinemediaobject> button.</para>
<para>Some effects are mutual exclusive to other effects. For example one would only want to activate the
<guilabel>Maximize</guilabel> or the <guilabel>Magic Lamp</guilabel> effect. Both activated at the same
time result in broken animations.
</para>
<para>For effects in a mutual exclusive group the &GUI; uses radio buttons and manages that only one of these
effects can be activated.
</para>
<para>All effects which are not supported by the currently used compositing backend
are hidden by default (&eg; OpenGL effects when using software renderer).
</para>
<para>Also all internal or helper effects are hidden by default. These are effects which replace
functionality from KWin Core or provide interaction with other elements of the desktop shell.
</para>
<!--FIXME
39 effects + 7 internal (XRender compositor)
Internal effects
Appearance (Dashboard, Highlight Windows, KSreen, Screenshot, Window Geometry)
Window Management (Cover Switch)
-->
</article>