Menu Sections:

• Girder Variables as Caption/Commandstring: You can use girder variables in both the caption and commandstrings which will be replaced with the variable values before the menu is opened.
  Eg. Launch [thegame]=c:\games\[gamename].
  Special case: Eg. [mycaptionvar]=fred. This would fail because the ini file interprets this as a separate section. To fix this use a % sign before the variable (ONLY if the variable comes first):
  Eg. %[mycaptionvar]=fred.
  (The % sign is removed internally).
• Menuitem Caption: The inifile variable name specifies the caption for a menuitem.
  
• Menuitem Commandstring: The commandstring for the menuitem specifies what happens when it is triggered.
• Specifying Submenu to start:
  By default, initial submenu is [main]. To specify initial submenu:
  In the settings dialog, add a # followed by the submenu name to the ini file path.
  Eg. menu file: F:\Program Files\girder\Plugins\osdmenu\samplemenu.ini#greatmenu would display a submenu called greatmenu.
• Spacer/Blank Entry: You can create non-selectable menuitems which act as spacers within the menu. To do this you must specify the menuitem caption as #CMD: followed by any text you wish displayed, or one of the following keywords:
  BLANK, LINETOP, LINEMID, LINEBOTTOM.
  Eg. #CMD:LINETOP= would display a spacer with a horizontal line across the top of the space.
  NOTE: The spacers are still treated as menuitems by the program logic. This means when you execute an item by number (keyboard or message) you must take into account the spacer (if the spacer entry is triggered the message is just dropped by osdmenu).
• Tab character: You can use \t in the caption to shift all text after the \t to the right of the menu. This is useful for Title-Artist situations. It will display as (eg):
  

  Titlexxx1	- Artist
  Titlexxxxxx2	- Artist

• Type the path to the file WITHOUT quotes:
  Eg. c:\program files\winamp\winamp.exe
• If you want to use parameter for the file add them on the end:
  Eg. c:\program files\winamp\winamp.exe /ADD "e:\my playlists\myplaylist.m3u"
  (Note that the filename in the parameters has been enclosed by quotes, otherwise winamp would try and load it as two files - you'll have to experiment to see whether the parameters need to be quoted or not).
• NOTE: If the file is located in the plugins/osdmenu subfolder you can just specify the filename. Otherwise use full paths.

• OSDMenu can send events directly to Girder.
  This is done by using # in a commandstring:
  myevent=#[devicenum]#[event_string]#[payload]
  [devicenum] - corresponds to the plugin device number which would be 18 for girderevent, or plugin id for any other.
  [eventstring] - any eventstring you wish(that exists in girder).
  [payload] - optional payload, referenced in girder by [pld1] - if you don't want a payload simply omit the final #[payload] section.
  
• You can assign custom eventstrings in Girder through the usual method, selecting 'Girder Events' from the dropdown box and clicking 'Learn Event'. Type the eventstring in the textbox.

• To open another submenu add a % sign to the beginning of the commandstring.
  Eg. newmenu=%mysubmenu.
• You can also open submenus from another inifile in the same way:
  Eg. anothermenu=%moremenus.ini#anothersubmenu.

Visual Sections:

• Master visual section must be [visual].
• For submenu specific visual settings use [vis_{submenu name}] - Variables specifed here will override [visual] for that submenu.
• Some variables are required, some optional.

Misc Section:

• These variables go in the [misc] section.
• These entries define variables for passing data to/from girder.
• All variables are optional.