Warning, /plasma/plasma-workspace/doc/kcontrol/colors/index.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" ?> 0002 0003 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" 0004 "dtd/kdedbx45.dtd" [ 0005 <!ENTITY % addindex "IGNORE"> 0006 <!ENTITY % English "INCLUDE" > <!-- change language only here --> 0007 ]> 0008 0009 <article id="colors" lang="&language;"> 0010 <articleinfo> 0011 <title>Colors</title> 0012 <authorgroup> 0013 <author>&Matthew.Woehlke; &Matthew.Woehlke.mail;</author> 0014 <author><firstname>Natalie</firstname><surname>Clarius</surname><email>natalie_clarius@yahoo.de</email></author> 0015 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0016 </authorgroup> 0017 0018 <date>2023-01-29</date> 0019 <releaseinfo>Plasma 5.27</releaseinfo> 0020 0021 <keywordset> 0022 <keyword>KDE</keyword> 0023 <keyword>KControl</keyword> 0024 <keyword>color</keyword> 0025 <keyword>kcm</keyword> 0026 <keyword>accent</keyword> 0027 </keywordset> 0028 </articleinfo> 0029 0030 <sect1 id="color"> 0031 <title>Colors</title> 0032 0033 <sect2 id="color-scheme"> 0034 <title>Scheme Management</title> 0035 0036 <para>This module lets you manage the color schemes on your machine. 0037 It shows a list of color schemes shipped with &plasma; and a preview at the top. 0038 Only one scheme is active at once, but you may edit schemes. 0039 You can remove schemes using the <guibutton>Remove Scheme</guibutton> button that 0040 is shown when you hover the mouse pointer over an item in the grid. 0041 Note that system schemes cannot be removed; the button for this action is 0042 disabled.</para> 0043 0044 <para>It is possible to filter the scheme list using the <guilabel>Search...</guilabel> 0045 field above the grid. Moreover, you can use the combo box next to this field to 0046 show only the <guimenuitem>Light Schemes</guimenuitem> or the <guimenuitem>Dark 0047 Schemes</guimenuitem>. 0048 </para> 0049 0050 <para>If you have an Internet connection, 0051 you can also browse and retrieve user-created schemes using <guibutton>Get 0052 New Color Schemes...</guibutton>.</para> 0053 0054 <para>You can also install schemes from a file that you have downloaded or otherwise 0055 obtained, as well as import &kde; 4 schemes named like "*.colors". 0056 </para> 0057 0058 <note> 0059 <para>This documentation will sometimes refer to the 0060 "current" scheme, or the "active" scheme. 0061 The "current" scheme is the set of colors and color scheme options 0062 that was most recently applied, &ie; what you would get if you choose 0063 <guibutton>Cancel</guibutton>. The "active" scheme is the set of 0064 colors as has been most recently edited by you, &ie; what you would get if 0065 you choose <guibutton>Apply</guibutton>.</para> 0066 </note> 0067 </sect2> 0068 0069 <sect2> 0070 <title>Accent Color</title> 0071 0072 <para>The accent color is the color in which focused or selected elements are highlighted, and is also used for some other interface elements such as sliders or folder icons. It is also possible to tint all colors with the accent color (see more on color scheme options below). With <guilabel>Use accent color</guilabel>, you have three options for choosing an accent color: 0073 </para> 0074 <itemizedlist> 0075 <listitem><para><guilabel>From current color scheme</guilabel>: 0076 This will leave the color of highlighted elements up to the color scheme, and not set a global accent color for all schemes. You can learn more about editing color schemes in the section below. 0077 </para></listitem> 0078 <listitem><para><guilabel>From current wallpaper</guilabel>: 0079 This will automatically extract a matching color from your desktop background image. 0080 </para></listitem> 0081 <listitem><para><guilabel>Custom</guilabel>: 0082 Here you can choose from a set of predefined colors or pick a custom color. 0083 </para></listitem> 0084 </itemizedlist> 0085 0086 </sect2> 0087 0088 <sect2> 0089 <title>Edit or Create Schemes</title> 0090 <para>To edit or create new schemes select a scheme from the list and press the 0091 <guibutton>Edit Scheme</guibutton> button to open a dialog with three tabs 0092 <guilabel>Options</guilabel>, <guilabel>Colors</guilabel>, and <guilabel>Disabled</guilabel>. 0093 When you have created a scheme you like, you can upload it, reset it or save it 0094 under a different name or overwrite the active scheme. 0095 </para> 0096 0097 <sect3 id="color-options"> 0098 <title>Color Scheme Options</title> 0099 0100 <para>The <guilabel>Options</guilabel> tab allows you to change some 0101 properties that deal with how the color scheme is used, as well as some 0102 options that change the color scheme that are different from actually 0103 assigning colors.</para> 0104 0105 <itemizedlist> 0106 <listitem><para><guilabel>Apply effects to inactive windows</guilabel> 0107 — If checked, state effects (see <link linkend="color-effects">below</link>) will be applied to inactive 0108 windows. This can help visually identify active versus inactive windows, 0109 and may have aesthetic value, depending on your taste. However, some 0110 users feel that it causes distracting "flickering" since 0111 windows must be repainted when they become inactive. Unlike desktop 0112 effects, color state effects do not require compositing support and will 0113 work on all systems, however they will only work on &kde; applications. 0114 </para></listitem> 0115 <listitem><para><guilabel>Use different colors for inactive selections</guilabel> 0116 — If checked, the current selection in elements which do not have 0117 input focus will be drawn using a different color. This can assist visual 0118 identification of the element with input focus in some applications, 0119 especially those which simultaneously display several lists. 0120 </para></listitem> 0121 <listitem><para><guilabel>Shade sorted column in lists</guilabel> 0122 — If checked, multi-column lists will use a slightly different 0123 color to paint the column whose information is being used to sort the 0124 items in the list. 0125 </para></listitem> 0126 <listitem><para><guilabel>Tint all colors with accent color</guilabel> 0127 — If checked, all colors will get some of the accent color blended in. You can control how strongly the accent color should blend in by moving the <guilabel>Tint strength</guilabel> slider. 0128 </para></listitem> 0129 <listitem><para><guilabel>Make window titlebars accent-colored</guilabel> 0130 — If checked, the color of the titlebar and header of windows will be tinted with the accent color. Active windows will be strongly highlighted in the accent color; inactive windows will get the accent color blended in more faintly. 0131 </para></listitem> 0132 <listitem><para><guilabel>Contrast</guilabel> 0133 — This slider controls the contrast of shaded elements, such as 0134 frame borders and the "3D" effects used by most styles. A lower 0135 value gives less contrast and therefore softer edges, while a higher 0136 value makes such edges "stand out" more. 0137 </para></listitem> 0138 </itemizedlist> 0139 0140 </sect3> 0141 0142 <sect3 id="color-colors"> 0143 <title>Colors</title> 0144 0145 <para>The <guilabel>Colors</guilabel> tab allows you to change the colors in 0146 the active color scheme.</para> 0147 0148 <para>Creating or changing a scheme is a simple matter of clicking on the 0149 swatch in the color list and selecting a new color. It is suggested 0150 that you save your scheme when you 0151 are done.</para> 0152 0153 <para>The <guilabel>Common Colors</guilabel> set, which is displayed 0154 initially, is not actually a "set" in the sense used by Plasma (see 0155 next section), but presents a number of color roles in a way that makes it 0156 easier to edit the scheme as a whole. When creating a new color scheme, you 0157 will usually change these colors first, and use the other sets to tweak 0158 specific colors if needed.</para> 0159 0160 <para>Note that <guilabel>Common Colors</guilabel> makes available roles from 0161 all sets. For example, "View Background" here is shorthand for the 0162 Normal Background role from the View set. Also, setting colors that do not 0163 refer to a specific set will change that color in <emphasis>all</emphasis> 0164 sets. (As an exception, "Inactive Text" will change the color for 0165 all sets <emphasis>except</emphasis> for Selection; there is a separate 0166 "Selection Inactive Text" for Inactive Text in the Selection set.) 0167 Some roles may not be visible under <guilabel>Common Colors</guilabel> at 0168 all, and can only be changed (if needed) by selecting the appropriate 0169 set.</para> 0170 0171 <sect4> 0172 <title>Color Sets</title> 0173 0174 <para>Plasma breaks the color scheme into several sets based on the type 0175 of user interface element, as follows:</para> 0176 <itemizedlist> 0177 <listitem><para><guilabel>View</guilabel> — 0178 information presentation elements, such as lists, trees, text input boxes, etc. 0179 </para></listitem> 0180 <listitem><para><guilabel>Window</guilabel> — 0181 window elements that are not buttons or views. 0182 </para></listitem> 0183 <listitem><para><guilabel>Button</guilabel> — 0184 buttons and similar elements. 0185 </para></listitem> 0186 <listitem><para><guilabel>Selection</guilabel> — 0187 selected text and items. 0188 </para></listitem> 0189 <listitem><para><guilabel>Tooltip</guilabel> — 0190 tool tips, "What's This" tips, and similar elements. 0191 </para></listitem> 0192 <listitem><para><guilabel>Complementary</guilabel> — 0193 Areas of applications with an alternative color scheme; usually with a dark background for light color schemes. Examples of areas with this inverted color scheme are the logout interface, the lock screen and the fullscreen mode for some applications. 0194 </para></listitem> 0195 </itemizedlist> 0196 0197 <para>Each set contains a number of color roles. 0198 Each set has the same roles. All colors are associated with 0199 one of the above sets.</para> 0200 </sect4> 0201 0202 <sect4> 0203 <title>Color Roles</title> 0204 0205 <para>Each color set is made up of a number of roles which are available in 0206 all other sets. In addition to the obvious Normal Text and Normal 0207 Background, these roles are as follows:</para> 0208 0209 <itemizedlist> 0210 <listitem><para>Alternate Background — 0211 used when there is a need to subtly change the background to aid in 0212 item association. This might be used ⪚ as the background of a 0213 heading, but is mostly used for alternating rows in lists, especially 0214 multi-column lists, to aid in visually tracking rows. 0215 </para></listitem> 0216 <listitem><para>Link Text — 0217 used for hyperlinks or to otherwise indicate "something which may 0218 be visited", or to show relationships. 0219 </para></listitem> 0220 <listitem><para>Visited Text — 0221 used for "something (⪚ a hyperlink) that has been 0222 visited", or to indicate something that is "old". 0223 </para></listitem> 0224 <listitem><para>Active Text — 0225 used to indicate an active element or attract attention, ⪚ alerts, 0226 notifications; also for hovered hyperlinks. 0227 </para></listitem> 0228 <listitem><para>Inactive Text — 0229 used for text which should be unobtrusive, ⪚ comments, 0230 "subtitles", unimportant information, etc. 0231 </para></listitem> 0232 <listitem><para>Negative Text — 0233 used for errors, failure notices, notifications that an action may be 0234 dangerous (⪚ unsafe web page or security context), etc. 0235 </para></listitem> 0236 <listitem><para>Neutral Text — 0237 used to draw attention when another role is not appropriate; ⪚ 0238 warnings, to indicate secure/encrypted content, etc. 0239 </para></listitem> 0240 <listitem><para>Positive Text — 0241 used for success notices, to indicate trusted content, etc. 0242 </para></listitem> 0243 </itemizedlist> 0244 0245 <para>As well as the text roles, there are a few additional 0246 "decoration" roles that are used for drawing lines or shading 0247 UI elements (while the above may, in appropriate circumstances, also be 0248 used for this purpose, the following are specifically 0249 <emphasis>not</emphasis> meant for drawing text). These are:</para> 0250 0251 <itemizedlist> 0252 <listitem><para>Focus Decoration — 0253 used to indicate the item which has active input focus. 0254 </para></listitem> 0255 <listitem><para>Hover Decoration — 0256 used for mouse-over effects, ⪚ the "illumination" effects for 0257 buttons. 0258 </para></listitem> 0259 </itemizedlist> 0260 0261 <para>In addition, except for Inactive Text, there is a corresponding 0262 background role for each of the text roles. Currently (except for Normal 0263 and Alternate Background), these colors are not chosen by the user, but are 0264 automatically determined based on Normal Background and the corresponding 0265 Text color. These colors may be previewed by selecting one of the sets 0266 other than "Common Colors".</para> 0267 0268 <para>The choice of color role is left to the developer; the above are 0269 guidelines intended to represent typical usage.</para> 0270 </sect4> 0271 0272 <sect4> 0273 <title>Window Manager Colors</title> 0274 0275 <para>As previously stated, the Window Manager set has its own roles, 0276 independent of those in other sets. These are (currently) only accessible 0277 via <guilabel>Common Colors</guilabel>, and are as follows:</para> 0278 0279 <itemizedlist> 0280 <listitem><para>Active Titlebar — 0281 used to draw the title bar background, borders, and/or decorations for 0282 the active window (that is, the one with input focus). Not all window 0283 decorations will use this in the same way, and some may even use the 0284 Normal Background from the Window set to draw the title bar. 0285 </para></listitem> 0286 <listitem><para>Active Titlebar Text — 0287 used to draw the title bar text when Active Titlebar is used to draw 0288 the title bar background. May also be used for other foreground 0289 elements which use Active Titlebar as the background. 0290 </para></listitem> 0291 </itemizedlist> 0292 0293 <para>The Inactive Titlebar [Text] roles are the same as the above, but for 0294 inactive windows, rather than active windows.</para> 0295 </sect4> 0296 0297 </sect3> 0298 0299 <sect3 id="color-effects"> 0300 <title>Disabled</title> 0301 0302 <para>Color state effects from this tab are applied to interface elements in the inactive 0303 (windows that do not have focus; only if <guilabel>Apply inactive window 0304 color effects</guilabel> is enabled) or disabled states. By changing the 0305 effects, the appearance of elements in these states can be changed. Usually, 0306 inactive elements will have reduced contrast (text fades slightly into the 0307 background) and may have slightly reduced intensity, while disabled elements 0308 will have strongly reduced contrast and are often notably darker or lighter. 0309 </para> 0310 0311 <para>Three types of effects may be applied to each state (with the effects 0312 of the two states being independent). These are Intensity, Color and 0313 Contrast. The first two (Intensity, Color) control the overall color, while 0314 the last (Contrast) deals with the foreground colors relative to the 0315 background.</para> 0316 0317 <sect4> 0318 <title>Intensity</title> 0319 0320 <para>Intensity allows the overall color to be lightened or darkened. 0321 Setting the slider to the middle produces no change. The available effects 0322 are:</para> 0323 0324 <itemizedlist> 0325 <listitem><para>Shade — 0326 makes everything lighter or darker in a controlled manner. Each 0327 "tick" on the slider increases or decreases the overall 0328 intensity (&ie; perceived brightness) by an absolute amount. 0329 </para></listitem> 0330 <listitem><para>Darken — 0331 changes the intensity to a percentage of the initial value. A slider 0332 setting halfway between middle and maximum results in a color half as 0333 intense as the original. The minimum gives a color twice as intense as 0334 the original. 0335 </para></listitem> 0336 <listitem><para>Lighten — 0337 conceptually the opposite of darken; lighten can be thought of as 0338 working with "distance from white", where darken works with 0339 "distance from black". The minimum is a color twice as 0340 "far" from white as the original, while halfway between 0341 middle and maximum gives an intensity halfway between the original 0342 color and white. 0343 </para></listitem> 0344 </itemizedlist> 0345 </sect4> 0346 0347 <sect4> 0348 <title>Color</title> 0349 0350 <para>Color also changes the overall color, but is not limited to 0351 intensity. The available effects are:</para> 0352 0353 <itemizedlist> 0354 <listitem><para>Desaturate — 0355 changes the relative chroma. The middle setting produces no change; 0356 maximum gives a gray whose perceptual intensity equals that of the 0357 original color. Lower settings increase the chroma, giving a color that 0358 is less gray / more "vibrant" than the original. 0359 </para></listitem> 0360 <listitem><para>Fade — 0361 smoothly blends the original color into a reference color. The minimum 0362 setting on the slider produces no change; the maximum gives the reference 0363 color. 0364 </para></listitem> 0365 <listitem><para>Tint — 0366 similar to Fade, except that the color (hue and chroma) changes more 0367 quickly while the intensity changes more slowly as the slider value is 0368 increased. 0369 </para></listitem> 0370 </itemizedlist> 0371 </sect4> 0372 0373 <sect4> 0374 <title>Contrast</title> 0375 0376 <para>The contrast effects are similar to the color effects, except they 0377 apply to the text, using the background color as the reference color, and 0378 desaturate is not available. Fade produces text that "fades out" 0379 more quickly, but keeps its color longer, while Tint produces text that 0380 changes color to match the background more quickly while keeping a greater 0381 intensity contrast for longer (where "longer" means higher 0382 settings on the slider). For Contrast effects, the minimum setting on the 0383 slider produces no change, while maximum causes the text to completely 0384 disappear into the background.</para> 0385 </sect4> 0386 0387 </sect3> 0388 0389 </sect2> 0390 0391 </sect1> 0392 0393 </article> 0394 <!-- kate: indent-width 2; replace-tabs on; -->