****** Summary ****** deKorator is a kwin engine that takes several user-defined images and presents them as a window decoration. deKorator expects to find those in a theme. Here is a guide for building such a theme. ****** In the package ****** deKorator comes with: * default-theme - Used by default, illustrates some of deKorator's features. * ugly-theme - Its purpose is to understand the way deKorator paints the decorations. * template-theme - this theme is meant to be a template theme for other themes, this theme features all possible buttons. * Bushido-Yellow-theme - shows how masking can be done. ****** Names ****** deKorator expects the same directory structure and file names as the ones in default-theme. Every theme file should end with "-theme" (as in "default- theme"), and should contain all the folders that are in default-theme (deco, buttons, masks). ****** Sizes ****** deKorator determines the 4 borders' sizes from: _BAR_Property \t\t\t_BAR_Source\t\t\t\t_BAR_ ------------------------------------------------------------------------------------------------ _BAR_the left border width \t\t_BAR_midLeftFrameBg's width\t\t_BAR_ _BAR_the right border width \t\t_BAR_midRightFrameBg's width\t_BAR_ _BAR_the top bar height \t\t_BAR_midTitleBg's height \t\t_BAR_ _BAR_the bottom border height\t_BAR_midBottomFrameBg's height\t_BAR_ All parts that build up a specific border should have the same width or height, as appropriate. An example follows for a window decoration with a 10px high top bar, a 20px wide left border, a 30px wide right border and a 40px high bottom border. All tiles in the top bar should be 10 pixels high: * topLeftCornerBg * leftButtonsBg * leftTitleBg * midTitleBg * rightTitleBg * rightButtonsBg * topRightCornerBg All tiles in the left border should be 20 pixels wide: * topLeftFrameBg * midLeftFrameBg * bottomLeftFrameBg All tiles in the right border should be 30 pixels wide: * topRightFrameBg * midRightFrameBg * bottomRightFrameBg All tiles in the bottom border should be 40 pixels high: * leftBottomFrameBg * midBottomFrameBg * rightBottomFrameBg The corner tiles should fit into the tile grid: Tile Height Width topLeftCornerBg 10 20 topRightCornerBg 10 30 leftBottomFrameBg 40 20 rightBottomFrameBg 40 30 ****** Buttons ****** The button images are separated into background and foreground ones. ***** Background ***** The button background uses the leftButtonsBg and the rightButtonsBg tiles. Their height should be the same as the top bar's. The background is repeated horizontally to fit the buttons in. ***** Foreground ***** The width is determined by the button width. This way theme makers can put the buttons as close as they wish. To make space between buttons you can add transparent pixels to the right and left. A button with a smaller height than the top bar's gets centered vertically. To place the button in a custom height use transparent pixels, too. ****** Masks ****** Masks contain only black and white. Black pixels are subtracted from the decoration. ****** Image format ****** All images should be in PNG format. ****** Tips and Tricks ****** Always start up building your theme from the template-theme.
****** Sammanfattnig ****** Dekorator är ett bakgrundsprogram för Kwin som tar flera användardefinierade bilder och presenterar dem som fönsterdekorationer. Dekorator förväntar sig att hitta dem i ett tema. Här är en guide för att skapa ett sådant tema. ****** I paketet ****** Dekorator levereras med: * default- theme - Används som förval, illustrerar några av funktionerna i Dekorator. * ugly- theme - Dess syfte är att förstå sättet som Dekorator ritar upp dekorationerna. * template- theme - Temat är avsett som ett malltema för andra teman. Temat omfattar alla knappar som är möjliga. * Bushido- Yellow- theme - visar hur maskning kan göras. ****** Namn ****** Dekorator förväntar sig samma katalogstruktur och filnamn som de i default- theme. Varje temafil måste sluta med "- theme" (som i "default - theme"), och måste innehålla alla kataloger som finns i default- theme (deco, buttons, masks). ****** Storlekar ****** Dekorator bestämmer de fyra kanternas storlekar från: _BAR_Egenskap\ t\ t\ t_BAR_Källa\ t\ t\ t\ t_BAR_ ------------------------------------------------------------------------------------------------ _BAR_vänsterkantens bredd\ t\ t_BAR_bredden av midLeftFrameBg\ t\ t_BAR_ _BAR_högerkantens bredd\ t\ t_BAR_bredden av midRightFrameBg\ t_BAR_ _BAR_överkantens höjd\ t\ t_BAR_höjden av midTitleBg\ t\ t_BAR_ _BAR_nederkantens höjd\ t_BAR_höjden av midBottomFrameBg\ t_BAR_ Alla delar som bygger upp en specifik kant måste ha samma bredd eller höjd på motsvarande sätt. Ett exempel följer för en fönsterdekoration med en 10 bildpunkter hög namnlist, en 20 bildpunkter bred vänsterkant, en 30 bildpunkter bred högerkant och en 40 bildpunkter hög nederkant. Alla rutor i överkantens rad ska vara 10 bildpunkter höga: * topLeftCornerBg * leftButtonsBg * leftTitleBg * midTitleBg * rightTitleBg * rightButtonsBg * topRightCornerBg Alla rutor i vänsterkanten ska vara 20 bildpunkter breda: * topLeftFrameBg * midLeftFrameBg * bottomLeftFrameBg Alla rutor i högerkanten ska vara 30 bildpunkter breda: * topRightFrameBg * midRightFrameBg * bottomRightFrameBg Alla rutor i nederkanten ska vara 40 bildpunkter höga: * leftBottomFrameBg * midBottomFrameBg * rightBottomFrameBg Hörnrutorna ska passa in i rutnätet: Ruta Höjd Bredd topLeftCornerBg 10 20 topRightCornerBg 10 30 leftBottomFrameBg 40 20 rightBottomFrameBg 40 30 ****** Knappar ****** Knappbilderna är uppdelade i bakgrundsbilder och förgrundsbilder. ***** Bakgrund ***** Knapparnas bakgrund använder rutorna leftButtonsBg och rightButtonsBg. Deras höjd ska vara samma som överkantens rad. Bakgrunden upprepas horisontellt för att fylla i knapparna. ***** Förgrund ***** Bredden bestäms av knappbredden. På så sätt kan alla som skapar teman placera knapparna så nära varandra de vill. För att skapa mellanrum mellan knapparna kan du lägga till genomskinliga bildpunkter till höger och vänster. En knapp med en mindre höjd än överkanten centreras vertikalt. Använd också genomskinliga bildpunkter för att placera knappen på en egen plats. ****** Masker ****** Masker innehåller bara svart och vitt. Svarta bildpunkter subtraheras från dekorationen. ****** Bildformat ****** Alla bilder ska vara i PNG. ****** Tips och trick ****** Börja alltid med att skapa ditt tema från malltemat.