<!-- See a description of the format at the end. -->

<menu name="playback_osd" text="Playback Menu">
  <menu text="Audio">
    <menu text="Select Audio Track">
      <itemlist actiongroup="SELECTAUDIO_" current="active" />
    </menu>
    <item action="TOGGLEAUDIOSYNC" text="Adjust Audio Sync" />
    <menu text="Visualisation">
      <item action="DISABLEVISUALISATION" text="None" />
      <itemlist actiongroup="VISUALISER_" />
    </menu>
    <item action="DISABLEUPMIX" text="Disable Audio Upmixer" show="inactive" />
    <item action="ENABLEUPMIX" text="Enable Audio Upmixer" show="inactive" />
  </menu>
  <menu text="Video">
    <menu text="Change Aspect Ratio">
      <item action="TOGGLEASPECT0" text="Off" current="active" />
      <item action="TOGGLEASPECT1" text="4:3" current="active" />
      <item action="TOGGLEASPECT3" text="14:9" current="active" />
      <item action="TOGGLEASPECT2" text="16:9" current="active" />
      <item action="TOGGLEASPECT4" text="2.35:1" current="active" />
      <!-- Alternatively:
      <itemlist actiongroup="TOGGLEASPECT" current="active" />
      -->
    </menu>
    <menu text="Adjust Fill">
      <item action="AUTODETECT_FILL" text="Auto Detect" current="active" />
      <item action="TOGGLEFILL0" text="Off" current="active" />
      <item action="TOGGLEFILL1" text="Half" current="active" />
      <item action="TOGGLEFILL2" text="Full" current="active" />
      <item action="TOGGLEFILL3" text="H.Stretch" current="active" />
      <item action="TOGGLEFILL4" text="V.Stretch" current="active" />
      <item action="TOGGLEFILL5" text="H.Fill" current="active" />
      <item action="TOGGLEFILL6" text="V.Fill" current="active" />
      <!-- Alternatively:
      <itemlist actiongroup="TOGGLEFILL" current="active" />
      -->
    </menu>
    <item action="TOGGLEMANUALZOOM" text="Manual Zoom Mode" />
    <menu text="Adjust Picture">
      <item action="TOGGLEPICCONTROLS0" text="None" />
      <item action="TOGGLEPICCONTROLS1" text="Brightness" />
      <item action="TOGGLEPICCONTROLS2" text="Contrast" />
      <item action="TOGGLEPICCONTROLS3" text="Color" />
      <item action="TOGGLEPICCONTROLS4" text="Hue" />
      <!-- XXX TOGGLESTUDIOLEVELS is weird and shouldn't be part of
	   the TOGGLEPICCONTROLS set. -->
      <item action="TOGGLESTUDIOLEVELS"
	    textactive="Disable Studio Levels"
	    textinactive="Enable Studio Levels" />
      <item action="TOGGLEPICCONTROLS6" text="Volume" />
      <!-- Alternatively:
      <itemlist actiongroup="TOGGLEPICCONTROLS" />
      -->
      <item action="TOGGLENIGHTMODE"
	    textactive="Disable Night Mode" textinactive="Enable Night Mode" />
    </menu>
    <menu text="3D">
      <item action="3DNONE" text="None" current="active" />
      <item action="3DSIDEBYSIDE" text="Side by Side" current="active" />
      <item action="3DSIDEBYSIDEDISCARD" text="Discard Side by Side" current="active" />
      <item action="3DTOPANDBOTTOM" text="Top and Bottom" current="active" />
      <item action="3DTOPANDBOTTOMDISCARD" text="Discard Top and Bottom" current="active" />
      <!-- Alternatively:
      <itemlist actiongroup="3D" current="active" />
      -->
    </menu>
    <menu text="Advanced">
      <menu text="Video Scan">
        <item action="SELECTSCAN_0" text="Detect" current="active" />
        <item action="SELECTSCAN_3" text="Progressive" current="active" />
        <item action="SELECTSCAN_1" text="Interlaced (Normal)" current="active" />
        <item action="SELECTSCAN_2" text="Interlaced (Reversed)" current="active" />
	<!-- Alternatively:
	<itemlist actiongroup="SELECTSCAN_" current="active" />
	-->
      </menu>
      <menu text="Deinterlacer">
        <itemlist actiongroup="DEINTERLACER_" current="active" />
      </menu>
    </menu>
  </menu>
  <menu text="Subtitles">
    <item action="DISABLESUBS" text="Disable Subtitles" show="inactive" />
    <item action="ENABLESUBS" text="Enable Subtitles" show="inactive" />
    <item action="DISABLEFORCEDSUBS" text="Disable Forced Subtitles" show="inactive" />
    <item action="ENABLEFORCEDSUBS" text="Enable Forced Subtitles" show="inactive" />
    <menu text="Select Subtitle" current="active">
      <itemlist actiongroup="SELECTSUBTITLE_" />
    </menu>
    <menu text="Text Subtitles" current="active">
      <item action="DISABLEEXTTEXT" text="Disable External Subtitles" show="inactive" />
      <item action="ENABLEEXTTEXT" text="Enable External Subtitles" show="inactive" />
      <itemlist actiongroup="SELECTRAWTEXT_" />
    </menu>
    <menu text="Select ATSC CC">
      <itemlist actiongroup="SELECTCC708_" current="active" />
    </menu>
    <menu text="Select VBI CC">
      <itemlist actiongroup="SELECTCC608_" current="active" />
    </menu>
    <menu text="Select Teletext CC">
      <itemlist actiongroup="SELECTTTC_" current="active" />
    </menu>
    <item action="TOGGLETTM" text="Toggle Teletext Menu" />
    <item action="TOGGLESUBZOOM" text="Adjust Subtitle Zoom" />
    <item action="TOGGLESUBDELAY" text="Adjust Subtitle Delay" />
  </menu>
  <menu text="Playback">
    <item action="PAUSE" textactive="Play" textinactive="Pause" />
    <menu text="Adjust Time Stretch">
      <item action="TOGGLESTRETCH" text="Toggle" current="active" />
      <item action="ADJUSTSTRETCH" text="Adjust" current="active" />
      <item action="ADJUSTSTRETCH0.5" text="0.5X" current="active" />
      <item action="ADJUSTSTRETCH0.9" text="0.9X" current="active" />
      <item action="ADJUSTSTRETCH1.0" text="1.0X" current="active" />
      <item action="ADJUSTSTRETCH1.1" text="1.1X" current="active" />
      <item action="ADJUSTSTRETCH1.2" text="1.2X" current="active" />
      <item action="ADJUSTSTRETCH1.3" text="1.3X" current="active" />
      <item action="ADJUSTSTRETCH1.4" text="1.4X" current="active" />
      <item action="ADJUSTSTRETCH1.5" text="1.5X" current="active" />
      <!-- Alternatively:
      <itemlist actiongroup="ADJUSTSTRETCH" current="active" />
      -->
    </menu>
    <menu text="Picture-in-Picture">
      <item action="CREATEPIPVIEW" text="Open Live TV PIP" show="inactive" />
      <item action="CREATEPBPVIEW" text="Open Live TV PBP" show="inactive" />
      <item action="JUMPRECPIP" text="Open Recording PIP" show="inactive" />
      <item action="JUMPRECPBP" text="Open Recording PBP" show="inactive" />
      <item action="NEXTPIPWINDOW" text="Change Active Window" />
      <item action="TOGGLEPIPMODE" text="Close PIP" show="inactive" /> <!-- XXX "Close PIPs" -->
      <item action="TOGGLEPBPMODE" text="Close PBP" show="inactive" /> <!-- XXX "Close PBPs" -->
      <item action="SWAPPIP" text="Swap Windows" />
      <item action="TOGGLEPIPSTATE"
	    textactive="Switch to PBP" textinactive="Switch to PIP" />
    </menu>
    <menu text="Sleep">
      <item action="TOGGLESLEEPON" text="Sleep Off" />
      <item action="TOGGLESLEEP30" text="Sleep 30 minutes" />
      <item action="TOGGLESLEEP60" text="Sleep 60 minutes" />
      <item action="TOGGLESLEEP90" text="Sleep 90 minutes" />
      <item action="TOGGLESLEEP120" text="Sleep 120 minutes" />
      <!-- Alternatively:
      <itemlist actiongroup="TOGGLESLEEP" />
      -->
    </menu>
    <menu text="Channel Groups">
      <item action="CHANGROUP_ALL_CHANNELS" text="All Channels" />
      <itemlist actiongroup="CHANGROUP_" current="active" />
    </menu>
    <item action="TOGGLEBROWSE" text="Toggle Browse Mode" />
    <item action="CANCELPLAYLIST" text="Cancel Playlist" />
    <item action="DEBUGOSD" text="Playback Data" />
  </menu>
  <menu text="Navigate">
    <item action="JUMPFFWD" text="Jump Ahead" />
    <item action="JUMPRWND" text="Jump Back" />
    <menu text="Commercial Auto-Skip">
      <item action="TOGGLECOMMSKIP0" text="Auto-Skip OFF" current="active" />
      <item action="TOGGLECOMMSKIP2" text="Auto-Skip Notify" current="active" />
      <item action="TOGGLECOMMSKIP1" text="Auto-Skip ON" current="active" />
      <!-- Alternatively:
      <itemlist actiongroup="TOGGLECOMMSKIP" current="active" />
      -->
    </menu>
    <!-- JUMPTODVDROOTMENU has different text/meanings for BD & DVD -->
    <item action="JUMPTODVDROOTMENU"
	  textactive="DVD Root Menu" textinactive="Top menu" />
    <item action="JUMPTOPOPUPMENU" text="Popup menu" />
    <item action="JUMPTODVDTITLEMENU" text="DVD Title Menu" />
    <item action="JUMPTODVDCHAPTERMENU" text="DVD Chapter Menu" />
    <item action="PREVCHAN" text="Previous Channel" />
    <menu text="Chapter">
      <itemlist actiongroup="JUMPTOCHAPTER" current="active" />
    </menu>
    <menu text="Angle">
      <itemlist actiongroup="SWITCHTOANGLE" current="active" />
    </menu>
    <menu text="Title">
      <itemlist actiongroup="JUMPTOTITLE" current="active" />
    </menu>
  </menu>
  <menu text="Schedule">
    <item action="GUIDE" text="Program Guide" />
    <item action="FINDER" text="Program Finder" />
    <item action="VIEWSCHEDULED" text="Upcoming Recordings" />
    <item action="SCHEDULE" text="Edit Recording Schedule" />
  </menu>
  <menu text="Source">
    <menu text="Jump to Program">
      <item action="JUMPREC" text="Recorded Program" /> <!-- XXX needs a complex menu -->
    </menu>
    <menu text="Switch Input">
      <itemlist actiongroup="SWITCHTOINPUT_" show="inactive" />
    </menu>
    <menu text="Switch Source">
      <!-- XXX Need a new action like SWITCHTOSOURCE_ -->
      <itemlist actiongroup="SWITCHTOINPUT_" />
    </menu>
  </menu>
  <menu text="Jobs">
    <!-- XXX Need different Channel/Recording text based on context -->
    <item action="EDIT" text="Edit Channel" />
    <item action="EDIT" text="Edit Recording" />
    <item action="TOGGLEAUTOEXPIRE"
	  textactive="Auto-Expire OFF" textinactive="Auto-Expire ON" />
    <item action="QUEUETRANSCODE" text="Stop Transcoding" show="active" />
    <menu text="Begin Transcoding">
      <item action="QUEUETRANSCODE" text="Default" show="inactive" />
      <item action="QUEUETRANSCODE_AUTO" text="Autodetect" show="inactive" />
      <item action="QUEUETRANSCODE_HIGH" text="High Quality" show="inactive" />
      <item action="QUEUETRANSCODE_MEDIUM" text="Medium Quality" show="inactive" />
      <item action="QUEUETRANSCODE_LOW" text="Low Quality" show="inactive" />
    </menu>
  </menu>
