doc/SKINS

   1 enigma2 skins
   2 =============
   3
   4 A skin file is an XML file. Better read the existing skin file as an
   5 example.
   6
   7 colors
   8 ======
   9
  10 you can define alias names for different colors. the "value" is given as
  11 #aarrggbb, or just #rrggbb.
  12
  13 windowstyle
  14 ===========
  15 here you can configure the "window style", i.e. the bord around windows.
  16
  17 screens
  18 =======
  19
  20 these are the different widgets for the screens. they can also be embedded
  21 in the screens itself.
  22
  23
  24 A NOTE ABOUT PNGs
  25 =================
  26
  27 Enigma can user either a 32bit argb or an 8bit pseudocolor output. In any
  28 case, enigma uses 8bit PNGs for skins.
  29
  30 Though it would be easy to support 32bit pngs as well, it questionable if
  31 this would be a great idea.
  32
  33 a.) the quality improvement is realative
  34
  35 you can use another palette for each png. that gives you unique 256 colors
  36 for each skin element. Unless you have very big PNGs, you shouldn't be able
  37 to notive the difference between 32bit and 8bit.
  38
  39 b.) 32bit skins wouldn't be compatible to 8bit displays
  40
  41 we still want to use enigma on hardware which is too slow for using a 32bit
  42 output (after all, framebuffers can be very slow). Turning a 32bit bitmap
  43 into an 8bit one is not ease and involves a lot of computations.
  44
  45 It would end up that you need to specify an 8bit and a 32bit version. Is
  46 that really what you want?
  47
  48 c.) 32bit PNGs don't compress well
  49
  50 PNG is a lossless format. 32bit bitmap data is very hard to compress
  51 lossless.
  52
  53 We could use JPG, but jpgs don't offer a transparency channel, as far as i
  54 know.
  55
  56
  57 So, how to make your PNGs to look good?
  58
  59 It's simple. Edit them as 32bit ARGB (photoshop, gimp should be able to do
  60 this fine!). Be sure that if you want alphatest, transparency really has an
  61 alpha value of 0 / 255 (i.e. the extreme).
  62
  63 When you're finished, use "pngquant 256 <filename>" to process your PNGs to
  64 be compatible with enigma.
  65
  66 note:
  67 =====
  68
  69 if you're having less than 16 colors in your png file, pngquant generates a
  70 16color (4bit) PNG, which is not really what we want. Either add more colors
  71 (evil workaround), fix enigma (good idea!) or patch pngquant to
  72 always create 8bit pngs.