color-schemes/historic/README.Schema

0001 [README.Schema]
0002
0003 The schemata offered in the Options/Schema menu are
0004 taken from from configurations files with a *.schema
0005 pattern either located in $KDEDIR/share/apps/konsole
0006 or ~/.kde/share/apps/konsole.
0007
0008 Schemata allow to configure the color set that konsole
0009 uses, together with some more information on rendition
0010 processing.
0011
0012 Syntax
0013
0014   File
0015   :: { [Line] ['#' Comment] '\n' }
0016
0017   Line
0018   :: "title" Title
0019   :: "image" Usage PathToPictureFile
0020   :: "transparency" Fade Red Green Blue
0021   :: "color" Slot Red Green Blue Transparent Bold
0022   :: "rcolor" Slot Saturation Value Transparent Bold
0023   :: "sysfg" Slot Transparent Bold
0024   :: "sysbg" Slot Transparent Bold
0025
0026 Meaning
0027
0028   - Title is the text to appear in the Option/Schema menu.
0029     It should be unique among all other schemata therefore.
0030
0031   - The "image" clause allows to place an image on the
0032     konsole's background.
0033
0034     - Usage can be either
0035       - "tile"   - the image is tilewise replicated.
0036       - "center" - the image is centered.
0037       - "full"   - the image is stretched to fit the window size.
0038
0039     - The Path of the picture can both be relative
0040       (to kde wallpapers) or absolute.
0041
0042     When a schema uses a background image (or transparency)
0043     one has to make at least one color slot transparent to
0044     achive any visible effect. Please read below about the
0045     "Transparent" field in color,sysbg,sysfg.
0046
0047   - The "transparency" clause picks and uses the background
0048     of the desktop as if it where an image together with
0049     a fade effect. This effect will fade the background
0050     to the specified color.
0051
0052     The "Fade" is a real value between 0 and 1, indicating
0053     the strength of the fade. A value of 0 will not change
0054     the image, a value of 1 will make it the fade color
0055     everywhere, and in between. This will make the "glas"
0056     of the window be of the color given in the clause and
0057     being more(1) or less(0) intransparent.
0058
0059   - The remaining clauses (color,sysbg,sysfg) are used
0060     to setup konsoles rendition system.
0061
0062     To this end, konsole offers 20 color slots.
0063
0064      Slot  Meaning
0065     -----  --------------------------
0066         0  regular   foreground color
0067         1  regular   background color
0068       2-9  regular   bgr color 0-7
0069        10  intensive foreground color
0070        11  intensive background color
0071     12-19  intensive bgr color 0-7
0072
0073     The traditional meaning of the "bgr" color codes
0074     has a bitwise interpretation of an additive three
0075     primary color scheme inherited from early EGA
0076     color terminals.
0077
0078     Color  Bits  Colors
0079     -----  ----  -------
0080         0   000  Black
0081         1   001  Red
0082         2   010  Green
0083         3   011  Yellow
0084         4   100  Blue
0085         5   101  Magenta
0086         6   110  Cyan
0087         7   111  White
0088
0089     One may or may not stick to this tradition.
0090     Konsole allows to assign colors freely to slots.
0091
0092     The slots fall apart into two groups, regular
0093     and intensive colors. The later are used when
0094     BOLD rendition is used by the client.
0095
0096     Each of the groups have a default fore- and
0097     background color and the said bgr colors.
0098     Normal terminal processing will simply use
0099     the default colors.
0100
0101     The color desired for a slot is indicated
0102     in the Red Green Blue fields of the color
0103     clause. Use the sysfg or the sysbg clause
0104     to indicate the default fore and background
0105     colors of the desktop.
0106
0107     To specify randomized color for a slot use
0108     the clause rcolor. The two parameters to it
0109     being Saturation - the amount of colour,
0110     and Value, the darkness of the colour.
0111
0112     To use transparency/images and to simulate
0113     the behavior of the xterm, one can supply
0114     two additional tags to each slot:
0115     - Transparent (0/1) meaning to show the
0116       background picture, if any.
0117     - Bold (0/1) to render characters bold.
0118
0119
0120 If you know about the escape codes, you might have
0121 noticed that intensive and bold rendition are sort
0122 of confused. This is inherited by the xterm which
0123 konsole is simulating.
0124
0125 One can use the colortest.sh script supplied
0126 with the konsole source distribution to test
0127 a schema.
0128
0129 The schema installed with konsole are more or
0130 less demonstrations and not really beauty,
0131 beside the Linux.schema, perhaps, which is
0132 made after the VGA colors.