home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 2002 October / JOY141_CD2.iso / Data / Sharewares / Audio / s2alpha_install_020828.exe / 1c_file < prev    next >
Text (UTF-16)  |  2002-08-28  |  186KB  |  1,890 lines

  1. <translation>
  2.     <module name="sonique">
  3.         <language name="English">
  4.             <section name="help">
  5.                 <section name="eq">
  6.                     <item name="GetNumBands">
  7. How many bands the equalizer is configured to use - Usage: equalizer.GetNumBands();
  8.        Return value:   The number of bands in the current configuration
  9.                     </item>
  10.  
  11.                     <item name="SetNumBands">
  12. Set the number of bands the equalizer is configured to use. - Usage: equalizer.SetNumBands(num);
  13.        num             The number of bands to use - between 1 and 200.
  14.                     </item>
  15.  
  16.                     <item name="GetEQData">
  17. Retrieve the current EQ gain settings. - Usage: equalizer.GetEQData();
  18.        Return value:   An array of gain values, the length of which is the number of bands.
  19.                     </item>
  20.  
  21.                     <item name="SetEQData">
  22. Set the equalizer gain settings. - Usage: equalizer.SetEQData(banddata);
  23.        banddata        An array of gain data, one value for each equalizer band.
  24.                     </item>
  25.  
  26.                     <item name="GetBandGain">
  27. Get the gain for one frequency band. - Usage: equalizer.GetBandGain(band);
  28.        band            Which frequency band to query the gain of.
  29.        Return value:   The gain for that equalizer band
  30.                     </item>
  31.  
  32.                     <item name="SetBandGain">
  33. Set the gain for one frequency band. - Usage: equalizer.SetBandGain(band, gain);
  34.        band            Which frequency band to query the gain of.
  35.        gain            The gain to set it to..
  36.                     </item>
  37.  
  38.                     <item name="RegisterChangeCallback">
  39. Register for callback whenever EQ information changes. - Usage: equalizer.RegisterChangeCallback(name, script, context);
  40.        name            The name of the callback, for future reference.
  41.        script          The script to call when eq information has changed.  It will be passed a single parameter, boolean in value, which tells whether the number of bands has changed.
  42.        context         Optional: The object that the script should be run from.  Default: The equalizer
  43.        Return value:   'registered' if success.
  44.                     </item>
  45.  
  46.                     <item name="UnregisterChangeCallback">
  47. Unregister a previously registered callback. - Usage: equalizer.UnregisterChangeCallback(name, context);
  48.        name            The name of the callback to unregister.
  49.        context         Optional: The object that the script is associated with.  Default: The equalizer
  50.        Return value:   'unregistered' if success.
  51.                     </item>
  52.  
  53.                     <item name="Reset">
  54. Reset the equalizer to flat (no equalization). - Usage: equalizer.Reset();
  55.                     </item>
  56.                 </section>
  57.  
  58.                 <section name="pab">
  59.                     <item name="GetPitch">
  60. Get the pitch setting - Usage: PitchAmpBal.GetPitch();
  61.        Return value:   The pitch setting, in the range 0.125 to 8.0
  62.                     </item>
  63.  
  64.                     <item name="GetAmplification">
  65. Get the amplification setting - Usage: PitchAmpBal.GetAmplification();
  66.        Return value:   The amplification setting, in the range 0.125 to 8.0
  67.                     </item>
  68.  
  69.                     <item name="GetBalance">
  70. Get the balance setting - Usage: PitchAmpBal.GetBalance();
  71.        Return value:   The balance setting, in the range -1.0 to 1.0
  72.                     </item>
  73.  
  74.                     <item name="SetPitch">
  75. Set the pitch setting - Usage: PitchAmpBal.SetPitch(pitch);
  76.        pitch           The pitch and tempo to set (a multiple of 'normal') in the range of 0.125 to 8.0
  77.                     </item>
  78.  
  79.                     <item name="SetAmplification">
  80. Set the amplification setting - Usage: PitchAmpBal.SetAmplification(gain);
  81.        gain            The gain to set in the range of 0.125 to 8.0
  82.                     </item>
  83.  
  84.                     <item name="SetBalance">
  85. Set the balance - Usage: PitchAmpBal.SetBalance(balance);
  86.        balance         The balance to set in the range of -1.0 to 1.0 (negative being to the left)
  87.                     </item>
  88.  
  89.                     <item name="RegisterChangeCallback">
  90. Register for callback whenever pitch, amplification, or balance settings change. - Usage: PitchAmpBal.RegisterChangeCallback(name, script, context);
  91.        name            The name of the callback, for future reference.
  92.        script          The script to call when settings have changed.
  93.        context         Optional: The object that the script should be run from.  Default: The PitchAmpBal object
  94.        Return value:   'registered' if success.
  95.                     </item>
  96.  
  97.                     <item name="UnregisterChangeCallback">
  98. Unregister a previously registered callback. - Usage: PitchAmpBal.UnregisterChangeCallback(name, context);
  99.        name            The name of the callback to unregister.
  100.        context         Optional: The object that the script is associated with.  Default: The PitchAmpBal object
  101.        Return value:   'unregistered' if success.
  102.                     </item>
  103.                 </section>
  104.  
  105.                 <section name="files">
  106.                     <item name="RegisterFileAssociation">
  107. Registers a file extention for Sonique 2 - Usage: files.RegisterFileAssociation(ext, actions, description);
  108.        ext             The extention to register
  109.        actions         A comma delimited list of actions. Possible values are "open" and "add".
  110.        description     Optional: A description of the file type eg., Ogg Vorbis file  Default: null
  111.                     </item>
  112.  
  113.                     <item name="UnregisterFileAssociation">
  114. Unregister a file extention for Sonique2 - Usage: files.UnregisterFileAssociation(ext);
  115.        ext             The extention to unregister
  116.                     </item>
  117.  
  118.                     <item name="IsFileAssociationRegistered">
  119. Queries whether a file association is registered for Sonique2. - Usage: files.IsFileAssociationRegistered(ext);
  120.        ext             The extention to query
  121.        Return value:   If registered, the type of registration, othereise false
  122.                     </item>
  123.                 </section>
  124.  
  125.                 <section name="playlists">
  126.                     <item name="AddPlaylist">
  127. Add a playlist - Usage: playlists.AddPlaylist(name);
  128.        name            The name of the playlist to add.
  129.        Return value:   'done' on success
  130.                     </item>
  131.  
  132.                     <item name="RemovePlaylist">
  133. Remove a playlist - Usage: playlists.RemovePlaylist(name);
  134.        name            The name of the playlist to remove.
  135.        Return value:   'done' on success
  136.                     </item>
  137.  
  138.                     <item name="RenamePlaylist">
  139. Rename a playlist - Usage: playlists.RenamePlaylist(oldname, newname);
  140.        oldname         The name of the playlist to rename.
  141.        newname         Its new name.
  142.        Return value:   'renamed' on success
  143.                     </item>
  144.  
  145.                     <item name="GetPlaylistList">
  146. Retrieve a list of playlists - Usage: playlists.GetPlaylistList();
  147.        Return value:   An array of playlist objects.
  148.                     </item>
  149.  
  150.                     <item name="MakeTempPlaylist">
  151. Create a temporary playlist - Usage: playlists.MakeTempPlaylist(name);
  152.        name            The prefered name of the playlist to create
  153.        Return value:   Actual name of the playlist (this may differ from the preferred name)
  154.                     </item>
  155.  
  156.                     <item name="CombinePlaylists">
  157. Merge playlists - Usage: playlists.CombinePlaylists(dest, source, bAppend);
  158.        dest            The playlist to merge into
  159.        source          The playlist to merge from
  160.        bAppend         Optional: If false, this replaces the dest with the source  Default: true
  161.        Return value:   Actual name of the playlist (this may differ from the preferred name)
  162.                     </item>
  163.  
  164.                     <item name="SetIdleScan">
  165. Configure the playlist idle scan - Usage: playlists.SetIdleScan(mode);
  166.        mode            One of the following:  'none' 'quick' or 'thorough'
  167.                     </item>
  168.                 </section>
  169.  
  170.                 <section name="players">
  171.                     <item name="AddPlayer">
  172. Add a player - Usage: players.AddPlayer(name);
  173.        name            The name of the player to add.
  174.        Return value:   'done' on success
  175.                     </item>
  176.  
  177.                     <item name="RemovePlayer">
  178. Remove a player - Usage: players.RemovePlayer(name);
  179.        name            The name of the player to remove.
  180.        Return value:   'done' on success
  181.                     </item>
  182.  
  183.                     <item name="RenamePlayer">
  184. Rename a player - Usage: players.RenamePlayer(oldname, newname);
  185.        oldname         The name of the player to rename.
  186.        newname         Its new name.
  187.        Return value:   'renamed' on success
  188.                     </item>
  189.  
  190.                     <item name="GetPlayerList">
  191. Retrieve a list of players - Usage: players.GetPlayerList();
  192.        Return value:   An array of player objects.
  193.                     </item>
  194.  
  195.                     <item name="MakeTempPlayer">
  196. Create a temporary player - Usage: players.MakeTempPlayer(name);
  197.        name            The prefered name of the player to create
  198.        Return value:   Actual name of the player (this may differ from the preferred name)
  199.                     </item>
  200.  
  201.                     <item name="GetEndpointList">
  202. Get a list of available endpoints (audio output devices) - Usage: players.GetEndpointList();
  203.     
  204. Each endpoint is reported as an array with the following members:  'name', 'description', 'factoryID'.
  205.        Return value:   An array of endpoints (audio output devices)
  206.                     </item>
  207.  
  208.                     <item name="QueryDefaultEndpoint">
  209. What is the default output device? - Usage: players.QueryDefaultEndpoint();
  210.        Return value:   The name of the default endpoing (output device)
  211.                     </item>
  212.  
  213.                     <item name="SelectDefaultEndpoint">
  214. Set the default output device? - Usage: players.SelectDefaultEndpoint(device);
  215.        device          The name of the audio output device to use as the default endpoint.
  216.        Return value:   The name of the default endpoing (output device)
  217.                     </item>
  218.  
  219.                     <item name="GetStreamList">
  220. Get a list of available streams (audio input devices) - Usage: players.GetStreamList();
  221.        Return value:   An array of streams (audio input devices)
  222. Each stream is reported as an array with the following members:  'name', 'description', 'factoryID'.
  223.                     </item>
  224.  
  225.                     <item name="GetFilterList">
  226. Get a list of available filters (audio decoding devices) - Usage: players.GetFilterList();
  227.        Return value:   An array of filters (audio decoding devices)
  228. Each filter is reported as an array with the following members:  'name', 'description', 'factoryID'.
  229.                     </item>
  230.  
  231.                     <item name="GetDSPList">
  232. Get a list of available dsps (audio processing devices) - Usage: players.GetDSPList();
  233.        Return value:   An array of DSPs (audio processing devices)
  234. Each DSP is reported as an array with the following members:  'name', 'description', 'factoryID'.
  235.                     </item>
  236.  
  237.                     <item name="GetMiscAudioList">
  238. Get a list of available miscellaneous audio plugins - Usage: players.GetMiscAudioList();
  239.        Return value:   An array of audio settings objects
  240. Each plugin is reported as an array with the following members:  'name', 'description', 'factoryID'.
  241.                     </item>
  242.                 </section>
  243.  
  244.                 <section name="playlist">
  245.                     <item name="AddItem">
  246. Add an item to the playlist - Usage: playlist.AddItem(item, where);
  247.        item            The URL or filename of the item to add to the playlist, or an array of URLs and filenames.
  248.        where           Optional: 'top', 'bottom' or the UID of the item to place it after  Default: bottom
  249.                     </item>
  250.  
  251.                     <item name="RemoveItem">
  252. Remove items from the playlist - Usage: playlist.RemoveItem(items);
  253.        items           The UID of an item to remove, or an array of UIDs.
  254.        Return value:   'removed' on success, null on error.
  255.                     </item>
  256.  
  257.                     <item name="MoveItem">
  258. Move items in the playlist - Usage: playlist.MoveItem(item, where);
  259.        item            A UID (or array of UIDS) to move within the playlist
  260.        where           Optional: 'top', 'bottom' or the UID of the item to place them after  Default: bottom
  261.        Return value:   'moved' on success, null on error
  262.                     </item>
  263.  
  264.                     <item name="RemoveAll">
  265. Remove all items from the playlist. - Usage: playlist.RemoveAll();
  266.        Return value:   'removed' on success, null on error
  267.                     </item>
  268.  
  269.                     <item name="GetFirstUID">
  270. Get the UID of the first item in the playlist - Usage: playlist.GetFirstUID(bShuffled);
  271.     
  272. The following code will count how many items are in the playlist:
  273. $key = :sonique.playlists.default.Lock();
  274. $UID = :sonique.playlists.default.GetFirstUID();
  275. $count = 1;
  276. while ($UID = :sonique.playlists.default.GetNextUID($UID))
  277. {
  278.     $count++;
  279. }
  280. :sonique.playlists.default.Unlock($key);
  281.        bShuffled       Optional: If true, this retrieves items in the order that they will be played with the current shuffling. Otherwise, it sorts by the playlist item numbers.  Default: true
  282.        Return value:   The UID of the first item in the playlist
  283.                     </item>
  284.  
  285.                     <item name="GetNextUID">
  286. Get the UID of the next item in the playlist - Usage: playlist.GetNextUID(UID, bShuffled);
  287.     
  288. The following code will count how many items are in the playlist:
  289. $key = :sonique.playlists.default.Lock();
  290. $UID = :sonique.playlists.default.GetFirstUID();
  291. $count = 1; 
  292. while ($UID = :sonique.playlists.default.GetNextUID($UID))
  293. {
  294.     $count++;
  295. }
  296. :sonique.playlists.default.Unlock($key);
  297. // Better would be :sonique.playlsits.default.GetCount();
  298.        UID             The UID of the item you're currently at.
  299.        bShuffled       Optional: If true, this retrieves items in the order that they will be played with the current shuffling. Otherwise, it sorts by the playlist item numbers.  Default: true
  300.        Return value:   The UID of the next item in the playlist, or null if we're at the end.
  301.                     </item>
  302.  
  303.                     <item name="GetPrevUID">
  304. Get the UID of the previous item in the playlist - Usage: playlist.GetPrevUID(UID, bShuffled);
  305.        UID             The UID of the item you're currently at.
  306.        bShuffled       Optional: If true, this retrieves items in the order that they will be played with the current shuffling. Otherwise, it sorts by the playlist item numbers.  Default: true
  307.        Return value:   The UID of the previous item in the playlist, or null if we're at the beginning.
  308.                     </item>
  309.  
  310.                     <item name="Reshuffle">
  311. Reshuffle the playlist. - Usage: playlist.Reshuffle();
  312.                     </item>
  313.  
  314.                     <item name="Sort">
  315. Sort the playlist. - Usage: playlist.Sort(field, direction);
  316.        field           Which field to sort by.  This can be author, title, or any of the values returned from GetTokenList()
  317.        direction       Optional: The direction to sort by  Default: forwards
  318.        Return value:   'sorted' on success, null on failure
  319.                     </item>
  320.  
  321.                     <item name="Randomize">
  322. Randomize the order of the playlist - Usage: playlist.Randomize();
  323.        Return value:   'randomized' on success, otherwise null.
  324.                     </item>
  325.  
  326.                     <item name="Reverse">
  327. Reverse the order of the playlist - Usage: playlist.Reverse();
  328.        Return value:   'reversed' on success, otherwise null.
  329.                     </item>
  330.  
  331.                     <item name="Lock">
  332. Locks the playlist for manipulation. - Usage: playlist.Lock();
  333.     
  334. This function locks the playlist so that other threads won't change it.  You should use it when performing a number of operations that require the playlist to not change in between.  After locking it, you should whatever operations you want and then unlock it within a relatively short period of time, to ensure that other playlist operations remain responsive.
  335.        Return value:   A cookie that must be used with Unlock, or null on error.
  336.                     </item>
  337.  
  338.                     <item name="Unlock">
  339. Unlock a previously locked playlist.  See the Lock function for details. - Usage: playlist.Unlock(cookie);
  340.        cookie          The cookie returned by Lock
  341.        Return value:   'unlocked' on success, null otherwise
  342.                     </item>
  343.  
  344.                     <item name="UpdateLock">
  345. Refresh the lock on the playlist so it doesn't time out. - Usage: playlist.UpdateLock(cookie);
  346.     
  347. Locks will eventually time out (after 30 seconds or so).  If this is a problem, you should refresh the lock.  This will not be necessary except in extraordinary cases.  Use this with extreme care - if this is misused it will effectively make the playlist unusable from the rest of the program.
  348.        cookie          The cookie returned by Lock
  349.        Return value:   'updated' on success, null otherwise.
  350.                     </item>
  351.  
  352.                     <item name="GetCurrentVersion">
  353. Gets the revision number of the playlist. This increments whenever the playlist changes. - Usage: playlist.GetCurrentVersion();
  354.        Return value:   The revision number of the playlist
  355.                     </item>
  356.  
  357.                     <item name="GetCurrentList">
  358. Retrieves the playlist as an array of UIDs - Usage: playlist.GetCurrentList();
  359.        Return value:   An array of UIDs currently in the playlist.
  360.                     </item>
  361.  
  362.                     <item name="GetChangeList">
  363. Retrieves a list of what has changed in the playlist. - Usage: playlist.GetChangeList(rev);
  364.        rev             The revision that you wish to diff against
  365.        Return value:   An array, containing a subarray of UIDs (named 'ids'), the current version (named 'version') and a boolean value telling whether the order changed (named 'order_changed')
  366.                     </item>
  367.  
  368.                     <item name="GetCount">
  369. How many items are in the playlist? - Usage: playlist.GetCount();
  370.        Return value:   The number of items in the playlist
  371.                     </item>
  372.  
  373.                     <item name="GetUIDIndex">
  374. Get the index of the specified UID in the playlist. - Usage: playlist.GetUIDIndex(UID);
  375.        UID             The UID to search for.
  376.        Return value:   The index of that UID
  377.                     </item>
  378.  
  379.                     <item name="GetUIDAtIndex">
  380. Get the UID at a given index. - Usage: playlist.GetUIDAtIndex(index);
  381.        index           Which UID to get.
  382.        Return value:   The UID at the specified index.
  383.                     </item>
  384.  
  385.                     <item name="GetUIDForURL">
  386. Search for a URL - Usage: playlist.GetUIDForURL(URL);
  387.        URL             The URL to search for
  388.        Return value:   The UID that corresponds with a given URL. If that URL is in the playlist multiple times, only one will be returned.  If no results are found, null is returned.
  389.                     </item>
  390.  
  391.                     <item name="GetTotalPlaylistTime">
  392. The total playlist length - Usage: playlist.GetTotalPlaylistTime();
  393.        Return value:   An array, containing an element named 'time' with the time, and an element named type which will be one of the following: duration_estimate, duration_verified, duration_unknown, duration_infinite
  394.                     </item>
  395.  
  396.                     <item name="GetSongAtTime">
  397. Get the info for the song at the specified time into the playlist. - Usage: playlist.GetSongAtTime(time);
  398.        time            The time into the playlist to query.
  399.        Return value:   An array containing the following elements:  id, url, title, author, duration, duration_type, album, and subposition (how far into this song we are at the given time)
  400.                     </item>
  401.  
  402.                     <item name="GetSongAtPercent">
  403. Get the info for the song at the specified percent through the playlist. - Usage: playlist.GetSongAtPercent(percent);
  404.        percent         How far through the playlist to query.
  405.        Return value:   An array containing the following elements:  id, url, title, author, duration, duration_type, album, and subposition (how far into this song we are at the given percent)
  406.                     </item>
  407.  
  408.                     <item name="GetUIDInfo">
  409. Returns a structure describing the playlist entry with the specified ID - Usage: playlist.GetUIDInfo(UID);
  410.        UID             The UID to query (or an array of UIDs)
  411.        Return value:   An array with the following fields:  uid, url, title, author, duration, duration_type.  If an array is passed in, the return value will be an array of these arrays.
  412.                     </item>
  413.  
  414.                     <item name="GetTokenList">
  415. Get a list of token names - which can then be passed into Sort() - Usage: playlist.GetTokenList();
  416.        Return value:   An array containing one array for each unique token name.  Each of those arrays has two elements, name and count (the number of occurences in the playlist of this token)
  417.                     </item>
  418.  
  419.                     <item name="RegisterCallback">
  420. Register for callback when a playlist event occurs. - Usage: playlist.RegisterCallback(name, script, context);
  421.        name            The name of the callback, for future reference.
  422.        script          The script to call when a playlist event occurs.
  423.        context         Optional: The object to run the script from.  Default: the playlist object
  424.                     </item>
  425.  
  426.                     <item name="UnregisterCallback">
  427. Unegister for callback. - Usage: playlist.UnregisterCallback(name, context);
  428.        name            The name of the callback to unregister.
  429.        context         Optional: The object associated with the callback.  Default: the playlist object
  430.                     </item>
  431.  
  432.                     <item name="SetIdleScan">
  433. Set the idlescan mode - Usage: playlist.SetIdleScan(mode, startnow);
  434.        mode            quick, thorough, or none.
  435.        startnow        Optional: Determines whether to start scanning immediately.  Default: true
  436.                     </item>
  437.  
  438.                     <item name="StartIdleScan">
  439. Forces the idle scan to start (in case it's not set to start immediately) - Usage: playlist.StartIdleScan();
  440.                     </item>
  441.  
  442.                     <item name="StopIdleScan">
  443. Forces the idle scan to stop - Usage: playlist.StopIdleScan();
  444.                     </item>
  445.  
  446.                     <item name="CurrentlyIdleScanning">
  447. Are we currently idle scanning? - Usage: playlist.CurrentlyIdleScanning();
  448.        Return value:   true if we are, false if we aren't.
  449.                     </item>
  450.  
  451.                     <item name="IdleScanningIsActive">
  452. Is the idle scan thread actively scanning files? - Usage: playlist.IdleScanningIsActive();
  453.        Return value:   true if we are, false if we aren't.
  454.                     </item>
  455.                 </section>
  456.  
  457.                 <section name="player">
  458.                     <item name="Play">
  459. If the player is stopped or paused, play - Usage: player.Play();
  460.        Return value:   'Playing' if we were started playing, null if we already were.
  461.                     </item>
  462.  
  463.                     <item name="WaveWrite">
  464. Similar to play, except that the audio is written to a file instead of (or including) it being played through the normal output device. If the parameter is true, then sound comes out of the output device normally as well as being written to file(s). If the parameter is false then the normal output method is totally bypassed and data is written as fast as possible to the file(s). - Usage: player.WaveWrite();
  465.        Return value:   'Writing' if this call succeeds, NULL otherwise.
  466.                     </item>
  467.  
  468.                     <item name="Stop">
  469. If the player is playing or paused, stop. - Usage: player.Stop();
  470.        Return value:   'Stopped' if we stopped, null if we were already stopped.
  471.                     </item>
  472.  
  473.                     <item name="pause">
  474. If the player is playing, pause playback. - Usage: player.pause();
  475.        Return value:   'Paused' if we paused playback, null if we were not currently playing.
  476.                     </item>
  477.  
  478.                     <item name="TogglePause">
  479. If playing, pause. If paused, play. - Usage: player.TogglePause();
  480.                     </item>
  481.  
  482.                     <item name="IsPlaying">
  483. Query whether the player is not stopped. - Usage: player.IsPlaying();
  484.        Return value:   true if it is playing, false if it isn't.
  485.                     </item>
  486.  
  487.                     <item name="IsPaused">
  488. Query whether the player is not paused. - Usage: player.IsPaused();
  489.        Return value:   true if it is paused, false if it isn't.
  490.                     </item>
  491.  
  492.                     <item name="Next">
  493. Skip to the next track in the playlist (in accordance with shuffle and what not) - Usage: player.Next();
  494.                     </item>
  495.  
  496.                     <item name="Previous">
  497. Skip to the previous track in the playlist (in accordance with shuffle and what not) - Usage: player.Previous();
  498.                     </item>
  499.  
  500.                     <item name="SeekTo">
  501. Seek to a given track in the playlist - Usage: player.SeekTo(UID, offset);
  502.        UID             The UID of the item in the playlist to skip to.
  503.        offset          Optional: How many seconds into the song to skip to.  Default: 0
  504.                     </item>
  505.  
  506.                     <item name="SeekToIndex">
  507. Seek to a given index into the playlist - Usage: player.SeekToIndex(index, offset);
  508.        index           The index of the item in the playlist to skip to.
  509.        offset          Optional: How many seconds into the song to skip to.  Default: 0
  510.                     </item>
  511.  
  512.                     <item name="SeekToTime">
  513. Seek to the specified time into the currently playing track - Usage: player.SeekToTime(time, bAccurate);
  514.        time            How many seconds into the song to skip to.
  515.        bAccurate       Optional: Use false to give a quick preview (for instance if the user is dragging a slider) and true for the final seek  Default: true
  516.                     </item>
  517.  
  518.                     <item name="Scan">
  519. Scan forward or backwards by the specified amount - Usage: player.Scan(time, bAccurate);
  520.        time            How many seconds skip. (negative means scan back)
  521.        bAccurate       Optional: Use false to give a quick preview (for instance if the user is dragging a slider) and true for the final scan  Default: true
  522.                     </item>
  523.  
  524.                     <item name="GetInfo">
  525. Get information on the current play state - Usage: player.GetInfo();
  526.        Return value:   An array containing the following fields: info (an array describing the current track, with the fields 'uid', 'url', 'title', 'author', 'duration', and 'duration_type'), 'playstate' (an array with the following fields: 'state' (may be 'stopped', 'paused', or 'playing'), 'shuffled' (true or false), 'repeat' ('off', 'one' or 'all')), 'cursongid' (the UID of the current song), 'numsongs' (the number of songs in the playlist), 'cursongindex' (the index into the playlist currently playing), and 'curplaytime' (how many seconds into the current track we are).
  527.                     </item>
  528.  
  529.                     <item name="GetPlayProgress">
  530. Query the estimated amount of time through the playlist we're at. - Usage: player.GetPlayProgress();
  531.                     </item>
  532.  
  533.                     <item name="GetShuffle">
  534. Query whether shuffle play is enabled. - Usage: player.GetShuffle();
  535.        Return value:   true if it is, false if it isn't.
  536.                     </item>
  537.  
  538.                     <item name="SetShuffle">
  539. Enable or disable shuffle play - Usage: player.SetShuffle(shuffle);
  540.        shuffle         true to enable shuffle play, false to disable
  541.                     </item>
  542.  
  543.                     <item name="ToggleShuffle">
  544. Toggle shuffle play - Usage: player.ToggleShuffle();
  545.                     </item>
  546.  
  547.                     <item name="GetRepeat">
  548. Query repeat play is status. - Usage: player.GetRepeat();
  549.        Return value:   'off', 'one', or 'all'
  550.                     </item>
  551.  
  552.                     <item name="SetRepeat">
  553. Change repeat mode - Usage: player.SetRepeat(repeat);
  554.        repeat          'off', 'one', or 'all'
  555.                     </item>
  556.  
  557.                     <item name="ToggleRepeat">
  558. Advance through repeat settings 'off', 'one', and 'all. - Usage: player.ToggleRepeat();
  559.                     </item>
  560.  
  561.                     <item name="GetVolume">
  562. Get the current playback volume - Usage: player.GetVolume();
  563.        Return value:   The volume, between 0.0 and 1.0
  564.                     </item>
  565.  
  566.                     <item name="SetVolume">
  567. Set the current playback volume. - Usage: player.SetVolume(vol);
  568.        vol             A number between 0.0 (silence) and 1.0 (pretty loud)
  569.                     </item>
  570.  
  571.                     <item name="GetPlaybackMethod">
  572. What is the current playback mode? - Usage: player.GetPlaybackMethod();
  573.        Return value:   An array with two items 'method' (one of: 'normal', 'seamless', 'crossfade', or 'unknown') and 'transitiontime' (a number of seconds)
  574.                     </item>
  575.  
  576.                     <item name="SetPlaybackMethod">
  577. Set the playback mode - Usage: player.SetPlaybackMethod(method, time);
  578.        method          'normal', 'seamless', or 'crossfade'
  579.        time            Optional: How long to spend transitioning between tracks.  Default: -1
  580.                     </item>
  581.  
  582.                     <item name="RegisterCallback">
  583. Register for callback when a player event occurs. - Usage: player.RegisterCallback(name, script, context);
  584.        name            The name of the callback to hook. Valid callbacks are: 'Playing', 'Stopping', 'Pausing', 'SongStarted','VolumeChanged', 'Seeking', 'SeekFailed', 'Seeked', 'PlayFailed', 'CurrentIDChanged', 'ShuffleChanged', 'RepeatChanged', and 'AssociatedPlaylistChanged' 
  585.        script          What to do when player events occur.
  586.        context         Optional: The object to run the script from.  Default: the player object
  587.                     </item>
  588.  
  589.                     <item name="UnregisterCallback">
  590. Unregister a previously registered callback. - Usage: player.UnregisterCallback(name, context);
  591.        name            The name of the callback to unregister.
  592.        context         Optional: The object associated with the callback.  Default: the player object
  593.                     </item>
  594.  
  595.                     <item name="GetAssociatedPlaylistName">
  596. Get the name of the playlist associated with this player - Usage: player.GetAssociatedPlaylistName();
  597.        Return value:   The name of the playlist or 'unknown' if not known.
  598.                     </item>
  599.  
  600.                     <item name="GetAssociatedPlaylist">
  601. Get the UID of the playlist associated with this player - Usage: player.GetAssociatedPlaylist();
  602.        Return value:   The UID, or if unavailabe, null
  603.                     </item>
  604.  
  605.                     <item name="SetAssociatedPlaylist">
  606. Set which playlist this player is playing from - Usage: player.SetAssociatedPlaylist(uid);
  607.        uid             The UID of the playlist to use.
  608.                     </item>
  609.  
  610.                     <item name="SendFilterMessage">
  611. Send a message to a filter that's being used to play the current track. - Usage: player.SendFilterMessage(message);
  612.        message         A filter-specific message.  If that filter is not in use, the message will be ignored.
  613.                     </item>
  614.  
  615.                     <item name="GetFileExtensions">
  616. What file extensions can this player play? - Usage: player.GetFileExtensions();
  617.        Return value:   An array of arrays, each of which has fields named: 'ext' (the extention), and 'desc' (a description)
  618.                     </item>
  619.                 </section>
  620.  
  621.                 <section name="playersetting">
  622.                     <item name="get">
  623. Get a setting by name. - Usage: playersetting.get(name);
  624.        name            The name of the setting to get.
  625.        Return value:   The value currently set, or a null string of unset.
  626.                     </item>
  627.  
  628.                     <item name="set">
  629. Set a setting by name. - Usage: playersetting.set(name, value);
  630.        name            The name of the setting to set.
  631.        value           The value to set it to.
  632.                     </item>
  633.                 </section>
  634.  
  635.                 <section name="player">
  636.                     <item name="GetTitleString">
  637. Get the title of the currently playing track. - Usage: player.GetTitleString(format, player);
  638.        format          Optional: How to format the title string.  Default: :sonique.player.DefaultTitleFormat
  639.        player          Optional: The name of the player to query.  Default: default
  640.                     </item>
  641.  
  642.                     <item name="GetTimeString">
  643. Get the time of the currently playing track. - Usage: player.GetTimeString(format, mode, player);
  644.        format          Optional: How to format the time string.  Default: :sonique.player.DefaultTimeFormat
  645.        mode            Optional: Time display mode. Options are: 'timeremaining', 'totaltime', and 'elapsed'  Default: elapsed
  646.        player          Optional: The name of the player to query.  Default: default
  647.                     </item>
  648.  
  649.                     <item name="GetTrackString">
  650. Get the number of the currently playing track. - Usage: player.GetTrackString(format, player);
  651.        format          Optional: How to format the track string.  Default: :sonique.player.DefaultTrackFormat
  652.        player          Optional: The name of the player to query.  Default: 'default'
  653.                     </item>
  654.  
  655.                     <item name="GetTotalTimeString">
  656. Get the total length of a playlist. - Usage: player.GetTotalTimeString(format, playlist);
  657.        format          Optional: How to format the time string.  Default: :sonique.player.DefaultTotalTimeFormat
  658.        playlist        Optional: The name of the playlist to query.  Default: 'default'
  659.                     </item>
  660.  
  661.                     <item name="GetTimeSeekString">
  662. Get the string to display when seeking a certain amount. - Usage: player.GetTimeSeekString(time, format);
  663.        time            The time in seconds we would be seeking.
  664.        format          Optional: How to format the time string.  Default: :sonique.player.DefaultTimeSeekFormat
  665.                     </item>
  666.  
  667.                     <item name="GetTitleSeekString">
  668. Get the string to display when seeking a specific track. - Usage: player.GetTitleSeekString(uid, format, playlist);
  669.        uid             The UID of the track we'd be seeking to.
  670.        format          Optional: How to format the time string.  Default: :sonique.player.DefaultTrackSeekFormat
  671.        playlist        Optional: The name of the playlist to query.  Default: 'default'
  672.                     </item>
  673.  
  674.                     <item name="GetTitleTimeSeekString">
  675. Get the string to display when seeking a specific track and time. - Usage: player.GetTitleTimeSeekString(uid, time, format, playlist);
  676.        uid             The UID of the track we'd be seeking to.
  677.        time            The time into the track to seek to.
  678.        format          Optional: How to format the time string.  Default: :sonique.player.DefaultTitleTimeSeekFormat
  679.        playlist        Optional: The name of the playlist to query.  Default: 'default'
  680.                     </item>
  681.  
  682.                     <item name="GetInfoString">
  683. Get a string describing the format of the current audio stream. - Usage: player.GetInfoString(format, player);
  684.        format          Optional: How to format the info string.  Default: :sonique.player.DefaultInfoFormat
  685.        player          Optional: The name of the player to query.  Default: 'default'
  686.                     </item>
  687.                 </section>
  688.  
  689.                 <section name="prefs">
  690.                     <item name="GetString">
  691. Retrieves a string from the preferences. For use with multiple nodes of the same name and location. - Usage: prefs.GetString(section, name);
  692.        section         The section containing the preferences.
  693.        name            The name of the item within the section.
  694.        Return value:   The current value of that preference.
  695.                     </item>
  696.  
  697.                     <item name="GetStringArray">
  698. Retrieves an array string values from the preferences. - Usage: prefs.GetStringArray(section, name);
  699.        section         The section containing the preferences.
  700.        name            The name of the items within the section.
  701.        Return value:   An array containing the current values of the named preferences.
  702.                     </item>
  703.  
  704.                     <item name="SetString">
  705. Set a string in the prefernces - Usage: prefs.SetString(section, name, value);
  706.        section         The section containing the preferences.
  707.        name            The name of the item within the section.
  708.        value           The value to set it to.
  709.                     </item>
  710.  
  711.                     <item name="SetStringArray">
  712. Set multiple strings in the prefernces.  For use with multiple nodes of the same name and location, - Usage: prefs.SetStringArray(section, name, values);
  713.        section         The section containing the preferences.
  714.        name            The name of the items within the section.
  715.        values          The array of values to set them to.
  716.                     </item>
  717.  
  718.                     <item name="PrepString">
  719. Set a string value in the preferences, if it doesn't already exist. - Usage: prefs.PrepString(section, name, value);
  720.        section         The section containing the preferences.
  721.        name            The name of the item within the section.
  722.        value           The value to set it to.
  723.                     </item>
  724.  
  725.                     <item name="CreateSection">
  726. Create a preferences section in which you can store data. - Usage: prefs.CreateSection(section);
  727.        section         The section containing the preferences. If this section already exists, nothing happens.
  728.                     </item>
  729.  
  730.                     <item name="DoesSectionExist">
  731. Query whether a section exists - Usage: prefs.DoesSectionExist(section);
  732.        section         The section to query for existance.
  733.        Return value:   true if it does, false if it doesn't
  734.                     </item>
  735.  
  736.                     <item name="Save">
  737. Force Sonique to write all preferences out to disk. This normally happens only on program shutdown. - Usage: prefs.Save();
  738.                     </item>
  739.                 </section>
  740.  
  741.                 <section name="sonique">
  742.                     <item name="InstallInterface">
  743. Register a skin or interface. - Usage: :sonique.InstallInterface(path);
  744.        path            The path to the interface.
  745.                     </item>
  746.  
  747.                     <item name="OpenFiles">
  748. Present the user with a file open dialog. Selected files are added to the playlist. - Usage: :sonique.OpenFiles(playlist);
  749.        playlist        Optional: The playlist to add the files to.  Default: 'default'
  750.                     </item>
  751.  
  752.                     <item name="BrowseForFolder">
  753. Present the user with a folder browser dialog. The selected folder path is returned. - Usage: :sonique.BrowseForFolder(title, path);
  754.        title           Optional: The title displayed in the browse dialogue.  Default: 'null'
  755.        path            Optional: The path that is initially selected in the browse dialogue.  Default: 'null'
  756.                     </item>
  757.  
  758.                     <item name="SavePlaylistFile">
  759. Present the user with a file save dialog, to chose where to save the playlist. - Usage: :sonique.SavePlaylistFile(playlist);
  760.        playlist        Optional: The playlist to save.  Default: 'default'
  761.                     </item>
  762.  
  763.                     <item name="LoadPlaylistFile">
  764. Present the user with a file load dialog, to chose where to load the playlist from. - Usage: :sonique.LoadPlaylistFile(playlist, append);
  765.        playlist        Optional: The playlist to save.  Default: 'default'
  766.        append          Optional: Append to the currently loaded playlist?  True means yes.  Default: false
  767.                     </item>
  768.  
  769.                     <item name="Exit">
  770. Exit Sonique 2. - Usage: :sonique.Exit();
  771.                     </item>
  772.  
  773.                     <item name="LoadSkin">
  774. Reskin the current application window. - Usage: :sonique.LoadSkin(interface);
  775.        interface       The unique name of an interface containing the skin to load.
  776.                     </item>
  777.  
  778.                     <item name="SetLanguage">
  779. Set the order of language preference. - Usage: :sonique.SetLanguage(langauges);
  780.        langauges       An array of names of languages to use, in order of descending preference. GetLanguageList() will show available languages.
  781.                     </item>
  782.  
  783.                     <item name="SetLanguageIndex">
  784. Select a single language, by index. - Usage: :sonique.SetLanguageIndex(index);
  785.        index           The index of the language to select.  GetLanguageList() will show available languages.
  786.                     </item>
  787.  
  788.                     <item name="GetLanguageList">
  789. Enumerate available languages. - Usage: :sonique.GetLanguageList();
  790.        Return value:   An array of languages that are at least partially available.
  791.                     </item>
  792.  
  793.                     <item name="Status">
  794. Set the status text bar of all windows - Usage: :sonique.Status(text, type);
  795.        text            The text to set
  796.        type            Optional: How to set it. Options include: 'fallback', 'info', 'warning', 'error'  Default: 'info'
  797.                     </item>
  798.  
  799.                     <item name="LocalStatus">
  800. Set the local status bar text - Usage: :sonique.LocalStatus(text, priority, context);
  801.        text            The text to set
  802.        priority        Optional: Options include: 'fallback', 'info', 'warning', 'error'  Default: 'info'
  803.        context         Optional: The window to set the status text of.  Default: the calling object
  804.                     </item>
  805.  
  806.                     <item name="StatusProportion">
  807. Set the status bar to a slider-like value - Usage: :sonique.StatusProportion(text, proportion, text2, priority);
  808.        text            The text to set
  809.        proportion      Optional: If set, this draws a slider on the status bar, filled according to this parameter's position between 0.0 and 1.0  Default: -1
  810.        text2           Optional: The text to display to the right of the aforementioned slider.  Default: null
  811.        priority        Optional: Options include: 'fallback', 'info', 'warning', 'error'  Default: 'info'
  812.                     </item>
  813.  
  814.                     <item name="LocalStatusProportion">
  815. Set the local status bar text - Usage: :sonique.LocalStatusProportion(text, priority, proportion, text2, context);
  816.        text            The text to set
  817.        priority        Optional: Options include: 'fallback', 'info', 'warning', 'error'  Default: 'info'
  818.        proportion      Optional: If set, this draws a slider on the status bar, filled according to this parameter's position between 0.0 and 1.0  Default: -1
  819.        text2           Optional: The text to display to the right of the aforementioned slider.  Default: null
  820.        context         Optional: The window to set the status text of.  Default: the calling object
  821.                     </item>
  822.  
  823.                     <item name="LaunchRemote">
  824. Creates a a new remote window - Usage: :sonique.LaunchRemote(interface, remote);
  825.        interface       The unique name of the interface
  826.        remote          The name of the remote
  827.                     </item>
  828.  
  829.                     <item name="LaunchAppWindow">
  830. Creates a new application window - Usage: :sonique.LaunchAppWindow(window);
  831.        window          The name of the window
  832.                     </item>
  833.  
  834.                     <item name="LaunchWindow">
  835. Launch a window - Usage: :sonique.LaunchWindow(interface, windowtype, name, createtype);
  836.        interface       The unique identifier for the interface to load the window from.
  837.        windowtype      The type of window - either a MID or a text string
  838.        name            The name of the window, in the MML
  839.        createtype      Optional: MID of the factory to create the window from  Default: null
  840.                     </item>
  841.  
  842.                     <item name="RemoveInterface">
  843. Unload an interface. - Usage: :sonique.RemoveInterface(The unique name of the interface to remove);
  844.        The unique name of the interface to remove 
  845.                     </item>
  846.  
  847.                     <item name="RemoveInterfacePackage">
  848. Unload all interfaces associated with a package - Usage: :sonique.RemoveInterfacePackage(package);
  849.        package         The path of the package.
  850.                     </item>
  851.  
  852.                     <item name="CompactMem">
  853. Compact Memory - Usage: :sonique.CompactMem();
  854.                     </item>
  855.  
  856.                     <item name="SetKnobRadialControl">
  857. Enable or disable alternat knob interface. - Usage: :sonique.SetKnobRadialControl(radial);
  858.        radial          true means knobs spin to face cursor, false up/down and left/right will spin the knob.
  859.                     </item>
  860.  
  861.                     <item name="GetKnobRadialControl">
  862. Retrieve the knob's radial control status. - Usage: :sonique.GetKnobRadialControl();
  863.        Return value:   false for up/down, left/right control, true for radial control
  864.                     </item>
  865.  
  866.                     <item name="SetKnobSensitivity">
  867. Set the knob sensitivity. - Usage: :sonique.SetKnobSensitivity(sensativity);
  868.        sensativity     500 is the installation default.  Higher means faster knobs, lower means higher precision.
  869.                     </item>
  870.  
  871.                     <item name="GetKnobSensitivy">
  872. How sensitive are the knob controls? - Usage: :sonique.GetKnobSensitivy();
  873.        Return value:   A sensitivity value.  500 is the installation default. Higher is more reactive to mouse movement.
  874.                     </item>
  875.  
  876.                     <item name="GetVersion">
  877. Get the version string of Sonique - Usage: :sonique.GetVersion();
  878.        Return value:   The version string
  879.                     </item>
  880.  
  881.                     <item name="GetBuildTime">
  882. Get the build time of this copy of Sonique. - Usage: :sonique.GetBuildTime();
  883.        Return value:   The date and time this copy of Sonique was built.
  884.                     </item>
  885.  
  886.                     <item name="EnableDithering">
  887. Enable dithering on low bit depth displays - Usage: :sonique.EnableDithering(dither);
  888.        dither          true - dither.  false - don't dither.   24 bit displays will never dither.
  889.                     </item>
  890.  
  891.                     <item name="AddFile">
  892. Add a file (or directory) to Sonique.  Audio, skins, visuals, whatever. - Usage: :sonique.AddFile(file, playlist, immediate, append);
  893.        file            The path to the file or directory to add.
  894.        playlist        Optional: The name of the playlist to add it to, if it's not a skin or something.  Default: 'default'
  895.        immediate       Optional: Play or load it immediately  Default: current settings
  896.        append          Optional: Append it to the current playlist? false means clear the playlist first.  Default: current settings
  897.                     </item>
  898.  
  899.                     <item name="Scramble">
  900. Jumbles up a string, makes it unreadable at a glance - Usage: :sonique.Scramble(string);
  901.        string          Something that makes sense.
  902.        Return value:   Something that doesn't make sense.
  903.                     </item>
  904.  
  905.                     <item name="Unscramble">
  906. Unjumbles a previously scrambled string. - Usage: :sonique.Unscramble(string);
  907.        string          Something that doesn't make sense.
  908.        Return value:   Something that makes sense
  909.                     </item>
  910.                 </section>
  911.  
  912.                 <section name="posteffects">
  913.                     <item name="Get">
  914. Get a setting parameter - Usage: posteffects.Get(group, name);
  915.        group           The name of the visual group
  916.        name            The name of the setting to retrieve
  917.        Return value:   The value of that parameter.
  918.                     </item>
  919.  
  920.                     <item name="Set">
  921. Set a setting parameter - Usage: posteffects.Set(group, name, value);
  922.        group           The name of the visual group
  923.        name            The name of the setting to set
  924.        value           The value to set
  925.                     </item>
  926.  
  927.                     <item name="SendFilterMessage">
  928. Send a filter message to the post effects enabled in a visual group. - Usage: posteffects.SendFilterMessage(group, message);
  929.        group           The name of the visual group
  930.        message         The meesage to send. That can notify post effects to reload their settings, etc.
  931.                     </item>
  932.                 </section>
  933.  
  934.                 <section name="visuals">
  935.                     <item name="GetVisualList">
  936. Get a list of the IDs of all visuals currently loaded. - Usage: visuals.GetVisualList();
  937.        Return value:   An array of IDs
  938.                     </item>
  939.  
  940.                     <item name="GetVisualInfoList">
  941. Get a list of information about all currently loaded visuals. - Usage: visuals.GetVisualInfoList();
  942.        Return value:   An array of arrays with the following fields:  'id', 'name', 'author', and 'version'
  943.                     </item>
  944.  
  945.                     <item name="GetVisualInfo">
  946. Get info about a specific visual by ID - Usage: visuals.GetVisualInfo();
  947.        Return value:   An array with the following fields:  'id', 'name', 'author', and 'version'
  948.                     </item>
  949.  
  950.                     <item name="LoadVisual">
  951. Loads a visual into the visual system - Usage: visuals.LoadVisual(path);
  952.        path            The filename of the visual to load
  953.                     </item>
  954.  
  955.                     <item name="UnloadVisual">
  956. Unload a visual from the visual system - Usage: visuals.UnloadVisual(which);
  957.        which           The id or filename of the visual to load
  958.                     </item>
  959.  
  960.                     <item name="GroupNextVisual">
  961. Tell all windows in the specified group to change to the next available visual - Usage: visuals.GroupNextVisual(group);
  962.        group           The name of the visual group
  963.                     </item>
  964.  
  965.                     <item name="GroupPrevVisual">
  966. Tell all windows in the specified group to change to the previous available visual - Usage: visuals.GroupPrevVisual(group);
  967.        group           The name of the visual group
  968.                     </item>
  969.  
  970.                     <item name="GroupSetVisual">
  971. Tell all windows in the specified group to change to a certain visual. - Usage: visuals.GroupSetVisual(group, id);
  972.        group           The name of the visual group
  973.        id              The id of the visual to change to
  974.                     </item>
  975.  
  976.                     <item name="GroupIsPostEffectEnabled">
  977. Does this visual group have a specific posteffect enabled? - Usage: visuals.GroupIsPostEffectEnabled(group, posteffect);
  978.        group           The name of the visual group
  979.        posteffect      The factory id of the post effect to query
  980.        Return value:   true if it does, false if it doesn't
  981.                     </item>
  982.  
  983.                     <item name="GroupEnablePostEffect">
  984. Enable or disable a posteffect for all windows belowing to a visual group. - Usage: visuals.GroupEnablePostEffect(group, posteffect, enable);
  985.        group           The name of the visual group
  986.        posteffect      The factory id of the post effect to enable or disable
  987.        enable          True to enable, false to disable
  988.                     </item>
  989.  
  990.                     <item name="GetPostEffectList">
  991. List the available posteffects - Usage: visuals.GetPostEffectList();
  992.        Return value:   An array of arrays with the following fields:  'name', 'description', 'factoryID'
  993.                     </item>
  994.  
  995.                     <item name="RegisterGroupChangeCallback">
  996. Register a callback for when the callback group's settings change - Usage: visuals.RegisterGroupChangeCallback(name, script, context);
  997.        name            The name of the callback
  998.        script          What to do when stuff changes
  999.        context         Optional: The object to call the script from.  Default: the visual object
  1000.                     </item>
  1001.  
  1002.                     <item name="UnregisterGroupChangeCallback">
  1003. Unregister a previously registered callback. - Usage: visuals.UnregisterGroupChangeCallback(name, context);
  1004.        name            The name of the callback
  1005.        context         Optional: The object associated with the callback.  Default: the visual object
  1006.                     </item>
  1007.                 </section>
  1008.  
  1009.                 <section name="EqualizerWindow">
  1010.                     <item name="UpdateDisplay">
  1011. Causes the equalizer control's data to be refreshed and redrawn - Usage: EqualizerWindow.UpdateDisplay();
  1012.                     </item>
  1013.  
  1014.                     <item name="UpdateBands">
  1015. Causes the equalizer control's gain data to be refreshed and redrawn - Usage: EqualizerWindow.UpdateBands();
  1016.                     </item>
  1017.                 </section>
  1018.  
  1019.                 <section name="playlistwin">
  1020.                     <item name="GetPlaylist">
  1021. Get the playlist associated with this control. - Usage: PlaylistWindow.GetPlaylist();
  1022.                     </item>
  1023.  
  1024.                     <item name="GetCurrentItem">
  1025. Get the user's current item (where the cursor is) - Usage: PlaylistWindow.GetCurrentItem();
  1026.                     </item>
  1027.  
  1028.                     <item name="GetSelection">
  1029. Get the selected items - Usage: PlaylistWindow.GetSelection();
  1030.        Return value:   An array of playlist IDs of the selected items.
  1031.                     </item>
  1032.  
  1033.                     <item name="SetcurrentItem">
  1034. Move the current item (the cursor). - Usage: PlaylistWindow.SetcurrentItem(id);
  1035.        id              The playlist id of the item to move to.
  1036.                     </item>
  1037.  
  1038.                     <item name="SetSelection">
  1039. Set the list of selected items - Usage: PlaylistWindow.SetSelection(items);
  1040.        items           An array of playlist ids to select.
  1041.                     </item>
  1042.  
  1043.                     <item name="ScrollToShowItem">
  1044. Scroll the playlist window to make the specified item visible. - Usage: PlaylistWindow.ScrollToShowItem(id);
  1045.        id              The playlist id of the item to move to.
  1046.                     </item>
  1047.  
  1048.                     <item name="ScrollToItem">
  1049. Scroll so that an item is at the top or bottom of the window. - Usage: PlaylistWindow.ScrollToItem(id, where);
  1050.        id              The playlist id of the item to move to.
  1051.        where           'top' or 'bottom'
  1052.                     </item>
  1053.                 </section>
  1054.  
  1055.                 <section name="displaywindow">
  1056.                     <item name="DisplayWindow">
  1057. Choose which window to show in the display - Usage: DisplayWindow.DisplayWindow(window);
  1058.        window          Which window to display
  1059.                     </item>
  1060.  
  1061.                     <item name="ToggleWindow">
  1062. Toggle a window in the display - Usage: DisplayWindow.ToggleWindow(window);
  1063.        window          Which window to toggle
  1064.                     </item>
  1065.  
  1066.                     <item name="History">
  1067. Jump to a relative location in the history. - Usage: DisplayWindow.History(where);
  1068.        where           0 is the current window, -1 is the previous, 1 is the next in the list
  1069.                     </item>
  1070.                 </section>
  1071.  
  1072.                 <section name="VisWin">
  1073.                     <item name="GetAssociatedPlayer">
  1074. Get the player from which this visual gets its data. - Usage: VisWin.GetAssociatedPlayer();
  1075.        Return value:   The name of the player
  1076.                     </item>
  1077.  
  1078.                     <item name="SetAssociatedPlayer">
  1079. Select a player to get data from. - Usage: VisWin.SetAssociatedPlayer(player);
  1080.        player          The name of the player to use.
  1081.                     </item>
  1082.  
  1083.                     <item name="GetVisualGroup">
  1084. Which visual group are we a memmber of - Usage: VisWin.GetVisualGroup();
  1085.        Return value:   The name of a visual group.
  1086.                     </item>
  1087.  
  1088.                     <item name="SetVisualGroup">
  1089. Which visual group should we be a member of? - Usage: VisWin.SetVisualGroup(group);
  1090.        group           The name of the visual group to join
  1091.                     </item>
  1092.  
  1093.                     <item name="NextVisual">
  1094. Go to the next visual in the list of loaded visuals. - Usage: VisWin.NextVisual();
  1095.                     </item>
  1096.  
  1097.                     <item name="PreviousVisual">
  1098. Go to the previous visual in the list of loaded visuals. - Usage: VisWin.PreviousVisual();
  1099.                     </item>
  1100.  
  1101.                     <item name="SetVisual">
  1102. Set the visual window to dispaly a specific visual. - Usage: VisWin.SetVisual(visual);
  1103.        visual          The id of the visual to display
  1104.                     </item>
  1105.  
  1106.                     <item name="GetVisual">
  1107. Which visual are we currently displaying? - Usage: VisWin.GetVisual();
  1108.        Return value:   The id of the visual
  1109.                     </item>
  1110.  
  1111.                     <item name="EnablePostEffect">
  1112. Enable or disable a posteffect. - Usage: VisWin.EnablePostEffect(posteffect, enable);
  1113.        posteffect      The factoryID of the posteffect to enable or disable.
  1114.        enable          true - enable the posteffect.  false - disable it.
  1115.                     </item>
  1116.                 </section>
  1117.  
  1118.                 <section name="FullScreenVis">
  1119.                     <item name="LaunchFullScreenVis">
  1120. Launch the specified visual in full-screen mode - Usage: FullScreenVis.LaunchFullScreenVis(vis, player, res);
  1121.        vis             The name of the visual to launch
  1122.        player          Optional: The player whose output to visualize  Default: default
  1123.        res             Optional: Resolution to run at, an array of x, y.  Default: {640,480}
  1124.                     </item>
  1125.  
  1126.                     <item name="GetDeviceList">
  1127. Get Information about installed DirectDraw devices - Usage: FullScreenVis.GetDeviceList();
  1128.        Return value:   Array of arrays containing the following fields: 'id', 'name', 'description', 'GUID'
  1129.                     </item>
  1130.  
  1131.                     <item name="SetDisplayDevice">
  1132. Set the Device to use for DirectDraw operations - Usage: FullScreenVis.SetDisplayDevice(display);
  1133.        display         The GUID of the display to use.
  1134.                     </item>
  1135.                 </section>
  1136.             </section>
  1137.         </language>
  1138.     </module>
  1139.  
  1140.     <module name="mml">
  1141.         <language name="English">
  1142.             <section name="help">
  1143.                 <section name="math">
  1144.                     <item name="Truncate">
  1145. Truncate a number. - Usage: :math.Truncate(val, precision);
  1146.        val             is the number to truncate.
  1147.        precision       determines how many digits after the decimal point should remain. Default is 0.
  1148.        Return value:   The truncated number
  1149.                     </item>
  1150.  
  1151.                     <item name="Power">
  1152. Exponentiation. - Usage: :math.Power(base, exponent);
  1153.        base            is the base for exponentiation.
  1154.        exponent        is the exponent
  1155.        Return value:   base ^ pow.
  1156.                     </item>
  1157.  
  1158.                     <item name="Log">
  1159. Logarithm. - Usage: :math.Log(base, value);
  1160.        base            is what base to take the log in.
  1161.        value           is whose logarithm is returned.
  1162.        Return value:   e, such that value = pow(base, e)
  1163.                     </item>
  1164.                 </section>
  1165.  
  1166.                 <section name="app">
  1167.                     <item name="RegisterWindowKeyScript">
  1168. Register a script to be executed when a certain key is pressed in this window - Usage: :app.RegisterWindowKeyScript(key, script, context, windowcontext);
  1169.        key             the key code to react to, e.g. "ctrl-c", "ctrl-shift-s", "pageup"
  1170.        script          the script to execute when this key is pressed
  1171.        context         Optional: the context to execute the script in  Default: none
  1172.        windowcontext   Optional: the window in which to trap this keypress  Default: window the calling script is from
  1173.        Return value:   true/false for success/failure
  1174.                     </item>
  1175.  
  1176.                     <item name="UnregisterWindowKeyScript">
  1177. Remove an script registered to a keypress by RegisterWindowKeyScript - Usage: :app.UnregisterWindowKeyScript(key, script, context, windowcontext);
  1178.        key             the key code to unregister
  1179.        script          the script which was passed to RegisterWindowKeyScript. this is needed to check that your script is currently the one still registered.
  1180.        context         Optional: the context which was passed to RegisterWindowKeyScript.  Default: none
  1181.        windowcontext   Optional: the window context which was passed to RegisterWindowKeyScript.  Default: window the calling script is from
  1182.        Return value:   true/false for success/failure
  1183.                     </item>
  1184.  
  1185.                     <item name="RegisterGlobalKeyScript">
  1186. Register a script to be executed when a certain key is pressed in any window - Usage: :app.RegisterGlobalKeyScript(key, script, context);
  1187.        key             the key code to react to, e.g. "ctrl-c", "ctrl-shift-s", "pageup"
  1188.        script          the script to execute when this key is pressed
  1189.        context         Optional: the context to execute the script in  Default: none
  1190.        Return value:   true/false for success/failure
  1191.                     </item>
  1192.  
  1193.                     <item name="UnregisterWindowKeyScript">
  1194. Remove an script registered to a keypress by RegisterGlobalKeyScript - Usage: :app.UnregisterWindowKeyScript(key, script, context);
  1195.        key             the key code to unregister
  1196.        script          the script which was passed to RegisterGlobalKeyScript. this is needed to check that your script is currently the one still registered.
  1197.        context         Optional: the context which was passed to RegisterGlobalKeyScript.  Default: none
  1198.        Return value:   true/false for success/failure
  1199.                     </item>
  1200.                 </section>
  1201.  
  1202.                 <section name="console">
  1203.                     <item name="Write">
  1204. Print a string to the console. - Usage: :console.Write(stuff, mode);
  1205.        stuff           is a value to output. If it is an array it will be displayed as text.
  1206.        mode            Optional: How to log the result.  Options are: 'debug', 'info', 'logtext', 'commandtext', 'commandresult', 'warning', and 'error'  Default: logtext
  1207.                     </item>
  1208.  
  1209.                     <item name="Echo">
  1210. Print a string to the console, with a newline at the end. - Usage: :console.Echo(stuff, mode);
  1211.        stuff           is a value to output. If it is an array it will be displayed as text.
  1212.        mode            Optional: How to log the result.  Options are: 'debug', 'info', 'logtext', 'commandtext', 'commandresult', 'warning', and 'error'  Default: logtext
  1213.                     </item>
  1214.  
  1215.                     <item name="enabledisklogging">
  1216. Turns console disk logging on or off. - Usage: :console.enabledisklogging(bEnable, This);
  1217.        bEnable         is a boolean value - true to enable, false to disable.
  1218.        This            causes the console to be logged to a file when it's on. Normally this uses"consolelog.txt".
  1219.                     </item>
  1220.                 </section>
  1221.  
  1222.                 <section name="data">
  1223.                     <item name="IsScalar">
  1224. Is this data item a string? - Usage: $data.IsScalar();
  1225.        Return value:   true, if the item is a number or string, false if it is an array.
  1226.                     </item>
  1227.  
  1228.                     <item name="IsArray">
  1229. Is the data item an array? - Usage: $data.IsArray();
  1230.        Return value:   true if the item is an array, false if it is a number or a string.
  1231.                     </item>
  1232.  
  1233.                     <item name="ArraySize">
  1234. How large is an array? - Usage: $data.ArraySize();
  1235.        Return value:   the number of elements in $MyArray.
  1236.                     </item>
  1237.  
  1238.                     <item name="IsValidIndex">
  1239. Is foo a valid array index? - Usage: $data.IsValidIndex(index);
  1240.        index           is a number or string which may or may not be a valid index into $MyArray.
  1241.        Return value:   true if $MyArray[index] would evaluate succesfully, false otherwise.
  1242.                     </item>
  1243.                 </section>
  1244.  
  1245.                 <section name="base">
  1246.                     <item name="BroadcastScript">
  1247. Broadcast a script to all children. - Usage: Object.BroadcastScript(script);
  1248.        script          is a script to be run by Object and all of its children (meaning in their contexts). All return values are ignored.
  1249.                     </item>
  1250.  
  1251.                     <item name="Funcs">
  1252. Enumerate functions. - Usage: Object.Funcs();
  1253.        Return value:   An array of the names of the functions which Object contains.
  1254.                     </item>
  1255.  
  1256.                     <item name="Help">
  1257. Retrieve help information. - Usage: Object.Help();
  1258.        Return value:   A description of Object's usage. Note that Object may be a function.
  1259.                     </item>
  1260.  
  1261.                     <item name="Children">
  1262. Enumerate children. - Usage: Object.Children();
  1263.        Return value:   An array of the names of the child objects which Object contains.
  1264.                     </item>
  1265.  
  1266.                     <item name="Members">
  1267. Enumerate members. - Usage: Object.Members();
  1268.        Return value:   An array of the names of the members (data) which Object contains.
  1269.                     </item>
  1270.  
  1271.                     <item name="All">
  1272. Enumerate everything. - Usage: Object.All();
  1273.        Return value:   An array of tne names of everything which Object contains.
  1274.                     </item>
  1275.  
  1276.                     <item name="DoesChildExist">
  1277. Does an object contain a certain child? - Usage: Object.DoesChildExist(childname);
  1278.        childname       is the name of the child which Object may or may not contain.
  1279.        Return value:   true if Object contains a child, member, or function named childname. Otherwise false.
  1280.                     </item>
  1281.  
  1282.                     <item name="Name">
  1283. Ask an object its name. - Usage: Object.Name();
  1284.        Return value:   The name of the object.
  1285.                     </item>
  1286.  
  1287.                     <item name="ObjectType">
  1288. Ask an object it's type. - Usage: Object.ObjectType();
  1289.        Return value:   The internal name of Object's type. You probably won't find this useful.
  1290.                     </item>
  1291.  
  1292.                     <item name="Version">
  1293. Ask an object it's version. - Usage: Object.Version();
  1294.        Return value:   The revision number of an object's internal implementation. Please refrain from writing Mantis Script code which relies on this function if possible.
  1295.                     </item>
  1296.                 </section>
  1297.  
  1298.                 <section name="consolewin">
  1299.                     <item name="SetMinDisplayType">
  1300. Select the minimm severity of messages that are displayed on the console. - Usage: Console.SetMinDisplayType(severity);
  1301.        severity        Options are: 'debug', 'info', 'warning', and 'error'
  1302.                     </item>
  1303.                 </section>
  1304.  
  1305.                 <section name="button">
  1306.                     <item name="GetHover">
  1307. Query a control's hover status. - Usage: Button.GetHover();
  1308.        Return value:   True, if the hover is enabled. False if hover is disabled.
  1309.                     </item>
  1310.  
  1311.                     <item name="SetHover">
  1312. Set a control's hover status. - Usage: Button.SetHover(bHoverState);
  1313.        bHoverState     True to enable mouse over hovering, false to disable it.
  1314.                     </item>
  1315.  
  1316.                     <item name="SetState">
  1317. Set a button's state. - Usage: Button.SetState(state, delayed);
  1318.        state           A number representing which state the button should transition to.
  1319.        delayed         An optional parameter. True to use normal transitions, false for instaneous results. Default is true.
  1320.                     </item>
  1321.  
  1322.                     <item name="GetState">
  1323. Retrieve a button's state. - Usage: Button.GetState();
  1324.        Return value:   The number of the state that is currently active for Button.
  1325.                     </item>
  1326.  
  1327.                     <item name="GetToggle">
  1328. Get a button's toggle state. - Usage: Button.GetToggle();
  1329.        Return value:   True if the button is in Toggle mode (that is, it automatically switches between states 0 and 1 when clicked), false otherwise.
  1330.                     </item>
  1331.  
  1332.                     <item name="SetToggle">
  1333. Set a button's toggle state. - Usage: Button.SetToggle(bToggle);
  1334.        bToggle         True if you wish the button to automatically switch between states 0 and 1 when clicked, false otherwise.
  1335.                     </item>
  1336.  
  1337.                     <item name="SetText">
  1338. Set the button's display text. - Usage: Button.SetText(string);
  1339.        string          The text to display on the button.
  1340.                     </item>
  1341.                 </section>
  1342.  
  1343.                 <section name="EditControl">
  1344.                     <item name="GetText">
  1345. Retrieve an Edit control's contents. - Usage: (null).GetText();
  1346.        Return value:   The text contents of the Edit control.
  1347.                     </item>
  1348.  
  1349.                     <item name="SetText">
  1350. Set the contents of an Edit Control. - Usage: (null).SetText(text);
  1351.        text            What to set the edit control's contents to.
  1352.                     </item>
  1353.                 </section>
  1354.  
  1355.                 <section name="language">
  1356.                     <item name="Translate">
  1357. Translate a string. - Usage: :language.Translate(key, module);
  1358.        key             The name of the string to translate - this is a series of section names, each followed by a slash and then an item name, as laid out in the language XML file.
  1359.        module          Optional: The name of the module the string belongs to.   Default: "sonique gui".
  1360.        Return value:   The translation (in the currently selected language) of the key
  1361.                     </item>
  1362.                 </section>
  1363.  
  1364.                 <section name="picker">
  1365.                     <item name="GetCurrentItem">
  1366. Get the currently selected item. - Usage: Picker.GetCurrentItem();
  1367.        Return value:   The text contents of the currently selected item.
  1368.                     </item>
  1369.  
  1370.                     <item name="GetCurrentItemIndex">
  1371. Get the index of the selected item. - Usage: Picker.GetCurrentItemIndex();
  1372.        Return value:   The numeric index of the currently selected item, 0 being the first.
  1373.                     </item>
  1374.  
  1375.                     <item name="SetCurrentItem">
  1376. Sets the selected item. - Usage: Picker.SetCurrentItem(value, Note);
  1377.        value           May be either an array or a string. If it's an array, it may have an element named 'text' the value of which is the label for the new item, and an element named"data" which is the data associated with it. If value is a string, it is used for the control's label.
  1378.        Note            that this will replace the current item with the new information.
  1379.        Return value:   "set" if success. null if failure.
  1380.                     </item>
  1381.  
  1382.                     <item name="SetCurrentItemIndex">
  1383. Selects an item by index. - Usage: Picker.SetCurrentItemIndex(index);
  1384.        index           The numeric index of the item to set, beginning with 0.
  1385.                     </item>
  1386.  
  1387.                     <item name="GetItem">
  1388. Gets the contents of an item by index. - Usage: Picker.GetItem(index, Return);
  1389.        index           The numeric index of the item to get, beginning with 0.
  1390.        Return          value An array, with an elenment named"text" containing the item's label, and, if available, an item named 'data' containing it's associated data.
  1391.                     </item>
  1392.  
  1393.                     <item name="SetItem">
  1394. Sets the contents of an item by index. - Usage: Picker.SetItem(index, value, Note);
  1395.        index           The numeric index of the item to set, beginning with 0.
  1396.        value           May be either an array or a string. If it's an array, it may have an element named 'text' the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1397.        Note            that this will replace the item previously at index with the new information.
  1398.        Return value:   "set" if success. null if failure.
  1399.                     </item>
  1400.  
  1401.                     <item name="AddItem">
  1402. Add a new item on to the end of the picker list. - Usage: Picker.AddItem(value);
  1403.        value           May be either an array or a string. If it's an array, it may have an element named"text" the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1404.        Return value:   "added" if success. null if failure.
  1405.                     </item>
  1406.  
  1407.                     <item name="InsertItem">
  1408. Insert a new item into the picker list. - Usage: Picker.InsertItem(index, value);
  1409.        index           The numeric index of the item to insert before, beginning with 0.
  1410.        value           May be either an array or a string. If it's an array, it may have an element named"text" the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1411.        Return value:   "inserted" if success, null if failure.
  1412.                     </item>
  1413.  
  1414.                     <item name="RemoveItem">
  1415. Remove an item from the picker list. - Usage: Picker.RemoveItem(index);
  1416.        index           The numeric index of the item to remove, beginning with 0.
  1417.        Return value:   "removed" if success, null if failure.
  1418.                     </item>
  1419.  
  1420.                     <item name="GetItems">
  1421. Get the contents of the picker list. - Usage: Picker.GetItems();
  1422.        Return value:   An array of the items in the picker. Each item is itself an array, containing an element named 'text', which holds the item's label, and, if avaiable, an item named 'data' containing data associated with the item.
  1423.                     </item>
  1424.  
  1425.                     <item name="SetItems">
  1426. Set the contents of the picker list. - Usage: Picker.SetItems(items);
  1427.        items           An array of items to replace the entire contents of the picker with. Each item may be either an array or a string. If it's an array, it may have an element named 'text' the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1428.        Return value:   "set" if success, null otherwise.
  1429.                     </item>
  1430.                 </section>
  1431.  
  1432.                 <section name="spinbutton">
  1433.                     <item name="GetRealPos">
  1434. Get the spinner's position, 0.0 to 1.0. - Usage: Spinner.GetRealPos();
  1435.        Return value:   A number in the range 0.0 to 1.0
  1436.                     </item>
  1437.  
  1438.                     <item name="GetIntPos">
  1439. Get the spinner's integral position. - Usage: Spinner.GetIntPos();
  1440.        Return value:   A number between the min and max integer positions
  1441.                     </item>
  1442.  
  1443.                     <item name="SetRealPos">
  1444. Set the spinner's position, 0.0 to 1.0. - Usage: Spinner.SetRealPos(pos);
  1445.        pos             A number in the range 0.0 to 1.0. 0.5 would set the Spinner to be half way between its minimum and maximum values.
  1446.                     </item>
  1447.  
  1448.                     <item name="SetIntPos">
  1449. Set the spinner's position. - Usage: Spinner.SetIntPos(pos);
  1450.        pos             A number between the spinner's minimum and maximum values.
  1451.                     </item>
  1452.  
  1453.                     <item name="GetMin">
  1454. Get the spinner's mimimum integer position. - Usage: Spinner.GetMin();
  1455.        Return value:   The minimum value that spinner can hold.
  1456.                     </item>
  1457.  
  1458.                     <item name="GetMax">
  1459. Get the spinner's maximum integer position. - Usage: Spinner.GetMax();
  1460.        Return value:   The maximum value that spinner can hold.
  1461.                     </item>
  1462.                 </section>
  1463.  
  1464.                 <section name="selectionlist">
  1465.                     <item name="GetSelectionArray">
  1466. Returns an array of the list. - Usage: List.GetSelectionArray();
  1467.        Return value:   An array of items, each of which is an array with two items, one named'name' and the other named 'selected' (which is either true or false, depending on the status of the item)
  1468.                     </item>
  1469.  
  1470.                     <item name="IsItemIndexSelected">
  1471. Returns whether the supplied index is selected or not. - Usage: List.IsItemIndexSelected(index);
  1472.        index           The index of the item whose selection state is to be queried.
  1473.        Return value:   True if the item is selected, false otherwise.
  1474.                     </item>
  1475.  
  1476.                     <item name="IsItemSelected">
  1477. Returns whether the given item is selected or not. - Usage: List.IsItemSelected(name);
  1478.        name            The name of an item in the list.
  1479.        Return value:   True if the item named name is selected, otherwise false.
  1480.                     </item>
  1481.  
  1482.                     <item name="SelectItemIndex">
  1483. Set the specified item's selected state. - Usage: List.SelectItemIndex(index, bSelect);
  1484.        index           Which item to select or deselect.
  1485.        bSelect         true to select the item, false to deselect it.
  1486.                     </item>
  1487.  
  1488.                     <item name="SelectItem">
  1489. Set the specified item's selected state. - Usage: List.SelectItem(name, bSelect);
  1490.        name            The name of the item to select or deselect.
  1491.        bSelect         true to select the item, false to deselect it.
  1492.                     </item>
  1493.  
  1494.                     <item name="GetItem">
  1495. Get the contents of an item by index. - Usage: List.GetItem(index);
  1496.        index           The index of the item to retrieve.
  1497.        Return value:   The text at that index.
  1498.                     </item>
  1499.  
  1500.                     <item name="SetItem">
  1501. Set the contents of an item by index. - Usage: List.SetItem(index, contents);
  1502.        index           The index of the item to set.
  1503.        contents        A string containing the text to be displayed in the item.
  1504.        Return value:   "set" if success, null if failure.
  1505.                     </item>
  1506.  
  1507.                     <item name="AddItem">
  1508. Add a new item on to the end of the selection list. - Usage: List.AddItem(value);
  1509.        value           May be either an array or a string. If it's an array, it may have an element named"text" the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1510.        Return value:   "added" if success. null if failure.
  1511.                     </item>
  1512.  
  1513.                     <item name="InsertItem">
  1514. Insert a new item into the selection list. - Usage: List.InsertItem(index, value);
  1515.        index           The numeric index of the item to insert before, beginning with 0.
  1516.        value           May be either an array or a string. If it's an array, it may have an element named 'text' the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1517.        Return value:   "inserted" if success, null if failure.
  1518.                     </item>
  1519.  
  1520.                     <item name="RemoveItem">
  1521. Remove an item from the selection list. - Usage: List.RemoveItem(index);
  1522.        index           The numeric index of the item to remove, beginning with 0.
  1523.        Return value:   "removed" if success, null if failure.
  1524.                     </item>
  1525.  
  1526.                     <item name="GetItems">
  1527. Get the contents of the selection list. - Usage: List.GetItems();
  1528.        Return value:   An array of the items in the selection list. Each item is itself an array, containing an element named 'text', which holds the item's label, and, if avaiable, an item named 'data' containing data associated with the item.
  1529.                     </item>
  1530.  
  1531.                     <item name="SetItems">
  1532. Set the contents of the selection list. - Usage: List.SetItems(items);
  1533.        items           An array of items to replace the entire contents of the selection list with. Each item may be either an array or a string. If it's an array, it may have an element named 'text' the value of which is the label for the new item, and an element named 'data' which is the data associated with it. If value is a string, it is used for the control's label.
  1534.        Return value:   "set" if success, null otherwise.
  1535.                     </item>
  1536.                 </section>
  1537.  
  1538.                 <section name="slider">
  1539.                     <item name="GetRealPos">
  1540. Get the slider's position, 0.0 to 1.0. - Usage: Slider.GetRealPos();
  1541.        Return value:   A number in the range 0.0 to 1.0
  1542.                     </item>
  1543.  
  1544.                     <item name="GetIntPos">
  1545. Get the slider's integral position. - Usage: Slider.GetIntPos();
  1546.        Return value:   A number between the min and max integer positions
  1547.                     </item>
  1548.  
  1549.                     <item name="SetRealPos">
  1550. Set the slider's position, 0.0 to 1.0. - Usage: Slider.SetRealPos(pos);
  1551.        pos             A number in the range 0.0 to 1.0. 0.5 would set the slider to be half way between its minimum and maximum values.
  1552.                     </item>
  1553.  
  1554.                     <item name="SetIntPos">
  1555. Set the slider's position. - Usage: Slider.SetIntPos(pos);
  1556.        pos             A number between the slider's minimum and maximum values.
  1557.                     </item>
  1558.  
  1559.                     <item name="GetMin">
  1560. Get the slider's mimimum integer position. - Usage: Slider.GetMin();
  1561.        Return value:   The minimum value that slider can hold.
  1562.                     </item>
  1563.  
  1564.                     <item name="GetMax">
  1565. Get the slider's maximum integer position. - Usage: Slider.GetMax();
  1566.        Return value:   The maximum value that Slider can hold.
  1567.                     </item>
  1568.  
  1569.                     <item name="SetMin">
  1570. Set the slider's minimum integer position. - Usage: Slider.SetMin(min);
  1571.        min             The new lower bound of the slider's range.
  1572.                     </item>
  1573.  
  1574.                     <item name="SetMax">
  1575. Set the slider's maximum integer position. - Usage: Slider.SetMax(max);
  1576.        max             The new upper bound of the slider's range.
  1577.                     </item>
  1578.                 </section>
  1579.  
  1580.                 <section name="window">
  1581.                     <item name="GetDesiredFPS">
  1582. Retrieve the desired frame rate. - Usage: Window.GetDesiredFPS();
  1583.        Return value:   The desired frame rate, in Frames Per Second.
  1584.                     </item>
  1585.  
  1586.                     <item name="GetDesiredFPS">
  1587. Retrieve the actual frame rate. - Usage: Window.GetDesiredFPS();
  1588.        Return value:   The actual frame rate, in Frames Per Second.
  1589.                     </item>
  1590.  
  1591.                     <item name="SetDesiredFPS">
  1592. Set the desired frame rate. - Usage: Window.SetDesiredFPS(rate);
  1593.        rate            The desired frame rate, in Frames Per Second.
  1594.                     </item>
  1595.  
  1596.                     <item name="GetLocation">
  1597. Retrieve the window location. - Usage: Window.GetLocation();
  1598.        Return value:   An array (x,y) containing the position of the window relative to it's parent or the desktop (if a top level window)
  1599.                     </item>
  1600.  
  1601.                     <item name="GetOffset">
  1602. Retrieve the window offset. - Usage: Window.GetOffset(component);
  1603.        component       Optional:"left","top","right", or"bottom" to select a component of the offset, or nothing for all, in an array.
  1604.        Return value:   If no component is specifies, an array (l,t,r,b) containing the offset of the window relative to it's parent or the desktop (if a top level window). If a component is specified, only that will be returned.
  1605.                     </item>
  1606.  
  1607.                     <item name="GetAlignment">
  1608. Retrieve the window alignment. - Usage: Window.GetAlignment(component);
  1609.        component       Optional:"left","top","right", or"bottom" to select a component of the alignment, or nothing for all, in an array.
  1610.        Return value:   If no component is specifies, an array (l,t,r,b) containing the alignment of the window relative to it's parent or the desktop (if a top level window). If a component is specified, only that will be returned.
  1611.                     </item>
  1612.  
  1613.                     <item name="GetSize">
  1614. Retrieve the window size. - Usage: Window.GetSize();
  1615.        Return value:   An array (x,y) containing the dimensions in pixels of the window.
  1616.                     </item>
  1617.  
  1618.                     <item name="GetVirtSize">
  1619. Retrieve the window's virtual size. - Usage: Window.GetVirtSize();
  1620.        Return value:   An array (x,y) containing the dimensions in pixels of the window's virtual area.
  1621.                     </item>
  1622.  
  1623.                     <item name="GetPan">
  1624. Retrieve the window size. - Usage: Window.GetPan();
  1625.        Return value:   An array (x,y) containing the location of the pan origin.
  1626.                     </item>
  1627.  
  1628.                     <item name="SetLocation">
  1629. Set the window location. - Usage: Window.SetLocation(pos, start, duration, tweenfunc, bRelative, bCancelOp);
  1630.        pos             An array (x,y) containing the new position of the window
  1631.        start           Optional: How many milliseconds from now to start moving.   Default: 0
  1632.        duration        Optional: How long (milliseconds) to move for.   Default: 0
  1633.        tweenfunc       Optional: How to move - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1634.        bRelative       Optional: If this is true, pos is relative to the current position. Otherwise it's relative to the parent window or (if a top level window) the desktop.   Default: false
  1635.        bCancelOp       Optional: If this is true, all other pending SetLocation operations are cancelled.   Default: true
  1636.                     </item>
  1637.  
  1638.                     <item name="SetSize">
  1639. Set the window size. - Usage: Window.SetSize(size, start, duration, tweenfunc, bRelative, bCancelOp);
  1640.        size            An array (x,y) containing the new size of the window
  1641.        start           Optional: How many milliseconds from now to start resizing.   Default: 0
  1642.        duration        Optional: How long (milliseconds) to resize for.   Default: 0
  1643.        tweenfunc       Optional: How to resize - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1644.        bRelative       Optional: If this is true, pos is relative to the current size, otherwise it's an absolute size.   Default: false
  1645.        bCancelOp       Optional: If this is true, all other pending SetSize operations are cancelled.   Default: true
  1646.                     </item>
  1647.  
  1648.                     <item name="SetPan">
  1649. Set the window pan origin. - Usage: Window.SetPan(pos, start, duration, tweenfunc, bRelative, bCancelOp);
  1650.        pos             An array (x,y) containing the new pan origin of the window
  1651.        start           Optional: How many milliseconds from now to start panning.   Default: 0
  1652.        duration        Optional: How long (milliseconds) to pan for.   Default: 0
  1653.        tweenfunc       Optional: How to move - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1654.        bRelative       Optional: If this is true, pos is relative to the current pan origin. Otherwise it's absolute.   Default: false
  1655.        bCancelOp       Optional: If this is true, all other pending SetPan operations are cancelled.   Default: true
  1656.                     </item>
  1657.  
  1658.                     <item name="SetVirtSize">
  1659. Set the window's virtual size. - Usage: Window.SetVirtSize(size, start, duration, tweenfunc, bRelative, bCancelOp);
  1660.        size            An array (x,y) containing the new virtual size of the window. This may make parts of the window not visible.
  1661.        start           Optional: How many milliseconds from now to start resizing.   Default: 0
  1662.        duration        Optional: How long (milliseconds) to resize for.   Default: 0
  1663.        tweenfunc       Optional: How to resize - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1664.        bRelative       Optional: If this is true, pos is relative to the current virtual size, otherwise it's an absolute virtual size.   Default: false
  1665.        bCancelOp       Optional: If this is true, all other pending SetVirtSize operations are cancelled.   Default: true
  1666.                     </item>
  1667.  
  1668.                     <item name="SetParent">
  1669. Set how the window is offset to its parent. - Usage: Window.SetParent(offset, start, duration, tweenfunc, bRelative);
  1670.        offset          An array (l,t,r,b) containing the new offset of the window, relative to its parent.
  1671.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1672.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1673.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1674.        bRelative       Optional: If this is true, offest is relative to the current offset. Otherwise, it's absolute.   Default: false
  1675.                     </item>
  1676.  
  1677.                     <item name="SetAlignment">
  1678. Set the window alignment relative to its parent. - Usage: Window.SetAlignment(alignment, start, duration, tweenfunc, bRelative);
  1679.        alignment       An array (l,t,r,b) containing the new alignment of the window
  1680.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1681.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1682.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1683.        bRelative       Optional: If this is true, alignment is relative to the current alignment. Otherwise it's absolute.   Default: false
  1684.                     </item>
  1685.  
  1686.                     <item name="SetOffset">
  1687. Set the window offset from it's alignment. - Usage: Window.SetOffset(alignment, start, duration, tweenfunc, bRelative);
  1688.        alignment       An array (l,t,r,b) containing the new offset of the window
  1689.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1690.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1691.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1692.        bRelative       Optional: If this is true, offset is relative to the current offset. Otherwise it's absolute.   Default: false
  1693.                     </item>
  1694.  
  1695.                     <item name="DestroyWindow">
  1696. Destroy a window. - Usage: Window.DestroyWindow(when);
  1697.        when            Optional: When, in ms from now, should we destroy it?   Default: 0
  1698.                     </item>
  1699.  
  1700.                     <item name="Enable">
  1701. Enable the window to recieve input. - Usage: Window.Enable(when);
  1702.        when            Optional: When, in ms from now, to start accepting input.   Default: 0
  1703.                     </item>
  1704.  
  1705.                     <item name="Disable">
  1706. Disable the window from recieving input. - Usage: Window.Disable(when);
  1707.        when            Optional: When, in ms from now, to stop accepting input.   Default: 0
  1708.                     </item>
  1709.  
  1710.                     <item name="Show">
  1711. Make the window visable. - Usage: Window.Show(when);
  1712.        when            Optional: When, in ms from now, should we make the window visible.   Default: 0
  1713.                     </item>
  1714.  
  1715.                     <item name="Hide">
  1716. Make the window hidden. - Usage: Window.Hide(when);
  1717.        when            Optional: When, in ms from now, should we make the window hidden.   Default: 0
  1718.                     </item>
  1719.  
  1720.                     <item name="SetZOrder">
  1721. Change the window's z order. - Usage: Window.SetZOrder(where, when);
  1722.        where           The new position of the window. This can be one of the following:"top" or"bottom" (meaning above or below all siblings) or"top-most" or"bottom-most" (meaning above or below everything)
  1723.        when            Optional: When, in ms from now, to change the window's z-order.
  1724.                     </item>
  1725.  
  1726.                     <item name="StartSize">
  1727. Start sizing the window, as though the user did so. - Usage: Window.StartSize(sizetype, mousepoint, button);
  1728.        sizetype        (string) of the set {"IH_LEFT","IH_TOPLEFT","IH_TOP","IH_TOPRIGHT","IH_RIGHT","IH_BOTTOMRIGHT","IH_BOTTOM","IH_BOTTOMLEFT" }
  1729.        mousepoint      (array) {x,y} giving pointer location to start the size.
  1730.        button          (string) of the set {"MBUTTON_LEFT","MBUTTON_MIDDLE","MBUTTON_RIGHT" }
  1731.                     </item>
  1732.  
  1733.                     <item name="StartDrag">
  1734. Start draggin the window, as though the user did so. - Usage: Window.StartDrag(dragtype, mousepoint, button);
  1735.        dragtype        (string) of the set {"IH_DRAG","IH_DRAGX","IH_DRAGY" }
  1736.        mousepoint      (array) {x,y} giving pointer location to start the drag.
  1737.        button          (string) of the set {"MBUTTON_LEFT","MBUTTON_MIDDLE","MBUTTON_RIGHT" }
  1738.                     </item>
  1739.  
  1740.                     <item name="CreateWindow">
  1741. Create a child window. - Usage: Window.CreateWindow(MMLType, MMLName, name, offset, alignment, bVisible, flags, bBelowParent, MMLFlags, CreateChildren, FactoryID);
  1742.        MMLType         Type of >window<
  1743.        MMLName         Name of >window<
  1744.        name            Name of the child
  1745.        offset          {left, top, right, bottom} - Window offset
  1746.        alignment       {left, top, right, bottom} - Window alignment
  1747.        bVisible        Optional: Boolean - should the window be immediately visible  Default: true
  1748.        flags           Optional: Extra window flags  Default: 0
  1749.        bBelowParent    Optional: Should this window be below the parent? (useful for drawers and such)  Default: false
  1750.        MMLFlags        Optional: MML Create flags  Default: 0
  1751.        CreateChildren  Optional: Create all decendants?  Default: true
  1752.        FactoryID       Optional: MID of a factory to use to create this object  Default: loads from skin
  1753.                     </item>
  1754.  
  1755.                     <item name="MinimizeWindow">
  1756. Set a window's parent's minimized state - Usage: Window.MinimizeWindow(bMinimize);
  1757.        bMinimize       Boolean - true minimizes, false restores.
  1758.                     </item>
  1759.  
  1760.                     <item name="SetAlwaysOnTop">
  1761. Set a window's Always-On-Top state - Usage: Window.SetAlwaysOnTop(bOnTop);
  1762.        bOnTop          True means parent window always on top, false means normal z-order.
  1763.                     </item>
  1764.  
  1765.                     <item name="StartIntro">
  1766. Broadcast Intro event to all children - Usage: Window.StartIntro(duration);
  1767.        duration        Optional: How long to animate for, in milliseconds.  Default: 1000, or current settings
  1768.                     </item>
  1769.  
  1770.                     <item name="StartExtro">
  1771. Broadcast Extro event to all children - Usage: Window.StartExtro(duration);
  1772.        duration        Optional: How long to animate for, in milliseconds.  Default: 1000, or current settings
  1773.                     </item>
  1774.  
  1775.                     <item name="GetAnimationDuration">
  1776. Returns the system-wide number of milliseconds that animations (i.e. intro, extro) should run for. - Usage: Window.GetAnimationDuration();
  1777.        Return value:   The time, in milliseconds, that animations should run for.
  1778.                     </item>
  1779.  
  1780.                     <item name="SetAngle">
  1781. Set the angle for a window. Angle-aware imagestyle elements will rotate  - Usage: Window.SetAngle(angle, start, duration, tweenfunc, bCancelOp);
  1782.        angle           The angle, in degrees.
  1783.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1784.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1785.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1786.        bCancelOp       Optional: Cancel other pending operations of the same type  Default: true
  1787.                     </item>
  1788.  
  1789.                     <item name="SetAnimTime">
  1790. Set the Animation time for a window. Animation time aware imagestyle elements will animate - Usage: Window.SetAnimTime(t, start, duration, tweenfunc, bCancelOp);
  1791.        t               The animation time, in milliseconds.
  1792.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1793.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1794.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1795.        bCancelOp       Optional: Cancel other pending operations of the same type  Default: true
  1796.                     </item>
  1797.  
  1798.                     <item name="SetZoom">
  1799. Set the zoom for a window. Zoom aware imagestyle elements will zoom - Usage: Window.SetZoom(magnification, start, duration, tweenfunc, bCancelOp);
  1800.        magnification   The zoom factor..
  1801.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1802.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1803.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1804.        bCancelOp       Optional: Cancel other pending operations of the same type  Default: true
  1805.                     </item>
  1806.  
  1807.                     <item name="SetOpacity">
  1808. Set the opacity for a window. - Usage: Window.SetOpacity(opacity, start, duration, tweenfunc, bCancelOp);
  1809.        opacity         The opacity, from 0 to 1.
  1810.        start           Optional: How many milliseconds from now to start changing.   Default: 0
  1811.        duration        Optional: How long (milliseconds) to change for.   Default: 0
  1812.        tweenfunc       Optional: How to change - options are linear, linear_accel, linear_decel, linear_smooth, and linear_bounce.   Default: linear
  1813.        bCancelOp       Optional: Cancel other pending operations of the same type  Default: true
  1814.                     </item>
  1815.  
  1816.                     <item name="GetAngle">
  1817. Get the current angle for a window. - Usage: Window.GetAngle();
  1818.        Return value:   The current angle, in degrees
  1819.                     </item>
  1820.  
  1821.                     <item name="GetZoom">
  1822. Get the current zoom for a window. - Usage: Window.GetZoom();
  1823.        Return value:   The current zoom factor
  1824.                     </item>
  1825.  
  1826.                     <item name="GetOpacity">
  1827. Get the current opacity for a window. - Usage: Window.GetOpacity();
  1828.        Return value:   The current opacity, in the range of 0 to 1.
  1829.                     </item>
  1830.  
  1831.                     <item name="GetAnimTime">
  1832. Get the current animation time for a window. - Usage: Window.GetAnimTime();
  1833.        Return value:   The current time into the animations, in ms
  1834.                     </item>
  1835.  
  1836.                     <item name="GetHoverHint">
  1837. Get the hover hint for a window. - Usage: Window.GetHoverHint();
  1838.        Return value:   The window's hover hint.
  1839.                     </item>
  1840.  
  1841.                     <item name="SetHoverHint">
  1842. Set the hover hint for a window. - Usage: Window.SetHoverHint(hint);
  1843.        hint            The new hover hint.  If of the format "Lang://module/key", it will be loaded out of the language file.  Otherwise, it is used directly.
  1844.                     </item>
  1845.  
  1846.                     <item name="GetMinimized">
  1847. Get the minimized state of the parent window. - Usage: Window.GetMinimized();
  1848.        Return value:   True if minimized, false if restored.
  1849.                     </item>
  1850.  
  1851.                     <item name="GetAlwaysOnTop">
  1852. Get the always-on-top state of the parent window. - Usage: Window.GetAlwaysOnTop();
  1853.        Return value:   True if always on top, false if normal.
  1854.                     </item>
  1855.  
  1856.                     <item name="PostScript">
  1857. Execute a script after all pending GUI events have completed. - Usage: Window.PostScript(script);
  1858.        script          What to execute when all pending GUI events are done.
  1859.                     </item>
  1860.                 </section>
  1861.  
  1862.                 <section name="textdisplay">
  1863.                     <item name="SetText">
  1864. Set the display text. - Usage: TextDisplay.SetText(text);
  1865.        text            The text to set it to.
  1866.                     </item>
  1867.                 </section>
  1868.  
  1869.                 <section name="timer">
  1870.                     <item name="SetTimer">
  1871. Set a timer. - Usage: timer.SetTimer(name, interval, script, context, repeat);
  1872.     This removes any other timer associated with the specified object that has the same name.
  1873.        name            The name of the timer, for furture reference
  1874.        interval        How long, in milliseconds, before the timer is triggered
  1875.        script          What to do when the timer is triggered
  1876.        context         What object to run the script in, when the timer is triggered.
  1877.        repeat          Optional: Boolean: Should the timer reset itself when it is triggered?  Default: false
  1878.                     </item>
  1879.  
  1880.                     <item name="UnsetTimer">
  1881. Remove a previously set timer. - Usage: timer.UnsetTimer(name, context);
  1882.        name            The name of the timer to remove
  1883.        context         The object the timer is associated with
  1884.                     </item>
  1885.                 </section>
  1886.             </section>
  1887.         </language>
  1888.     </module>
  1889. </translation>
  1890.