Warning, /plasma/plasma-workspace/doc/kcontrol/cursortheme/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY % addindex "IGNORE">
0005 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0006 ]>
0007 
0008 <article id="cursortheme" lang="&language;">
0009 <articleinfo>
0010 <title>Cursor Theme</title>
0011 <authorgroup>
0012 <author>&Mike.McBride; &Mike.McBride.mail;</author>
0013 <author>&Brad.Hards; &Brad.Hards.mail;</author>
0014 <author>&Lauri.Watts; &Lauri.Watts.mail;</author>
0015 <author><firstname>Natalie</firstname><surname>Clarius</surname><email>natalie_clarius@yahoo.de</email></author>
0016 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0017 </authorgroup>
0018 
0019 <date>2023-01-29</date>
0020 <releaseinfo>Plasma 5.27</releaseinfo>
0021 
0022 <abstract>
0023 <para>This is the documentation for the &systemsettings; module to 
0024 customize the mouse cursor appearance.
0025 </para>
0026 </abstract>
0027 
0028 <keywordset>
0029 <keyword>KDE</keyword>
0030 <keyword>Systemsettings</keyword>
0031 <keyword>mouse</keyword>
0032 <keyword>cursor</keyword>
0033 <keyword>pointer</keyword>
0034 <keyword>bouncing</keyword>
0035 <keyword>blinking</keyword>
0036 <keyword>animation</keyword>
0037 <keyword>launch</keyword>
0038 <keyword>feedback</keyword>
0039 <keyword>theme</keyword>
0040 </keywordset>
0041 </articleinfo>
0042 
0043 <sect1 id="cursorthemes">
0044 <title>Cursor Theme</title>
0045 
0046 <para>
0047 This module allows you to
0048 <itemizedlist>
0049 <listitem><para>select a cursor theme</para></listitem>
0050 <listitem><para>configure a cursor animation for launching applications</para></listitem>
0051 </itemizedlist>
0052 </para>
0053 
0054 <para>The features provided by this module may not be available on some systems.</para>
0055 
0056 <sect2 id="cursorthememanagement">
0057 <title>Cursor Theme Management</title>
0058 
0059 <screenshot>
0060 <screeninfo>Screenshot of the Cursor Theme manager</screeninfo>
0061 <mediaobject>
0062 <imageobject>
0063 <imagedata fileref="main.png" format="PNG" />
0064 </imageobject>
0065 </mediaobject>
0066 </screenshot>
0067 
0068 <para>To use a cursor theme, simply select it and click the <guilabel>Apply</guilabel> button.</para>
0069 
0070 <para>You can remove cursor themes using the trash button that appears when you hover the mouse pointer over the theme item in the list. Note that you can not remove the pre-installed themes.</para>
0071 
0072 <para>Use the <guilabel>Get New Cursors...</guilabel> button to launch the <guilabel>Download New Cursors</guilabel> dialog and download additional themes from the internet.</para>
0073 
0074 <screenshot>
0075 <screeninfo>Screenshot of the Get New Cursor Themes</screeninfo>
0076 <mediaobject>
0077 <imageobject>
0078 <imagedata fileref="get-new-stuff.png" format="PNG" />
0079 </imageobject>
0080 </mediaobject>
0081 </screenshot>
0082 
0083 <para>You can also install cursor themes files you have downloaded or otherwise obtained using the <guilabel>Install from File...</guilabel> button.</para>
0084 
0085 <para>If you are interested in creating your own cursor theme, you can find information <ulink url="https://userbase.kde.org/Special:MyLanguage/Create_your_own_mouse_cursor_theme">here</ulink>.</para>
0086 
0087 </sect2>
0088 
0089 <sect2 id="cursorsize">
0090 <title>Cursor size</title>
0091 
0092 <para>Some themes allow choosing the cursor size. Use the <guilabel>Size</guilabel> field to select the appropriate size.</para>
0093 
0094 <screenshot>
0095 <screeninfo>Screenshot of the Cursor Size</screeninfo>
0096 <mediaobject>
0097 <imageobject>
0098 <imagedata fileref="cursor-size.png" format="PNG" />
0099 </imageobject>
0100 </mediaobject>
0101 </screenshot>
0102 
0103 </sect2>
0104 
0105 <sect2 id="lauchfeedback">
0106 <title>Launch feedback</title>
0107 
0108 <para>Sometimes it is reassuring to know that your computer didn't just
0109 ignore your command, and something is happening behind the scenes. In
0110 this dialog <guilabel>Configure Launch Feedback...</guilabel>, 
0111 you can configure visible feedback to help you know if you
0112 really hit that icon or not.</para>
0113 
0114 <screenshot>
0115 <screeninfo>Screenshot of the Launch Feedback</screeninfo>
0116 <mediaobject>
0117 <imageobject>
0118 <imagedata fileref="launch-feedback.png" format="PNG" />
0119 </imageobject>
0120 </mediaobject>
0121 </screenshot>
0122         
0123 <para>The traditional way to indicate that your computer is busy is to
0124 modify the cursor, and you can turn this on by choosing a
0125 <guilabel>Cursor</guilabel>.</para>
0126 
0127 <para>With this option enabled, your cursor will have an icon attached
0128 to it for a short time, when a new application is being launched.  You
0129 can configure how long this icon is displayed beside your cursor with the
0130 <guilabel>Stop animation after:</guilabel> spinbox.  The
0131 default is 5 seconds.</para>
0132 
0133 <para>There are several variations of busy cursor available, including
0134 a <guilabel>No Feedback</guilabel>, a <guilabel>Blinking</guilabel>, a 
0135 <guilabel>Bouncing</guilabel> or a <guilabel>Static</guilabel> cursor 
0136 icon with no animation.</para>
0137 
0138 <para>Traditional &plasma; launch notification has taken another form,
0139 which you can also enable and disable here.  Normally when you start an
0140 application, it gets an immediate entry in the taskbar, with the icon
0141 replaced by a spinning hourglass to let you know something is
0142 happening.  You can toggle this behavior on and off with the
0143 <guilabel>Enable animation</guilabel> checkbox.</para>
0144 
0145 <para>Not all applications that you start will eventually show a window, or 
0146 an entry in the taskbar.  Some of them, for example, are docked into the 
0147 &plasma; system tray. Alternatively, it might be that you sent it off to a 
0148 different virtual desktop, and in the <guilabel>Behavior</guilabel> section 
0149 of the <ulink url="help:/plasma-desktop/panel.html"> <guilabel>Task Manager 
0150 Settings</guilabel></ulink> the option <guilabel>From the current 
0151 desktop</guilabel> is checked for the <guilabel>Show only tasks</guilabel> 
0152 switcher.  Setting a timeout ensures that, even in these cases, you can 
0153 still get launch feedback, but also that it will go away when the job is 
0154 done.</para>
0155 
0156 </sect2>
0157 
0158 </sect1>
0159 
0160 </article>