[mythtv] Trying to document theme format

[Michael J. Hammel]

I'm trying to document how themes are designed.  I'm not an XML
developer, so if there is a desired format for how such a document
should look I'm not aware of it.  I'm just looking to write a short
Howto for building themes for MythTV.

Here is what I've deduced from the existing themes so far.  The one
question I have for the theme.xml file is what the buttondef "offset"
option is for (image or text or both) and relative to - the upper left
corner for the buttondef box?  I haven't looked into the ui.xml file. 
Some themes have other xml files and I'm not sure what those are for
yet.  I only started digging into this today.

Side note:  the font sizes specified are defaults only, correct?  The
user can change these in the Setup module - or at least that's the way
it appears (perhaps those settings don't affect buttons).


Two required XML files for a theme:
   a. theme.xml:  Main user interface description
   b. ui.xml:  Program Guide interface description


theme.xml
---------
Note:  image sizes are not defined unless otherwise specified.

background
   Describes the background area for all screens
   ARGUMENTS:
      style:  Normal, Tiled
   OPTIONS:
      image:  image to use for background (size: 800x600)
      buttonarea:  uuperX, upperY, width, height

titles
   Defines title bars to use on each screen.
   OPTIONS:
      position:  X,Y position for text to start
      image:  images to use for titles
         OPTIONS:
            mode:  screen associated with this image
               One of the following
               MAIN - main menu
               SETUP - main setup
               TV - TV top level menu
               TVSETUP - setup for TV module
               SCHEDULE - EPG menu
               MUSIC - Music module
               MUSIC_SETTINGS - setup for Music module
               GALLERY - Photo album module
               GAMES - Games module
               WEATHER - Weather module
               VIDEO - Video module
               VIDEO_SETTINGS - Video setup 


genericbutton
   Describes generic button appearance for all screens
   OPTIONS:
      watermarkposition: X, Y screen location for watermarks
      normal:  image used when button is not active
      active:  image used when button is active
      text:  describes text area within button
         OPTIONS:
            area:  X, Y, width, height
            color:  text color
            fontname:  text font
            fontsize:  default font size
            bold:  yes, no
            italics:  yes, no
            centered:  yes, no
            outline:  if defined, sets outline for text block
               OPTIONS:
                  color:  outline color
                  size:  pixel width of outline
            shadow:  if defined, places a shadow behind text box
               OPTIONS:
                  color:  shadow color
                  offset:  shadow offset
                  alpha:  transparency level


logo
   Defines logo image to use on all pages
   OPTIONS:
      image:  image to use for logo
      position:  X,Y position on screen


uparrow
   Defines up arrow image to use when a menu has more (non-visible)
options
   OPTIONS:
      image:  image to use for up arrow
      position:  X,Y position on screen

downarrow
   Defines down arrow image to use when a menu has more (non-visible)
options
   OPTIONS:
      image:  image to use for down arrow
      position:  X,Y position on screen


buttondef
   ARGUMENTS:
      name:  defines which button this section describes
         One of the following for main menu:
            TV
            MUSIC
            GAME
            IMAGES
            VIDEO
            WEATHER
            SETUP
         One of the following for EPG:
            TV_SCHEDULE
            TV_PLAYBACK
            TV_CONFLICTS
            TV_DELETE
         One of the following for Music module:
            MUSIC_PLAYLIST
            MUSIC_RIP
         One of the following for Video module:
            VIDEO
            VIDEO_MANAGER
            VIDEO_BROWSER
            VIDEO_LIST
   OPTIONS:
      image:  Image to use in button, if any (can be transparent image)
      watermarkimage:  snazzy graphic associated with this button
      offset: X,Y offset from buttons upper left corner (I think).