<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!DOCTYPE funcs
  SYSTEM '../../../clonk.dtd'>
<?xml-stylesheet type="text/xsl" href="../../../clonk.xsl"?>
<funcs>
  <func>
    <title>Music</title>
    <category>Music</category>
    <version>5.1 OC</version>
    <syntax>
      <rtype>int</rtype>
      <params>
        <param>
          <type>string</type>
          <name>song_name</name>
          <desc>Filename of the music track. The file extension must be specified. If unspecified, music playback will be interrupted.</desc>
          <optional />
        </param>
        <param>
          <type>bool</type>
          <name>loop</name>
          <desc>If 1, the specified track will be looped forever.</desc>
          <optional />
        </param>
      </params>
    </syntax>
    <desc>Plays a music track. The corresponding music file must be available in the active music group. If the loaded scenario contains music files, the scenario file will be the music group. Otherwise, the global file Music.ocg will be used.</desc>
    <related><funclink>SetPlayList</funclink></related>
  </func>
  <author>jwk</author><date>2002-08</date>
</funcs>