</menu>

<!--
Menu items are shown only if that item is actually available in the
current context, or if some item of a submenu would be shown.

Action names are the same as those used in MythTV.  It would be nice
to cleanse and normalize them if they are to be used externally.

For the itemlist element, the "actiongroup" attribute is the name of a
set of actions, which is usually just a unique prefix of the action
names.

Each action has a default "textactive" and "textinactive" attribute
value, so these can be omitted.  In fact, all the text* values in this
example can be omitted since they are there to illustrate the
defaults.  The "text" attribute is a shortcut for setting textactive
and textinactive to the same value.

Each action corresponds to an "active" or "inactive" state in the
current context.  The text label can depend on the state, via the
"textactive" and "textinactive" attributes in the item element.
Showing the menu item can depend on the state, via show="active" and
show="inactive" (the "show" attribute is also valid for the itemlist
element).  Specifying current="active" for an item or itemlist element
is a directive to make that item currently selected when the menu is
entered if the item's state is active.

The "name" attribute for a menu is only needed if it's the name of a
menu expected in the MythTV code, or if it is to be embedded somewhere
else via the "from" attribute.

The "itemlist" element could potentially accept a "flags" attribute to
allow the themer to provide hints to filter/reorder the list.  Wait to
find a real use case.

When a menu is entered, the item with focus is the submenu being
returned from, or the first active item when current="active"
is specified, or the first item.
-->