/* Ken Bass (kbass@kenbass.com) 09/13/2003
**
** MythTV OSD I/F utility
**
** An xml.file must be provided to this utility. The command line arg
** --name=value pairs will be replaced in the input XML file. The resulting
** XML output will be sent to the OSD via UDP.
**
** As an example, suppose you want to support caller ID. An OSD theme design
** needs to have container/textarea allocated to put your caller ID info.
**
** In the osd.xml file there should be something like this to contain the
** caller ID information:
**
** (portion of osd.xml)

  <font name="notifyfont">
    <color>255</color>
    <size>12</size>
    <outline>no</outline>
  </font>

  <container name="notify_cid_info" priority="10" fademovement="0,6">
    <image name="background">
      <filename>osd-callerid.png</filename>
      <position>0,200</position>
    </image>
    <textarea name="notify_cid_name">
      <area>410,210,200,30</area>
      <font>notifyfont</font>
      <multiline>no</multiline>
    </textarea>
    <textarea name="notify_cid_num">
      <area>410,240,200,30</area>
      <font>notifyfont</font>
      <multiline>no</multiline>
    </textarea>
  </container>

**
** The input xml to this program should look something like:
**

** (cid.xml)

<mythnotify version="1">
  <container name="notify_cid_info">
    <textarea name="notify_cid_name">
      <value>NAME: %caller_name%</value>
    </textarea>
    <textarea name="notify_cid_num">
      <value>NUM : %caller_number%</value>
    </textarea>
  </container>
</mythnotify>

** Continuing the above example, you would invoke this program as follows:

mythtvosd --template=cid.xml --caller_name="JOE SCHMOE" --caller_number="8885551212"

**
** It is the responsibility of an external program to invoke the
** mythosd program and provide appropriate parameters.
**
*/

