****** 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.
****** Resumo ****** deKorator é un motor de kwin que toma varias imaxes definidas polo usuario e as presenta como unha decoración de fiestra. deKorator agarda achalas nun tema. Esta é unha gúia para facer un destes temas. ****** No paquete ****** deKorator ven con: * default- theme - Empregado por omisión, serve de exemplo de algunha das funcionalidades de deKorator. * ugly- theme - O seu propósito é comprender o xeito que ten deKorator para pintar as decoracións. * template- theme - este tema serve de modelo dos outros modelos, este tema ten todos os botóns posíbeis. * Bushido- Yellow- theme - mostra como facer máscaras. ****** Nomes ****** deKorator agarde ter a mesma estrutura en directorios e nomes de ficheiros que os que hai no default- theme. Todo ficheiro de tema debe rematar en « - theme » (como en « default - theme »), e debe conter todos os directorios que hai no default- theme (deco, buttons, masks). ****** Tamaños ****** deKorator determina os tamaños dos 4 bordes en: _BAR_Propriedade\ t\ t\ t_BAR_Fonte\ t\ t\ t\ t_BAR_ ------------------------------------------------------------------------------------------------ _BAR_ancho do borde esquerdo\ t\ t_BAR_midLeftFrameBg ancho\ t\ t_BAR_ _BAR_ancho do borde dereito\ t\ t_BAR_midRightFrameBg ancho\ t_BAR_ _BAR_ancho da barra superior\ t\ t_BAR_midTitleBg alto\ t\ t_BAR_ _BAR_ancho da barra inferior\ t_BAR_midBottomFrameBg alto\ t_BAR_ Todas as partes que compoñen un borde específico deben ter o mesmo ancho ou alto. A seguir vai un exemplo para unha decoración de fiestra cunha barra superior de 10px de alto, un borde esquerdo de 20px, un dereito de 30px e un inferior de 40px de alto. Todas as pezas da barra superior deben ter 10 píxeles de alto: * topLeftCornerBg * leftButtonsBg * leftTitleBg * midTitleBg * rightTitleBg * rightButtonsBg * topRightCornerBg Todas as pezas no borde esquerdo deben ter 20 píxeles de ancho: * topLeftFrameBg * midLeftFrameBg * bottomLeftFrameBg Todas as pezas do borde dereito deben ter 30 píxeles de ancho: * topRightFrameBg * midRightFrameBg * bottomRightFrameBg Todas as pezas do borde inferior deber ter 40 píxeles de alto: * leftBottomFrameBg * midBottomFrameBg * rightBottomFrameBg As pezas das esquinas deben axustarse á grella de pezas: Peza Alto Ancho topLeftCornerBg 10 20 topRightCornerBg 10 30 leftBottomFrameBg 40 20 rightBottomFrameBg 40 30 ****** Botóns ****** As imaxes dos botóns son separadas nas de fondo e de primeiro plano. ***** Fondo ***** O ondo dos botón empregan as pezas leftButtonsBg e rightButtonsBg. A altura destas debe ser a mesma que a da barra superior. O fondo é repetido en horizontal para preencher os botóns. ***** Primeiro plano ***** O ancho é determinado polo do botón. Deste xeito as marcas do tema poden por os botóns tan arrimados como queiran. Para facer espazo entre os botóns pode engadir píxeles transparentes á dereita e á esquerda. Se o botón é menos alto que a barra superior será centrado en vertical. Se o quer pór a unha altura personalizada, empregue píxeles transparentes. ****** Mascaras ****** As máscaras só conteñen branco e negro. Os píxeles en negro son retirados da decoración. ****** Formatos das imaxes ****** Todas as imaxes deben estar no formato PNG. ****** Consellos e truques ****** Comece sempre os seus temas a partir do template- theme.