← Back to branch summary

~ubuntu-branches/ubuntu/utopic/kdebase/utopic

« back to all changes in this revision

Viewing changes to apps/konsole/data/color-schemes/historic/README.Schema

  • Committer: Bazaar Package Importer
  • Author(s): Debian Qt/KDE Maintainers, José Manuel Santamaría Lema, Modestas Vainius
  • Date: 2011-05-26 02:53:50 UTC
  • mfrom: (0.7.7 upstream) (0.4.5 experimental)
  • mto: This revision was merged to the branch mainline in revision 296.
  • Revision ID: james.westby@ubuntu.com-20110526025350-7o10g65yegec2rnq
Tags: 4:4.6.3-1
* New upstream release.

[ José Manuel Santamaría Lema ]
* Bump kde-sc-dev-latest build dependency to 4:4.6.3.
* Bump Standards-Version to 3.9.2; no changes needed.

[ Modestas Vainius ]
* Enable DLRestrictions for libraries in this package. Requires
  libdlrestrictions-dev 0.14 and kdelibs5-dev 4:4.6.3.

Show diffs side-by-side

added added

removed removed

Lines of Context:
apps/konsole/data/color-schemes/historic/README.Schema
1
 
[README.Schema]
2
 
 
3
 
The schemata offered in the Options/Schema menu are
4
 
taken from from configurations files with a *.schema
5
 
pattern either located in $KDEDIR/share/apps/konsole
6
 
or ~/.kde/share/apps/konsole.
7
 
 
8
 
Schemata allow to configure the color set that konsole
9
 
uses, together with some more information on rendition
10
 
processing.
11
 
 
12
 
Syntax
13
 
 
14
 
  File
15
 
  :: { [Line] ['#' Comment] '\n' }
16
 
 
17
 
  Line
18
 
  :: "title" Title
19
 
  :: "image" Usage PathToPictureFile
20
 
  :: "transparency" Fade Red Green Blue
21
 
  :: "color" Slot Red Green Blue Transparent Bold
22
 
  :: "rcolor" Slot Saturation Value Transparent Bold
23
 
  :: "sysfg" Slot Transparent Bold
24
 
  :: "sysbg" Slot Transparent Bold
25
 
 
26
 
Meaning
27
 
 
28
 
  - Title is the text to appear in the Option/Schema menu.
29
 
    It should be unique among all other schemata therefore.
30
 
 
31
 
  - The "image" clause allows to place an image on the
32
 
    konsole's background.
33
 
 
34
 
    - Usage can be either
35
 
      - "tile"   - the image is tilewise replicated.
36
 
      - "center" - the image is centered.
37
 
      - "full"   - the image is stretched to fit the window size.
38
 
      
39
 
    - The Path of the picture can both be relative
40
 
      (to kde wallpapers) or absolute.
41
 
      
42
 
    When a schema uses a background image (or transparency)
43
 
    one has to make at least one color slot transparent to
44
 
    achive any visible effect. Please read below about the
45
 
    "Transparent" field in color,sysbg,sysfg.
46
 
 
47
 
  - The "transparency" clause picks and uses the background
48
 
    of the desktop as if it where an image together with
49
 
    a fade effect. This effect will fade the background
50
 
    to the specified color.
51
 
 
52
 
    The "Fade" is a real value between 0 and 1, indicating
53
 
    the strength of the fade. A value of 0 will not change
54
 
    the image, a value of 1 will make it the fade color
55
 
    everywhere, and in between. This will make the "glas"
56
 
    of the window be of the color given in the clause and
57
 
    being more(1) or less(0) intransparent.
58
 
 
59
 
  - The remaining clauses (color,sysbg,sysfg) are used
60
 
    to setup konsoles rendition system.
61
 
 
62
 
    To this end, konsole offers 20 color slots.
63
 
 
64
 
     Slot  Meaning
65
 
    -----  --------------------------
66
 
        0  regular   foreground color
67
 
        1  regular   background color
68
 
      2-9  regular   bgr color 0-7
69
 
       10  intensive foreground color
70
 
       11  intensive background color
71
 
    12-19  intensive bgr color 0-7
72
 
 
73
 
    The traditional meaning of the "bgr" color codes
74
 
    has a bitwise interpretation of an additive three
75
 
    primary color scheme inherited from early EGA
76
 
    color terminals.
77
 
 
78
 
    Color  Bits  Colors
79
 
    -----  ----  -------
80
 
        0   000  Black
81
 
        1   001  Red
82
 
        2   010  Green
83
 
        3   011  Yellow
84
 
        4   100  Blue
85
 
        5   101  Magenta
86
 
        6   110  Cyan
87
 
        7   111  White
88
 
 
89
 
    One may or may not stick to this tradition.
90
 
    Konsole allows to assign colors freely to slots.
91
 
 
92
 
    The slots fall apart into two groups, regular
93
 
    and intensive colors. The later are used when
94
 
    BOLD rendition is used by the client.
95
 
 
96
 
    Each of the groups have a default fore- and
97
 
    background color and the said bgr colors.
98
 
    Normal terminal processing will simply use
99
 
    the default colors.
100
 
 
101
 
    The color desired for a slot is indicated
102
 
    in the Red Green Blue fields of the color
103
 
    clause. Use the sysfg or the sysbg clause
104
 
    to indicate the default fore and background
105
 
    colors of the desktop.
106
 
 
107
 
    To specify randomized color for a slot use
108
 
    the clause rcolor. The two parameters to it 
109
 
    being Saturation - the amount of colour, 
110
 
    and Value, the darkness of the colour.
111
 
 
112
 
    To use transparency/images and to simulate
113
 
    the behavior of the xterm, one can supply
114
 
    two additional tags to each slot:
115
 
    - Transparent (0/1) meaning to show the
116
 
      background picture, if any.
117
 
    - Bold (0/1) to render characters bold.
118
 
 
119
 
 
120
 
If you know about the escape codes, you might have
121
 
noticed that intensive and bold rendition are sort
122
 
of confused. This is inherited by the xterm which
123
 
konsole is simulating.
124
 
 
125
 
One can use the colortest.sh script supplied
126
 
with the konsole source distribution to test
127
 
a schema.
128
 
 
129
 
The schema installed with konsole are more or
130
 
less demonstrations and not really beauty,
131
 
beside the Linux.schema, perhaps, which is
132
 
made after the VGA colors.