kwin/doc/kwineffects/index.docbook

87 lines
3.7 KiB
Text
Raw Permalink Normal View History

<?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>
2021-04-09 14:32:30 +00:00
<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>,
2021-04-09 14:32:30 +00:00
<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
2019-08-13 09:17:26 +00:00
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
2021-04-09 14:32:30 +00:00
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
2021-04-09 14:32:30 +00:00
<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>