Difference between revisions of "Menu-ui.xml"

Revision as of 12:41, 2 September 2008

menu-ui.xml is a new file proposed to be used to specify the organisation of mythtv's main menu screens

<myththeme>

It is comprised of: The mainmenu window.

   <window name="mainmenu">

font definitions:

<font name="basefont" face="Arial">
        <color>#FFFFFF</color>
        <size>22</size>
        <size:small>16</size:small>
        <size:big>50</size:big>
    </font>

    <font name="redfont" from="basefont"> <!-- define 'redfont' inheriting properties of 'basefont' N.B. 'from=' replaces 'base=' used before mythui -->
         <color>#FF0000</color>
    </font>
    
    <font name="greenfont" from="basefont">
         <color>#00FF00</color>
    </font>

An (optional) clock definition:

   <clock name="clock">
        <area>300,200,200,40</area>  <!-- clock area 200 px wide by 40 px high starting at 300,300 -->
        <font>basefont</font>
        <align>right</align>  <!-- optional attribute, defaults to  'left' -->
        <format>%DATE% %TIME%</format> <!-- valid values are:  -->
        <alpha>200</alpha> <!-- optional, sets text opacity.  Defaults to 255 -->
    </clock>

Definition of menu page titles:

<statetype name="titles">
    <position>20,20</position> <!-- position at 20 px from the left, 20px from the top of screen -->
    <state name="TV">
        <imagetype name="TV">
            <filename>title/title_tv.png</filename>
        </imagetype>
    </state>
    <state name="TVSETUP" from="TV" /> <!-- inherit from 'TV' state -->
...
...
...
</statetype>

Note that the states do not have to contain merely images, they could just as easily be defined as follows:

<state name="TV">
    <textarea name="TV">
        <area>0,0,300,40</area>
        <font>menufont</font>
        <align>right</align>
        <alpha>127</alpha> <!-- set to half transparent -->
        <value>TV</value> <!-- the text to be displayed -->
    </textarea>
</state>

Or, possibly a combination of text and images:

<state name="TV">
    <imagetype name="TV">
            <filename>title/title_tv.png</filename>
    </imagetype>
    <textarea name="TV2"> <!-- children of the same parent need unique names -->
        <area>0,0,300,40</area>
        <font>menufont</font>
        <align>right</align>
        <alpha>127</alpha> <!-- set to half transparent -->
        <value>TV</value> <!-- the text to be displayed -->
    </textarea>
</state>