****** Περίληψη ****** Το deKorator είναι μια μηχανή kwin η οποία χρησιμοποιεί πολλές καθορισμένες από το χρήστη εικόνες και τις παρουσιάζει ως διακόσμηση παραθύρου, Το deKorator αναζητεί τις εικόνες μέσα σε ένα θέμα. Ακολουθεί ένας οδηγός για την κατασκευή ενός θέματος. ****** Μέσα στο πακέτο ****** Το deKorator περιλαμβάνει: * default- theme - Χρησιμοποιείται προκαθορισμένα, ενώ παρουσιάζει κάποια από τα χαρακτηριστικά του deKorator. * ugly- theme - Στόχος του θέματος είναι η κατανόηση της μεθόδου σχεδίασης των διακοσμήσεων από το deKorator. * template- theme - αυτό το θέμα έχει χρήση προτύπου για άλλα θέματα, ενώ περιέχει όλα τα δυνατά κουμπιά. * Bushido- Yellow- theme - επίδειξη της χρήσης μάσκας. ****** Ονόματα ****** Το deKorator αναζητεί την ίδια δομή καταλόγου και ονόματα αρχείων με το default- theme. Κάθε αρχείο θέματος θα πρέπει να τελειώνει με "- theme" (όπως το "default - theme") και θα πρέπει να περιέχει όλους τους φακέλους του default- theme (deco, buttons, masks). ****** Μεγέθη ****** Ο καθορισμός μεγέθους των 4 περιγραμμάτων από το deKorator γίνεται από: _BAR_Ιδιότητα\ t\ t\ t_BAR_Πηγή\ t\ t\ t\ t_BAR_ ------------------------------------------------------------------------------------------------ _BAR_το πλάτος αριστερού περιγράμματος\ t\ t_BAR_πλάτος midLeftFrameBg\ t\ t_BAR_ _BAR_το πλάτος δεξιού περιγράμματος\ t\ t_BAR_πλάτος midRightFrameBg\ t_BAR_ _BAR_το ύψος της πάνω γραμμής\ t\ t_BAR_ύψος midTitleBg\ t\ t_BAR_ το ύψος του κάτω περιγράμματος\ t_BAR_ύψος midBottomFrameBg\ t_BAR_ Όλα τα τμήματα που δημιουργούν ένα συγγεκριμένο όριο θα πρέπει να έχουν ίδιο πλάτος ή ύψος αντίστοιχα. Ακολουθεί ένα παράδειγμα μιας διακόσμησης με 10εικ ύψος στην πάνω γραμμή, 20εικ στο αριστερό όριο, 30εικ στο δεξί και 40εικ στο κάτω περίγραμμα. Όλες οι παραθέσεις της πάνω γραμμής θα πρέπει να έχουν ύψος 10εικ: * topLeftCornerBg * leftButtonsBg * leftTitleBg * midTitleBg * rightTitleBg * rightButtonsBg * topRightCornerBg Όλες οι παραθέσεις του αριστερού ορίου θα πρέπει να έχουν πλάτος 20εικ: * topLeftFrameBg * midLeftFrameBg * bottomLeftFrameBg Όλες οι παραθέσεις του δεξιού ορίου θα πρέπει να έχουν πλάτος 30εικ: * topRightFrameBg * midRightFrameBg * bottomRightFrameBg Οι παραθέσεις του κάτω περιγράμματος θα πρέπει να είναι ύψους 40εικ: * leftBottomFrameBg * midBottomFrameBg * rightBottomFrameBg Οι γωνιακές παραθέσεις θα πρέπει να ταιριάζουν τον κάνναβο παραθέσεων: Παράθεση Ύψος Πλάτος topLeftCornerBg 10 20 topRightCornerBg 10 30 leftBottomFrameBg 40 20 rightBottomFrameBg 40 30 ****** Κουμπιά ****** Οι εικόνες των κουμπιών διαχωρίζονται σε φόντο και προσκήνιο. ***** Φόντο ***** Το φόντο κουμπιών χρησιμοποιεί τις παραθέσεις leftButtonsBg και rightButtonsBg. Το ύψος τους θα πρέπει να είναι όμοιο με την πάνω γραμμή. Το φόντο επαναλαμβάνεται οριζόντια για την συμπλήρωση των κουμπιών. ***** Προσκήνιο ***** Το πλάτος καθορίζεται από το πλάτος των κουμπιών. Με αυτήν τη μέθοδο η δημιουργοί μπορούν να τοποθετήσουν τα κουμπιά όσο κοντά επιθυμούν. Για τη δημιουργία κενού μεταξύ των κουμπιών μπορείτε να προσθέσετε διαφανή εικονοστοιχεία στα δεξιά και αριστερά. Ένα κουμπί με μικρότερο ύψος από την πάνω γραμμή κετράρεται κατακόρυφα. Για την τοποθέτηση του κουμπιού σε ένα προσαρμοσμένο ύψος χρησιμοποιήστε επίσης διαφανή εικονοστοιχεία. ****** Μάσκες ****** Οι μάσκες περιέχουν μόνο μαύρο και λευκό. Τα μαύρα εικονοστοιχεία αφαιρούνται από τη διακόσμηση. ****** Μορφή εικόνας ****** Όλες οι εικόνες θα πρέπει να είναι PNG. ****** Υποδείξεις και συμβουλές ****** Πάντα να ξεκινάτε την κατασκευή του θέματός σας από το template- theme.
****** 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.