首頁 探索 說明
登入
txlyre
/
winamp
镜像来自 https://git.lumaeris.com/mirrors/winamp
1
0
複刻 0
檔案 問題管理 0 Wiki
目錄樹: 5b91e3f697
分支列表 標籤列表
winamp
/
Src
/
Winamp
/
resource
/
atf.htm

atf.htm 56 KB
文件歷史 原始文件

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    2. 

  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
    4. 

  4. <head>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    6. 

  6. <title>Winamp - Advanced Title Formatting (ATF) Documentation</title>
    7. 

  7. <meta name="generator" content="Notepad++" />
    8. 

  8. <meta name="date" content="2007-04-27" />
    9. 

  9. <meta name="keywords" content="Advanced Title Formatting, Winamp, ATF" />
    10. 

  10. <style type="text/css">
    11. 

  11. <!--
    12. 

  12. DIV.clearer {CLEAR: both; LINE-HEIGHT: 0; HEIGHT: 0px}
    13. 

  13. DIV.no {PADDING-RIGHT: 0px; DISPLAY: inline; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px; PADDING-TOP: 0px}
    14. 

  14. EM.u {FONT-STYLE: normal; TEXT-DECORATION: underline}
    15. 

  15. p.atf {TEXT-ALIGN: left; padding: 0em; FONT-SIZE: 100%; FONT-WEIGHT: normal; FONT-STYLE: normal; WHITE-SPACE: nowrap }
    16. 

  16. DIV.atf .header {PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; PADDING-TOP: 0px; MARGIN-TOP: 10px; MARGIN-BOTTOM: 0px;}
    17. 

  17. DIV.atf .pagename {FONT-WEIGHT: bolder; FONT-SIZE: 200%; FLOAT: left; VERTICAL-ALIGN: middle; COLOR: #dee7ec; TEXT-ALIGN: left; border: solid 2px #dee7ec; PADDING-RIGHT: 5px; PADDING-LEFT: 5px; PADDING-BOTTOM: 4px; PADDING-TOP: 1px; MARGIN-LEFT: 10px; MARGIN-TOP: 0px; MARGIN-RIGHT: 0px; MARGIN-BOTTOM: 0px;}
    18. 

  18. DIV.atf .pagename A {COLOR: #436976! important; TEXT-DECORATION: none! important}
    19. 

  19. DIV.atf .logo {FONT-WEIGHT: normal; FONT-SIZE: 50%; FLOAT: right; VERTICAL-ALIGN: middle; TEXT-ALIGN: right; MARGIN-RIGHT: 15px;}
    20. 

  20. DIV.atf .logo A {COLOR: #dee7ec; LETTER-SPACING: 0pt; TEXT-DECORATION: none}
    21. 

  21. DIV.atf .bar {CLEAR: both; PADDING-RIGHT: 10px; BORDER-TOP: #8cacbb 1px solid; PADDING-LEFT: 1px; BACKGROUND: #dee7ec; PADDING-BOTTOM: 2px; PADDING-TOP: 1px; BORDER-BOTTOM: #8cacbb 1px solid; HEIGHT: 25px; MARGIN-TOP: 6px; MARGIN-BOTTOM: 5px;}
    22. 

  22. DIV.atf .bar-left {FLOAT: left;	HEIGHT: 25px;}
    23. 

  23. DIV.atf .bar-right {FLOAT: right; TEXT-ALIGN: right; HEIGHT: 25px;}
    24. 

  24. DIV.atf #bar__bottom {MARGIN-BOTTOM: 2px}
    25. 

  25. DIV.atf DIV.meta {CLEAR: both; MARGIN-TOP: 1em; FONT-SIZE: 70%; COLOR: #638c9c}
    26. 

  26. DIV.atf DIV.meta DIV.user {FLOAT: left}
    27. 

  27. DIV.atf DIV.meta DIV.doc {TEXT-ALIGN: right}
    28. 

  28. * {PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px; PADDING-TOP: 0px}
    29. 

  29. BODY {FONT: 80% "Lucida Grande",Verdana,Lucida,Helvetica,Arial,sans-serif; COLOR: #000; BACKGROUND-COLOR: #fff}
    30. 

  30. .indent {MARGIN-LEFT: 62px;	WHITE-SPACE: nowrap}
    31. 

  31. .indent2 {MARGIN-LEFT: 67px; WHITE-SPACE: nowrap}
    32. 

  32. .smaller {FONT-SIZE: 6px}
    33. 

  33. .smallest {FONT-SIZE: 2px}
    34. 

  34. DIV.atf DIV.page {MARGIN: 4px 2em 0px 1em; TEXT-ALIGN: left}
    35. 

  35. DIV.atf IMG {BORDER-TOP-WIDTH: 0px; BORDER-LEFT-WIDTH: 0px; BORDER-BOTTOM-WIDTH: 0px; BORDER-RIGHT-WIDTH: 0px}
    36. 

  36. DIV.atf P {MARGIN: 0px 0px 1em}
    37. 

  37. DIV.atf HR {BORDER-TOP: #8cacbb 1px solid; BORDER-LEFT-WIDTH: 0px; BORDER-BOTTOM-WIDTH: 0px; HEIGHT: 0px; TEXT-ALIGN: center; BORDER-RIGHT-WIDTH: 0px}
    38. 

  38. DIV.atf FORM {BORDER-STYLE: none; PADDING: 0px;}
    39. 

  39. DIV.atf DIV.toolbar {MARGIN: 2px 0px; TEXT-ALIGN: left}
    40. 

  40. DIV.atf .nowrap {WHITE-SPACE: nowrap}
    41. 

  41. .nowrap {WHITE-SPACE: nowrap}
    42. 

  42. DIV.atf INPUT.button {HEIGHT: 23px; VERTICAL-ALIGN: middle; TEXT-ALIGN: center; BORDER: #8cacbb 1px solid; PADDING-RIGHT: 4px; PADDING-LEFT: 4px; FONT-SIZE: 100%; BACKGROUND-COLOR: #fff; PADDING-BOTTOM: 2px; MARGIN-LEFT: 1px; MARGIN-TOP: 1px; MARGIN-BOTTOM: 0px; MARGIN-RIGHT: 25px; CURSOR: pointer; COLOR: #000; PADDING-TOP: 1px; TEXT-DECORATION: none;}
    43. 

  43. DIV.atf A:link {COLOR: #436976; TEXT-DECORATION: none}
    44. 

  44. DIV.atf A:visited {COLOR: #436976; TEXT-DECORATION: none}
    45. 

  45. DIV.atf A:hover {COLOR: #000; TEXT-DECORATION: underline}
    46. 

  46. DIV.atf A:active {COLOR: #000; TEXT-DECORATION: underline}
    47. 

  47. DIV.atf H1 A {COLOR: #000! important; TEXT-DECORATION: none! important}
    48. 

  48. DIV.atf H2 A {COLOR: #000! important; TEXT-DECORATION: none! important}
    49. 

  49. DIV.atf H3 A {COLOR: #000! important; TEXT-DECORATION: none! important}
    50. 

  50. DIV.atf H4 A {COLOR: #000! important; TEXT-DECORATION: none! important}
    51. 

  51. DIV.atf H5 A {COLOR: #000! important; TEXT-DECORATION: none! important}
    52. 

  52. DIV.atf A.nolink {COLOR: #000; TEXT-DECORATION: none}
    53. 

  53. DIV.atf A.urlextern:link {COLOR: #436976! important}
    54. 

  54. DIV.atf A.urlextern:visited {COLOR: #436976! important}
    55. 

  55. DIV.atf A.link1 {COLOR: #090! important}
    56. 

  56. DIV.atf A.link2 {COLOR: #f30! important}
    57. 

  57. DIV.atf SPAN.user {FONT-SIZE: 90%; COLOR: #ccc}
    58. 

  58. DIV.atf LI.minor {COLOR: #666; FONT-STYLE: italic}
    59. 

  59. DIV.atf ACRONYM {CURSOR: help; BORDER-BOTTOM: #000 1px dotted}
    60. 

  60. DIV.atf H1 {CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 10px; BORDER-BOTTOM: #8cacbb 1px solid}
    61. 

  61. DIV.atf H2 {CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; FONT-WEIGHT: normal; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 5px; BORDER-BOTTOM: #8cacbb 1px solid}
    62. 

  62. DIV.atf H3 {CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 5px; BORDER-BOTTOM: #8cacbb 1px solid}
    63. 

  63. DIV.atf H4 {CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 5px; BORDER-BOTTOM: #8cacbb 1px solid}
    64. 

  64. DIV.atf H5 {CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 5px; BORDER-BOTTOM: #8cacbb 1px solid}
    65. 

  65. DIV.atf H6 {FONT-WEIGHT: bold; FONT-SIZE: 120%; MARGIN-LEFT: 40px; BORDER-BOTTOM-STYLE: none; CLEAR: left; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; FONT-WEIGHT: normal; FONT-SIZE: 120%; PADDING-BOTTOM: 0px; MARGIN: 0px 0px 1em; COLOR: #000; PADDING-TOP: 0.5em}
    66. 

  66. DIV.atf H1 {FONT-WEIGHT: bold; FONT-SIZE: 160%; MARGIN-LEFT: 0px}
    67. 

  67. DIV.atf H2 {FONT-SIZE: 150%; MARGIN-LEFT: 20px}
    68. 

  68. DIV.atf H3 {FONT-WEIGHT: bold; FONT-SIZE: 140%; MARGIN-LEFT: 40px; BORDER-BOTTOM-STYLE: none}
    69. 

  69. DIV.atf H4 {FONT-WEIGHT: bold; FONT-SIZE: 120%; MARGIN-LEFT: 60px; BORDER-BOTTOM-STYLE: none}
    70. 

  70. DIV.atf H5 {FONT-WEIGHT: bold; FONT-SIZE: 100%; MARGIN-LEFT: 80px; BORDER-BOTTOM-STYLE: none}
    71. 

  71. DIV.atf DIV.level1 {MARGIN-LEFT: 3px}
    72. 

  72. DIV.atf DIV.level2 {MARGIN-LEFT: 23px}
    73. 

  73. DIV.atf DIV.level3 {MARGIN-LEFT: 43px}
    74. 

  74. DIV.atf DIV.level4 {MARGIN-LEFT: 63px}
    75. 

  75. DIV.atf DIV.level5 {MARGIN-LEFT: 83px}
    76. 

  76. DIV.atf UL {LIST-STYLE-IMAGE: none; MARGIN: 0px 0px 0.5em 1.5em; COLOR: #638c9c; LINE-HEIGHT: 1.5em; LIST-STYLE-TYPE: square}
    77. 

  77. DIV.atf OL {FONT-WEIGHT: bold; LIST-STYLE-IMAGE: none; MARGIN: 0px 0px 0.5em 1.5em; COLOR: #638c9c; LINE-HEIGHT: 1.5em}
    78. 

  78. DIV.atf .li {FONT-WEIGHT: normal; COLOR: #000}
    79. 

  79. DIV.atf OL {LIST-STYLE-TYPE: decimal}
    80. 

  80. DIV.atf OL OL {LIST-STYLE-TYPE: upper-roman}
    81. 

  81. DIV.atf OL OL OL {LIST-STYLE-TYPE: lower-alpha}
    82. 

  82. DIV.atf DIV.toc {CLEAR: both; FONT-SIZE: 80%; FLOAT: right; MARGIN: 1.2em 0px 0px 1.7em; WIDTH: 205px}
    83. 

  83. DIV.atf DIV.tocheader {BORDER: #8cacbb 1px solid; PADDING: 3px; FONT-WEIGHT: bold; MARGIN-BOTTOM: 2px; BACKGROUND-COLOR: #dee7ec; TEXT-ALIGN: left}
    84. 

  84. DIV.atf DIV.tocheader IMG {FLOAT: right; MARGIN: 0.3em 3px 0px 0px; WIDTH: 0.8em; CURSOR: pointer; HEIGHT: 0.8em}
    85. 

  85. DIV.atf #toc__inside {BORDER: #8cacbb 1px solid; PADDING-RIGHT: 0px; PADDING-LEFT: 0px; PADDING-BOTTOM: 0.7em; PADDING-TOP: 0.5em; BACKGROUND-COLOR: #fff; TEXT-ALIGN: left}
    86. 

  86. DIV.atf UL.toc {PADDING-LEFT: 0.3em; LIST-STYLE-IMAGE: none; MARGIN: 0px; LINE-HEIGHT: 1.2em; LIST-STYLE-TYPE: none}
    87. 

  87. DIV.atf UL.toc LI {PADDING-LEFT: 0.3em; BACKGROUND: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAFElEQVQI12OwCYpxSSph0HHzAbIAGeoDrdYV6fMAAAAASUVORK5CYII=) no-repeat 0px 0.6em}
    88. 

  88. DIV.atf UL.toc LI.clear {PADDING-LEFT: 0.4em; BACKGROUND-IMAGE: none}
    89. 

  89. DIV.atf A.toc:link {COLOR: #436976}
    90. 

  90. DIV.atf A.toc:visited {COLOR: #436976}
    91. 

  91. DIV.atf A.toc:hover {COLOR: #000}
    92. 

  92. DIV.atf A.toc:active {COLOR: #000}
    93. 

  93. -->
    94. 

  94. </style>
    95. 

  95. <!-- originally saved from http://www.myplugins.info/winamp-wiki/doku.php/advanced_title_formatting -->
    96. 

  96. <!-- original credits to Shane Hird and Ben Allison -  this document modified and edited for Winamp by DJ Egg -->
    97. 

  97. </head>
    98. 

  98. 

  99. <body>
    100. 

  100. 

  101. <div class="atf">
    102. 

  102. <a href="top" name="top"></a>
    103. 

  103. <div class="stylehead">
    104. 

  104. 

  105. <div class="header">
    106. 

  106. <div class="pagename"><a href="javascript: window.location.reload()">Advanced&nbsp;Title&nbsp;Formatting</a></div>
    107. 

  107. <div class="clearer"></div>
    108. 

  108. </div>
    109. 

  109. 

  110. <div class="bar" id="bar__top">
    111. 

  111. <div class="bar-left" id="bar__topleft"></div>
    112. 

  112. <!--<div class="langform" id="langselect">
    113. 

  113. <form name="lang" action="" method="post">
    114. 

  114. <select name="xfer" size="1" onmouseup= "location = '' + this.options[this.selectedIndex ].value;">
    115. 

  115. <option value="atf.htm" selected="selected">English</option>
    116. 

  116. <option value="atf-nl.htm">Dutch</option>
    117. 

  117. <option value="atf-fr.htm">French</option>
    118. 

  118. <option value="atf-de.htm">German</option>
    119. 

  119. <option value="atf-it.htm">Italian</option>
    120. 

  120. <option value="atf-jp.htm">Japanese</option>
    121. 

  121. <option value="atf-pl.htm">Polish</option>
    122. 

  122. <option value="atf-pt.htm">Portuguese</option>
    123. 

  123. <option value="atf-ro.htm">Romanian</option>
    124. 

  124. <option value="atf-ru.htm">Russian</option>
    125. 

  125. <option value="atf-es.htm">Spanish</option>
    126. 

  126. <option value="atf-se.htm">Swedish</option>
    127. 

  127. <option value="atf-tr.htm">Turkish</option>
    128. 

  128. </select>
    129. 

  129. </form>
    130. 

  130. </div>-->
    131. 

  131. <div class="bar-right" id="bar__topright"></div>
    132. 

  132. </div>
    133. 

  133. 

  134. </div>
    135. 

  135. 

  136. <div class="page">
    137. 

  137. <div class="toc">
    138. 

  138. <div class="tocheader" id="toc__header">Table of Contents</div>
    139. 

  139. <div id="toc__inside">
    140. 

  140. 

  141. <ul class="toc">
    142. 

  142. <li class="clear">
    143. 

  143. 

  144. <ul class="toc">
    145. 

  145. <li class="level2"><div class="li"><span class="li"><a href="#winamp_atf_reference" class="toc">Winamp ATF Reference</a></span></div>
    146. 

  146. <ul class="toc">
    147. 

  147. <li class="level3"><div class="li"><span class="li"><a href="#atf_usage" class="toc">ATF Usage</a></span></div></li>
    148. 

  148. 

  149. <li class="level3"><div class="li"><span class="li"><a href="#fields" class="toc">Fields</a></span></div>
    150. 

  150. <ul class="toc">
    151. 

  151. 

  152. <li class="level4"><div class="li"><span class="li"><a href="#provided_by_winamp" class="toc">Provided by Winamp</a></span></div>
    153. 

  153. <ul class="toc">
    154. 

  154. <li class="level5"><div class="li"><span class="li"><a href="#filename" class="toc">%filename%</a></span></div></li>
    155. 

  155. <li class="level5"><div class="li"><span class="li"><a href="#folder" class="toc">%folder%</a></span></div></li>
    156. 

  156. </ul>
    157. 

  157. </li>
    158. 

  158. 

  159. <li class="level4"><div class="li"><span class="li"><a href="#provided_by_ml" class="toc">Provided by ML</a></span></div>
    160. 

  160. <ul class="toc">
    161. 

  161. <li class="level5"><div class="li"><span class="li"><a href="#rating" class="toc">%rating%</a></span></div></li>
    162. 

  162. <li class="level5"><div class="li"><span class="li"><a href="#playcount" class="toc">%playcount%</a></span></div></li>
    163. 

  163. </ul>
    164. 

  164. </li>
    165. 

  165. 

  166. <li class="level4"><div class="li"><span class="li"><a href="#provided_by_ml_or_input_plugin" class="toc">Provided by ML or input plugin</a></span></div>
    167. 

  167. <ul class="toc">
    168. 

  168. <li class="level5"><div class="li"><span class="li"><a href="#artist" class="toc">%artist%</a></span></div></li>
    169. 

  169. <li class="level5"><div class="li"><span class="li"><a href="#title" class="toc">%title%</a></span></div></li>
    170. 

  170. <li class="level5"><div class="li"><span class="li"><a href="#album" class="toc">%album%</a></span></div></li>
    171. 

  171. <li class="level5"><div class="li"><span class="li"><a href="#year" class="toc">%year%</a></span></div></li>
    172. 

  172. <li class="level5"><div class="li"><span class="li"><a href="#genre" class="toc">%genre%</a></span></div></li>
    173. 

  173. <li class="level5"><div class="li"><span class="li"><a href="#comment" class="toc">%comment%</a></span></div></li>
    174. 

  174. <li class="level5"><div class="li"><span class="li"><a href="#tracknumber" class="toc">%tracknumber%</a></span></div></li>
    175. 

  175. <li class="level5"><div class="li"><span class="li"><a href="#bitrate" class="toc">%bitrate%</a></span></div></li>
    176. 

  176. <li class="level5"><div class="li"><span class="li"><a href="#type" class="toc">%type%</a></span></div></li>
    177. 

  177. <li class="level5"><div class="li"><span class="li"><a href="#vbr" class="toc">%vbr%</a></span></div></li>
    178. 

  178. <li class="level5"><div class="li"><span class="li"><a href="#category" class="toc">%category%</a></span></div></li>
    179. 

  179. <li class="level5"><div class="li"><span class="li"><a href="#producer" class="toc">%producer%</a></span></div></li>
    180. 

  180. <li class="level5"><div class="li"><span class="li"><a href="#director" class="toc">%director%</a></span></div></li>
    181. 

  181. </ul>
    182. 

  182. </li>
    183. 

  183. 

  184. <li class="level4"><div class="li"><span class="li"><a href="#provided_by_input_plugin" class="toc">Provided by input plugin</a></span></div>
    185. 

  185. <ul class="toc">
    186. 

  186. <li class="level5"><div class="li"><span class="li"><a href="#length" class="toc">%length%</a></span></div></li>
    187. 

  187. <li class="level5"><div class="li"><span class="li"><a href="#disc" class="toc">%disc%</a></span></div></li>
    188. 

  188. <li class="level5"><div class="li"><span class="li"><a href="#track" class="toc">%track%</a></span></div></li>
    189. 

  189. <li class="level5"><div class="li"><span class="li"><a href="#composer" class="toc">%composer%</a></span></div></li>
    190. 

  190. <li class="level5"><div class="li"><span class="li"><a href="#streamtitle" class="toc">%streamtitle%</a></span></div></li>
    191. 

  191. <li class="level5"><div class="li"><span class="li"><a href="#albumartist" class="toc">%albumartist%</a></span></div></li>
    192. 

  192. <li class="level5"><div class="li"><span class="li"><a href="#mood" class="toc">%mood%</a></span></div></li>
    193. 

  193. <li class="level5"><div class="li"><span class="li"><a href="#bpm" class="toc">%bpm%</a></span></div></li>
    194. 

  194. <li class="level5"><div class="li"><span class="li"><a href="#key" class="toc">%key%</a></span></div></li>
    195. 

  195. <li class="level5"><div class="li"><span class="li"><a href="#publisher" class="toc">%publisher%</a></span></div></li>
    196. 

  196. <li class="level5"><div class="li"><span class="li"><a href="#lyricist" class="toc">%lyricist%</a></span></div></li>
    197. 

  197. <li class="level5"><div class="li"><span class="li"><a href="#conductor" class="toc">%conductor%</a></span></div></li>
    198. 

  198. <li class="level5"><div class="li"><span class="li"><a href="#tool" class="toc">%tool%</a></span></div></li>
    199. 

  199. <li class="level5"><div class="li"><span class="li"><a href="#family" class="toc">%family%</a></span></div></li>
    200. 

  200. <li class="level5"><div class="li"><span class="li"><a href="#encoder" class="toc">%encoder%</a></span></div></li>
    201. 

  201. <li class="level5"><div class="li"><span class="li"><a href="#isrc" class="toc">%ISRC%</a></span></div></li>
    202. 

  202. <li class="level5"><div class="li"><span class="li"><a href="#replaygain_track_gain" class="toc">%replaygain_track_gain%</a></span></div></li>
    203. 

  203. <li class="level5"><div class="li"><span class="li"><a href="#replaygain_album_gain" class="toc">%replaygain_album_gain%</a></span></div></li>
    204. 

  204. <li class="level5"><div class="li"><span class="li"><a href="#replaygain_track_peak" class="toc">%replaygain_track_peak%</a></span></div></li>
    205. 

  205. <li class="level5"><div class="li"><span class="li"><a href="#replaygain_album_peak" class="toc">%replaygain_album_peak%</a></span></div></li>
    206. 

  206. <li class="level5"><div class="li"><span class="li"><a href="#gain" class="toc">%gain%</a></span></div></li>
    207. 

  207. </ul>
    208. 

  208. </li>
    209. 

  209. </ul>
    210. 

  210. </li>
    211. 

  211. 

  212. <li class="level3"><div class="li"><span class="li"><a href="#functions" class="toc">Functions</a></span></div>
    213. 

  213. <ul class="toc">
    214. 

  214. <li class="level4"><div class="li"><span class="li"><a href="#control_flow" class="toc">Control Flow</a></span></div>
    215. 

  215. <ul class="toc">
    216. 

  216. <li class="level5"><div class="li"><span class="li"><a href="#conditional_section" class="toc">[...] Conditional section</a></span></div></li>
    217. 

  217. <li class="level5"><div class="li"><span class="li"><a href="#if" class="toc">$if</a></span></div></li>
    218. 

  218. <li class="level5"><div class="li"><span class="li"><a href="#if2" class="toc">$if2</a></span></div></li>
    219. 

  219. <li class="level5"><div class="li"><span class="li"><a href="#if3" class="toc">$if3</a></span></div></li>
    220. 

  220. <li class="level5"><div class="li"><span class="li"><a href="#decode" class="toc">$decode</a></span></div></li>
    221. 

  221. <li class="level5"><div class="li"><span class="li"><a href="#ifgreater" class="toc">$ifgreater</a></span></div></li>
    222. 

  222. <li class="level5"><div class="li"><span class="li"><a href="#iflonger" class="toc">$iflonger</a></span></div></li>
    223. 

  223. <li class="level5"><div class="li"><span class="li"><a href="#ifstrequal2" class="toc">$IfStrEqual2</a></span></div></li>
    224. 

  224. <li class="level5"><div class="li"><span class="li"><a href="#ifstrequal" class="toc">$IfStrEqual</a></span></div></li>
    225. 

  225. </ul>
    226. 

  226. </li>
    227. 

  227. 

  228. <li class="level4"><div class="li"><span class="li"><a href="#logic_operations" class="toc">Logic Operations</a></span></div>
    229. 

  229. <ul class="toc">
    230. 

  230. <li class="level5"><div class="li"><span class="li"><a href="#and" class="toc">$and</a></span></div></li>
    231. 

  231. </ul>
    232. 

  232. </li>
    233. 

  233. 

  234. <li class="level4"><div class="li"><span class="li"><a href="#arithmetic_operations" class="toc">Arithmetic Operations</a></span></div>
    235. 

  235. <ul class="toc">
    236. 

  236. <li class="level5"><div class="li"><span class="li"><a href="#mod" class="toc">$mod</a></span></div></li>
    237. 

  237. <li class="level5"><div class="li"><span class="li"><a href="#div" class="toc">$div</a></span></div></li>
    238. 

  238. <li class="level5"><div class="li"><span class="li"><a href="#mul" class="toc">$mul</a></span></div></li>
    239. 

  239. <li class="level5"><div class="li"><span class="li"><a href="#muldiv" class="toc">$muldiv</a></span></div></li>
    240. 

  240. <li class="level5"><div class="li"><span class="li"><a href="#sub" class="toc">$sub</a></span></div></li>
    241. 

  241. <li class="level5"><div class="li"><span class="li"><a href="#add" class="toc">$add</a></span></div></li>
    242. 

  242. <li class="level5"><div class="li"><span class="li"><a href="#greater" class="toc">$greater</a></span></div></li>
    243. 

  243. <li class="level5"><div class="li"><span class="li"><a href="#max" class="toc">$max</a></span></div></li>
    244. 

  244. <li class="level5"><div class="li"><span class="li"><a href="#min" class="toc">$min</a></span></div></li>
    245. 

  245. </ul>
    246. 

  246. </li>
    247. 

  247. 

  248. <li class="level4"><div class="li"><span class="li"><a href="#string_operations" class="toc">String Operations</a></span></div>
    249. 

  249. <ul class="toc">
    250. 

  250. <li class="level5"><div class="li"><span class="li"><a href="#lower" class="toc">$lower</a></span></div></li>
    251. 

  251. <li class="level5"><div class="li"><span class="li"><a href="#upper" class="toc">$upper</a></span></div></li>
    252. 

  252. <li class="level5"><div class="li"><span class="li"><a href="#replace" class="toc">$replace</a></span></div></li>
    253. 

  253. <li class="level5"><div class="li"><span class="li"><a href="#left" class="toc">$left</a></span></div></li>
    254. 

  254. <li class="level5"><div class="li"><span class="li"><a href="#right" class="toc">$right</a></span></div></li>
    255. 

  255. <li class="level5"><div class="li"><span class="li"><a href="#len" class="toc">$len</a></span></div></li>
    256. 

  256. <li class="level5"><div class="li"><span class="li"><a href="#substr" class="toc">$substr</a></span></div></li>
    257. 

  257. <li class="level5"><div class="li"><span class="li"><a href="#strstr" class="toc">$strstr</a></span></div></li>
    258. 

  258. <li class="level5"><div class="li"><span class="li"><a href="#strrchr" class="toc">$strrchr</a></span></div></li>
    259. 

  259. <li class="level5"><div class="li"><span class="li"><a href="#strlchr" class="toc">$strlchr</a></span></div></li>
    260. 

  260. <li class="level5"><div class="li"><span class="li"><a href="#strchr" class="toc">$strchr</a></span></div></li>
    261. 

  261. <li class="level5"><div class="li"><span class="li"><a href="#shortest" class="toc">$shortest</a></span></div></li>
    262. 

  262. <li class="level5"><div class="li"><span class="li"><a href="#longest" class="toc">$longest</a></span></div></li>
    263. 

  263. <li class="level5"><div class="li"><span class="li"><a href="#abbr" class="toc">$abbr</a></span></div></li>
    264. 

  264. <li class="level5"><div class="li"><span class="li"><a href="#padcut" class="toc">$padcut</a></span></div></li>
    265. 

  265. <li class="level5"><div class="li"><span class="li"><a href="#cut" class="toc">$cut</a></span></div></li>
    266. 

  266. <li class="level5"><div class="li"><span class="li"><a href="#pad" class="toc">$pad</a></span></div></li>
    267. 

  267. <li class="level5"><div class="li"><span class="li"><a href="#lpad" class="toc">$lpad</a></span></div></li>
    268. 

  268. <li class="level5"><div class="li"><span class="li"><a href="#trim" class="toc">$trim</a></span></div></li>
    269. 

  269. <li class="level5"><div class="li"><span class="li"><a href="#repeat" class="toc">$repeat</a></span></div></li>
    270. 

  270. <li class="level5"><div class="li"><span class="li"><a href="#caps" class="toc">$caps</a></span></div></li>
    271. 

  271. <li class="level5"><div class="li"><span class="li"><a href="#caps2" class="toc">$caps2</a></span></div></li>
    272. 

  272. <li class="level5"><div class="li"><span class="li"><a href="#fileext" class="toc">$fileext</a></span></div></li>
    273. 

  273. <li class="level5"><div class="li"><span class="li"><a href="#filepart" class="toc">$filepart</a></span></div></li>
    274. 

  274. <li class="level5"><div class="li"><span class="li"><a href="#filename1" class="toc">$filename</a></span></div></li>
    275. 

  275. <li class="level5"><div class="li"><span class="li"><a href="#directory" class="toc">$directory</a></span></div></li>
    276. 

  276. <li class="level5"><div class="li"><span class="li"><a href="#split" class="toc">$split</a></span></div></li>
    277. 

  277. <li class="level5"><div class="li"><span class="li"><a href="#ext" class="toc">$ext</a></span></div></li>
    278. 

  278. <li class="level5"><div class="li"><span class="li"><a href="#hex" class="toc">$hex</a></span></div></li>
    279. 

  279. <li class="level5"><div class="li"><span class="li"><a href="#dec" class="toc">$dec</a></span></div></li>
    280. 

  280. <li class="level5"><div class="li"><span class="li"><a href="#num" class="toc">$num</a></span></div></li>
    281. 

  281. <li class="level5"><div class="li"><span class="li"><a href="#null" class="toc">$null</a></span></div></li>
    282. 

  282. <li class="level5"><div class="li"><span class="li"><a href="#pathlpart" class="toc">$PathLPart</a></span></div></li>
    283. 

  283. <li class="level5"><div class="li"><span class="li"><a href="#pathrpart" class="toc">$PathRPart</a></span></div></li>
    284. 

  284. <li class="level5"><div class="li"><span class="li"><a href="#pathltrim" class="toc">$PathLTrim</a></span></div></li>
    285. 

  285. <li class="level5"><div class="li"><span class="li"><a href="#pathrtrim" class="toc">$PathRTrim</a></span></div></li>
    286. 

  286. </ul>
    287. 

  287. </li>
    288. 

  288. 

  289. <li class="level4"><div class="li"><span class="li"><a href="#variables" class="toc">Variables</a></span></div>
    290. 

  290. <ul class="toc">
    291. 

  291. 

  292. <li class="level5"><div class="li"><span class="li"><a href="#puts" class="toc">$puts</a></span></div></li>
    293. 

  293. <li class="level5"><div class="li"><span class="li"><a href="#put" class="toc">$put</a></span></div></li>
    294. 

  294. <li class="level5"><div class="li"><span class="li"><a href="#get" class="toc">$get</a></span></div></li>
    295. 

  295. </ul>
    296. 

  296. </li>
    297. 

  297. <li class="level4"><div class="li"><span class="li"><a href="#system_info" class="toc">System Info</a></span></div>
    298. 

  298. <ul class="toc">
    299. 

  299. <li class="level5"><div class="li"><span class="li"><a href="#systime_second" class="toc">$systime_second</a></span></div></li>
    300. 

  300. <li class="level5"><div class="li"><span class="li"><a href="#systime_minute" class="toc">$systime_minute</a></span></div></li>
    301. 

  301. <li class="level5"><div class="li"><span class="li"><a href="#systime_hour" class="toc">$systime_hour</a></span></div></li>
    302. 

  302. <li class="level5"><div class="li"><span class="li"><a href="#systime_day" class="toc">$systime_day</a></span></div></li>
    303. 

  303. <li class="level5"><div class="li"><span class="li"><a href="#systime_month" class="toc">$systime_month</a></span></div></li>
    304. 

  304. <li class="level5"><div class="li"><span class="li"><a href="#systime_year" class="toc">$systime_year</a></span></div></li>
    305. 

  305. </ul>
    306. 

  306. </li>
    307. 

  307. <li class="level4"><div class="li"><span class="li"><a href="#others._todo" class="toc">Others. (TODO)</a></span></div></li></ul>
    308. 

  308. </li>
    309. 

  309. <li class="level3"><div class="li"><span class="li"><a href="#examples" class="toc">Examples</a></span></div>
    310. 

  310. <ul class="toc">
    311. 

  311. <li class="level4"><div class="li"><span class="li"><a href="#standard_atf" class="toc">Standard ATF syntax</a></span></div></li>
    312. 

  312. <li class="level4"><div class="li"><span class="li"><a href="#advanced_atf" class="toc">Advanced ATF syntax</a></span></div></li>
    313. 

  313. </ul>
    314. 

  314. </li>
    315. 

  315. </ul>
    316. 

  316. </li>
    317. 

  317. </ul>
    318. 

  318. </li></ul>
    319. 

  319. </div>
    320. 

  320. </div>
    321. 

  321. 

  322. <h1><a id="winamp_atf_reference" name="winamp_atf_reference">Winamp ATF Reference</a></h1>
    323. 

  323. <div class="level1">
    324. 

  324. <p>Below is an extract of the Winamp supported ATF functionality.<br/>
    325. 

  325. ATF determines how Winamp should display metadata in the Playlist window and Main window songticker.
    326. 

  326. The global ATF string can be manually edited via the 'Titles' page in the Winamp Preferences.
    327. 

  327. <span class="smallest"><br/><br/><br/></span>
    328. 

  328. The default ATF string in Winamp is:<br/><i>[%artist% - ]$if2(%title%,$filepart(%filename%)</i>
    329. 

  329. <span class="smallest"><br/><br/><br/></span>
    330. 

  330. This will be displayed as: '<i>Artist&nbsp;-&nbsp;Title</i>'
    331. 

  331. if the Artist and Title metadata fields are populated in the file tags,
    332. 

  332. otherwise it will just display the <i>filename</i> instead.</p>
    333. 

  333. </div>
    334. 

  334. 

  335. <h2><a id="atf_usage" name="atf_usage">ATF Usage</a></h2>
    336. 

  336. <div class="level2">
    337. 

  337. <p>%blah% denotes a metadata field.<br/><br/>
    338. 

  338. $blah() denotes a function call.<br/><br/>
    339. 

  339. [] means &quot;don't display unless metadata was found&quot;.</p>
    340. 

  340. <p>&#8216;&nbsp;&#8217; (single quotation marks) outputs raw text without parsing. eg.
    341. 

  341. &#8216;blah$blah%blah[]&#8217; which will output all the string and ignore the special
    342. 

  342. characters ($,%,[,]). </p></div>
    343. 

  343. 

  344. <h2><a id="fields" name="fields">Fields</a></h2>
    345. 

  345. <div class="level2">
    346. 

  346. <p>Note: Fields are defined by various components within Winamp. Some are
    347. 

  347. specific to the Media Library (%rating%, %playcount%), some are provided by
    348. 

  348. Winamp (%filename%, %folder%). In most cases, however, the input plugin provides
    349. 

  349. the fields. Some input plugins provide a greater variety of fields than others.
    350. 

  350. For example, the Windows Media plugin (in_wm, Winamp 5.12+), will provide values
    351. 

  351. for ANY field in the form %WM/*% (see the extended attributes section of
    352. 

  352. <i>View File Info</i> on any wma/wmv/asf file for examples).<br/></p></div>
    353. 

  353. 

  354. <h3><a id="provided_by_winamp" name="provided_by_winamp">Provided by Winamp</a></h3>
    355. 

  355. <div class="level3"></div>
    356. 

  356. 

  357. <h4><a id="filename" name="filename">%filename%</a></h4>
    358. 

  358. <div class="level4">
    359. 

  359. <p>Returns the full path of the file. To display the filename only, use the
    360. 

  360. <a class="link1" title="$filepart" href="#filepart">$filepart</a> function.</p></div>
    361. 

  361. 

  362. <h4><a id="folder" name="folder">%folder%</a></h4>
    363. 

  363. <div class="level4">
    364. 

  364. <p>Returns the containing folder.<br/>Winamp 5.2+ Only.</p></div>
    365. 

  365. 

  366. <h3><a id="provided_by_ml" name="provided_by_ml">Provided by ML</a></h3>
    367. 

  367. <div class="level3"></div>
    368. 

  368. 

  369. <h4><a id="rating" name="rating">%rating%</a></h4>
    370. 

  370. <div class="level4">
    371. 

  371. <p>Returns the track rating as an integer from 1 to 5, if set. To display as stars or another character,
    372. 

  372. use the <a class="link1" title="$repeat" href="#repeat">$repeat</a> function.</p>
    373. 

  373. <p>Winamp 5.2+ Only.</p></div>
    374. 

  374. 

  375. <h4><a id="playcount" name="playcount">%playcount%</a></h4>
    376. 

  376. <div class="level4">
    377. 

  377. <p>Returns the playcount (number of times track has been played), if the file is stored in the Media Library database.</p>
    378. 

  378. <p>Winamp 5.2+ Only.</p></div>
    379. 

  379. 

  380. <h3><a id="provided_by_ml_or_input_plugin"
    381. 

  381. name="provided_by_ml_or_input_plugin">Provided by ML or input plugin</a></h3>
    382. 

  382. <div class="level3">
    383. 

  383. <p>For the fields listed below, info is taken from ML only if the file is
    384. 

  384. present in the ML database and if the following option is checkmarked:<br/>
    385. 

  385. Prefs
    386. 

  386. (Ctrl+P) &gt; Media Library &gt; Local Media &gt; &#8216;Use Library title information
    387. 

  387. for Playlist Item Formatting&#8217;</p>
    388. 

  388. <p>In all other cases, the info is provided by the input plugin (if the
    389. 

  389. respective input plugin supports the field). </p>
    390. 

  390. <p>Most of these are straightforward and are taken from the standard file tags,
    391. 

  391. and therefore don't require any additional explanatory notes.</p></div>
    392. 

  392. 

  393. <h4><a id="artist" name="artist">%artist%</a></h4>
    394. 

  394. <div class="level4"><p>Returns the Artist field.</p></div>
    395. 

  395. 

  396. <h4><a id="title" name="title">%title%</a></h4>
    397. 

  397. <div class="level4"><p>Returns the Title field.</p></div>
    398. 

  398. 

  399. <h4><a id="album" name="album">%album%</a></h4>
    400. 

  400. <div class="level4"><p>Returns the Album field.</p></div>
    401. 

  401. 

  402. <h4><a id="year" name="year">%year%</a></h4>
    403. 

  403. <div class="level4"><p>Returns the Year field.</p></div>
    404. 

  404. 

  405. <h4><a id="genre" name="genre">%genre%</a></h4>
    406. 

  406. <div class="level4"><p>Returns the Genre field.</p></div>
    407. 

  407. 

  408. <h4><a id="comment" name="comment">%comment%</a></h4>
    409. 

  409. <div class="level4"><p>Returns the Comment field.</p></div>
    410. 

  410. 

  411. <h4><a id="tracknumber" name="tracknumber">%tracknumber%</a></h4>
    412. 

  412. <div class="level4"><p>Returns the TrackNumber with no padding, eg. Track 1 will be displayed as 1.<br/>
    413. 

  413. To pad with zeros, eg. 01, 02...10, 11, use the <a class="link1" title="$num" href="#num">$num</a> or <a class="link1" title="$lpad" href="#lpad">$lpad</a> function.</p></div>
    414. 

  414. 

  415. <h4><a id="track" name="track">%track%</a></h4>
    416. 

  416. <div class="level4"><p>Same as %tracknumber%</p></div>
    417. 

  417. 

  418. <h4><a id="albumartist" name="albumartist">%albumartist%</a></h4>
    419. 

  419. <div class="level4">
    420. 

  420. <p>Returns the Album Artist field.<br/>
    421. 

  421. Winamp 5.3+ Only.</p></div>
    422. 

  422. 

  423. <h4><a id="disc" name="disc">%disc%</a></h4>
    424. 

  424. <div class="level4">
    425. 

  425. <p>Returns the Disc No. tag, if available, eg. 1/2 (Disc #1 of a 2CD set).</p></div>
    426. 

  426. 

  427. <h4><a id="composer" name="composer">%composer%</a></h4>
    428. 

  428. <div class="level4"><p>Returns the Composer field.</p></div>
    429. 

  429. 

  430. <h4><a id="publisher" name="publisher">%publisher%</a></h4>
    431. 

  431. <div class="level4"><p>Returns the Publisher (Record Label) field.<br/>Winamp 5.3+ Only.</p></div>
    432. 

  432. 

  433. <h4><a id="streamtitle" name="streamtitle">%streamtitle%</a></h4>
    434. 

  434. <div class="level4"><p>Returns the Streaming Title for streams, if one exists.</p></div>
    435. 

  435. 

  436. <h4><a id="bitrate" name="bitrate">%bitrate%</a></h4>
    437. 

  437. <div class="level4"><p>Returns the Bitrate (will use average bitrate for vbr).</p></div>
    438. 

  438. 

  439. <h4><a id="length" name="length">%length%</a></h4>
    440. 

  440. <div class="level4">
    441. 

  441. <p>Returns length of the track in miliseconds. For a formatted track length,
    442. 

  442. use<br/><i>$div(%length%,60000):$num($div($mod(%length%,60000),1000),2)</i>
    443. 

  443. </p></div>
    444. 

  444. 

  445. <h4><a id="type" name="type">%type%</a></h4>
    446. 

  446. <div class="level4">
    447. 

  447. <p>Returns 1 for video, 0 for audio.<br/>Winamp 5.2+ Only.</p></div>
    448. 

  448. 

  449. <h4><a id="vbr" name="vbr">%vbr%</a></h4>
    450. 

  450. <div class="level4">
    451. 

  451. <p>Returns 1 for VBR(Variable Bitrate) audio, 0 for CBR(Constant Bitrate)
    452. 

  452. audio.</p></div>
    453. 

  453. 

  454. <h4><a id="category" name="category">%category%</a></h4>
    455. 

  455. <div class="level4"><p>Returns the Category field.<br/>Winamp 5.55+ Only.<br/></p></div>
    456. 

  456. 

  457. <h4><a id="producer" name="producer">%producer%</a></h4>
    458. 

  458. <div class="level4"><p>Returns the (record or film) Producer field.<br/>Winamp 5.57+ Only.<br/></p></div>
    459. 

  459. 

  460. <h4><a id="director" name="director">%director%</a></h4>
    461. 

  461. <div class="level4"><p>Returns the (film) Director field, mainly used for videos.<br/>Winamp 5.57+ Only.<br/></p></div>
    462. 

  462. 

  463. <h3><a id="provided_by_input_plugin" name="provided_by_input_plugin">Provided by
    464. 

  464. input plugin</a></h3>
    465. 

  465. <div class="level3">
    466. 

  466. <p>The fields listed below may not work for all file formats.</p></div>
    467. 

  467. 

  468. <h4><a id="trackartist" name="trackartist">%trackartist%</a></h4>
    469. 

  469. <div class="level4"><p>Returns the Track Artist field (equivalent to Artist), if different to Album Artist.<br/>
    470. 

  470. Winamp 5.3+ Only.</p></div>
    471. 

  471. 

  472. <h4><a id="mood" name="mood">%mood%</a></h4>
    473. 

  473. <div class="level4"><p>Returns the Mood field.<br/>Winamp 5.3+ Only.</p></div>
    474. 

  474. 

  475. <h4><a id="bpm" name="bpm">%bpm%</a></h4>
    476. 

  476. <div class="level4"><p>Returns the BPM (Beats Per Minute), if data&#47;field exists.<br/>Winamp 5.3+ Only.</p></div>
    477. 

  477. 

  478. <h4><a id="key" name="key">%key%</a></h4>
    479. 

  479. <div class="level4"><p>Returns the Key field (eg. E Minor), if it exists.<br/>Winamp 5.3+ Only.</p></div>
    480. 

  480. 

  481. <h4><a id="lyricist" name="lyricist">%lyricist%</a></h4>
    482. 

  482. <div class="level4"><p>Returns the Lyricist field.<br/>Winamp 5.3+ Only.</p></div>
    483. 

  483. 

  484. <h4><a id="conductor" name="conductor">%conductor%</a></h4>
    485. 

  485. <div class="level4"><p>Returns the Conductor field.<br/>Winamp 5.3+ Only.</p></div>
    486. 

  486. 

  487. <h4><a id="tool" name="tool">%tool%</a></h4>
    488. 

  488. <div class="level4"><p>Returns the Encoded&#47;Tool (software used to rip&#47;encode track) field, eg. Winamp 5.34.<br/>
    489. 

  489. Winamp 5.3+ Only.</p></div>
    490. 

  490. 

  491. <h4><a id="family" name="family">%family%</a></h4>
    492. 

  492. <div class="level4"><p>Returns the filetype's Family, eg. M4A returns: MPEG-4 Audio File Format<br/>Winamp 5.5+ Only.</p></div>
    493. 

  493. 

  494. <h4><a id="encoder" name="encoder">%encoder%</a></h4>
    495. 

  495. <div class="level4"><p>Returns the Encoder, eg. LAME 3.97<br/>Winamp 5.3+ Only.</p></div>
    496. 

  496. 

  497. <h4><a id="isrc" name="isrc">%ISRC%</a></h4>
    498. 

  498. <div class="level4">
    499. 

  499. <p>International Standard Recording Code, or ISO 3901 (<a class="urlextern" title="http://www.id3.org/isrc.html"
    500. 

  500. href="http://www.id3.org/isrc.html" rel="nofollow" target="_blank">Info</a>)<br/>Winamp 5.3+ Only.
    501. 

  501. </p></div>
    502. 

  502. 

  503. <h4><a id="replaygain_track_gain" name="replaygain_track_gain">%replaygain_track_gain%</a></h4>
    504. 

  504. <div class="level4"><p>Returns the ReplayGain Track Gain value (eg. -3.16 dB), if it exists.<br/>
    505. 

  505. Winamp 5.3+ Only.</p></div>
    506. 

  506. 

  507. <h4><a id="replaygain_album_gain" name="replaygain_album_gain">%replaygain_album_gain%</a></h4>
    508. 

  508. <div class="level4"><p>Returns the ReplayGain Album Gain value, if it exists.<br/>
    509. 

  509. Winamp 5.3+ Only.</p></div>
    510. 

  510. 

  511. <h4><a id="replaygain_track_peak" name="replaygain_track_peak">%replaygain_track_peak%</a></h4>
    512. 

  512. <div class="level4"><p>Returns the ReplayGain Track Peak value, if it exists.<br/>
    513. 

  513. Winamp 5.3+ Only.</p></div>
    514. 

  514. 

  515. <h4><a id="replaygain_album_peak" name="replaygain_album_peak">%replaygain_album_peak%</a></h4>
    516. 

  516. <div class="level4"><p>Returns the ReplayGain Album Peak value, if it exists.<br/>
    517. 

  517. Winamp 5.3+ Only.</p></div>
    518. 

  518. 

  519. <h4><a id="gain" name="gain">%gain%</a></h4>
    520. 

  520. <div class="level4"><p>Returns the Gain value, if it exists.<br/>Winamp 5.3+ Only.</p></div>
    521. 

  521. 

  522. <h2><a id="functions" name="functions">Functions</a></h2>
    523. 

  523. <div class="level2">
    524. 

  524. <p>Notes: Be careful about spaces after commas. <i>$if(%title%, Has A Title,
    525. 

  525. Has No Title)</i> will display<br/>&#8220;&nbsp;Has A Title&#8221; (note leading
    526. 

  526. space)<br/><b>not</b> &#8220;Has A Title&#8221;.<br/>The proper form should be
    527. 

  527. <i>$if(%title%,Has A Title,Has No Title)</i>.<br/></p></div>
    528. 

  528. 

  529. <h3><a id="control_flow" name="control_flow">Control Flow</a></h3>
    530. 

  530. <div class="level3"></div>
    531. 

  531. 

  532. <h4><a id="conditional_section" name="conditional_section">[...] Conditional
    533. 

  533. section</a></h4>
    534. 

  534. <div class="level4"></div>
    535. 

  535. 

  536. <h4><a id="if" name="if">$if</a></h4>
    537. 

  537. <div class="level4">
    538. 

  538. <p><b>Parameters:</b> <i>(a, then,
    539. 

  539. else)</i><br/><b>Returns:</b> If <i>a</i> contains at least one
    540. 

  540. valid, non-empty field, <i>then</i> is evaluated and returned, otherwise the
    541. 

  541. <i>else</i> parameter is. Note that $if(A,A,B) is equivalent to
    542. 

  542. $if2(A,B)<br/><b>Example:</b> <i>$if(%artist%,Has an artist tag,Has no
    543. 

  543. artist tag)</i></p></div>
    544. 

  544. 

  545. <h4><a id="if2" name="if2">$if2</a></h4>
    546. 

  546. <div class="level4">
    547. 

  547. <p><b>Parameters:</b> <i>(a, else)</i><br/><b>Returns:</b>
    548. 

  548. If <i>a</i> contains a valid, non-empty field, <i>a</i> is evaluated and
    549. 

  549. returned, otherwise the <i>else</i> parameter is.<br/><b>Example:</b>
    550. 

  550. <i>$if2(%album%,no-album)</i> </p></div>
    551. 

  551. 

  552. <h4><a id="if3" name="if3">$if3</a></h4>
    553. 

  553. <div class="level4">
    554. 

  554. <p><b>Parameters:</b> <i>(a1, ..., aN,
    555. 

  555. else)</i><br/><b>Returns:</b> If one of <i>a1</i>... <i>aN</i>
    556. 

  556. contains a valid, non-empty field, the value is evaluated and returned,
    557. 

  557. otherwise the <i>else</i> parameter is used.<br/><b>Example:</b>
    558. 

  558. <i>$if3(%artist%,%filename%,%album%,no field)</i></p></div>
    559. 

  559. 

  560. <h4><a id="decode" name="decode">$decode</a></h4>
    561. 

  561. <div class="level4">
    562. 

  562. <p><b>Parameters:</b> <i>(a, b1, c1, ..., bN, cN,
    563. 

  563. else)</i><br/><b>Returns:</b> <i>cN</i> or <i>else</i>. A
    564. 

  564. switch/case function, which determines which <i>bN</i> parameter is equal to
    565. 

  565. <i>a</i> and returns the corresponding <i>cN</i> parameter. If none are
    566. 

  566. matched, it returns the final parameter
    567. 

  567. <i>else</i>.<br/><b>Example:</b>
    568. 

  568. <i>$decode($fileext(%filename%),MP3,MPEG-1 Layer 3,MP4,MPEG-4 Container,Other)</i></p>
    569. 

  569. <p>Winamp 5.2+ Only.</p></div>
    570. 

  570. 

  571. <h4><a id="ifgreater" name="ifgreater">$ifgreater</a></h4>
    572. 

  572. <div class="level4">
    573. 

  573. <p><b>Parameters:</b> <i>(x1, x2, then,
    574. 

  574. else)</i><br/><b>Returns:</b> Compares the integer numbers x1 and x2,
    575. 

  575. if x1 is greater than x2, <i>then</i> is evaluated and its value returned.
    576. 

  576. Otherwise the <i>else</i> part is evaluated and its value
    577. 

  577. returned.<br/><b>Example:</b> <i>$ifgreater(%rating%,2,Highly rated
    578. 

  578. song,Not highly rated song)</i></p>
    579. 

  579. <p>Winamp 5.2+ Only.</p></div>
    580. 

  580. 

  581. <h4><a id="iflonger" name="iflonger">$iflonger</a></h4>
    582. 

  582. <div class="level4">
    583. 

  583. <p><b>Parameters:</b> <i>(a1, x1, then,
    584. 

  584. else)</i><br/><b>Returns:</b> Compares whether the length of string a1
    585. 

  585. is longer than x1 characters, if a1 is longer, the <i>then</i> part is evaluated and its value returned. Otherwise the <i>else</i> part is evaluated and its value
    586. 

  586. returned.<br/><b>Example:</b> <i>$iflonger(%title%,15,A long title,A
    587. 

  587. short title)</i></p>
    588. 

  588. <p>Winamp 5.2+ Only.</p></div>
    589. 

  589. 

  590. <h4><a id="ifstrequal2" name="ifstrequal2">$IfStrEqual2</a></h4>
    591. 

  591. <div class="level4">
    592. 

  592. <p><b>Parameters:</b> <i>(A, B, then,
    593. 

  593. else)</i><br/><b>Returns:</b> If <i>A = B</i> do <i>then</i> else
    594. 

  594. do <i>else</i><br/>
    595. 

  595. <b>Example:</b> <i>$IfStrEqual2(%year%,2007,New!:,Old:)</i><br/>
    596. 

  596. <b>Example:</b> <i>$IfStrEqual2(%type%,1,'(Video)','(Audio)')</i></p>
    597. 

  597. <p>Winamp 5.2+ Only.</p></div>
    598. 

  598. 

  599. <h4><a id="ifstrequal" name="ifstrequal">$IfStrEqual</a></h4>
    600. 

  600. <div class="level4">
    601. 

  601. <p><b>Parameters:</b> <i>(A, B,
    602. 

  602. then)</i><br/><b>Returns:</b> If <i>A = B</i> do <i>then</i> else
    603. 

  603. nothing<br/><b>Example:</b> <i>$IfStrEqual(%year%,2007,New!:)</i>
    604. 

  604. will print &#8220;New!&#8221; if the media was published in 2007.</p>
    605. 

  605. <p>Winamp 5.2+ Only.</p></div>
    606. 

  606. 

  607. <h3><a id="logic_operations" name="logic_operations">Logic Operations</a></h3>
    608. 

  608. <div class="level3"></div>
    609. 

  609. 

  610. <h4><a id="and" name="and">$and</a></h4>
    611. 

  611. <div class="level4">
    612. 

  612. <p>&#8211; Removed &#8211;<br/><b>Parameters:</b> <i>(%a%, %b%)</i> &#8211; The fields
    613. 

  613. to check if populated.<br/><b>Returns:</b> 1 if the fields %a% and %b%
    614. 

  614. are populated. An empty string if not. (?????)<br/><b>Example:</b>
    615. 

  615. <i>$if($and(%artist%,%title%),Has both artist and title,One field is
    616. 

  616. missing)</i></p>
    617. 

  617. <p>Winamp 5.2+ Only.</p></div>
    618. 

  618. 

  619. <h3><a id="arithmetic_operations" name="arithmetic_operations">Arithmetic
    620. 

  620. Operations</a></h3>
    621. 

  621. <div class="level3"></div>
    622. 

  622. 

  623. <h4><a id="mod" name="mod">$mod</a></h4>
    624. 

  624. <div class="level4">
    625. 

  625. <p><b>Parameters:</b> <i>(x1, x2)</i><br/><b>Returns:</b>
    626. 

  626. remainder of a division of <i>x1</i> by
    627. 

  627. <i>x2</i><br/><b>Example:</b> <i>$mod(21,8)</i> returns &#8220;5&#8221;. </p>
    628. 

  628. <p>Winamp 5.2+ Only.</p></div>
    629. 

  629. 

  630. <h4><a id="div" name="div">$div</a></h4>
    631. 

  631. <div class="level4">
    632. 

  632. <p><b>Parameters:</b> <i>(x1, x2)</i><br/><b>Returns:</b>
    633. 

  633. x1 / x2. Result of a division of <i>x1</i> by
    634. 

  634. <i>x2</i><br/><b>Example:</b> <i>$div(60,10)</i> </p>
    635. 

  635. <p>Winamp 5.2+ Only.</p></div>
    636. 

  636. 

  637. <h4><a id="mul" name="mul">$mul</a></h4>
    638. 

  638. <div class="level4">
    639. 

  639. <p><b>Parameters:</b> <i>(x1,x2,...,xn)</i> - List of numbers to
    640. 

  640. multiply<br/><b>Returns:</b> x1 * x2 * ... * xn. The supplied numbers
    641. 

  641. multiplied<br/><b>Example:</b> <i>$mul(7,8,3,4)</i> </p>
    642. 

  642. <p>Winamp 5.2+ Only.</p></div>
    643. 

  643. 

  644. <h4><a id="muldiv" name="muldiv">$muldiv</a></h4>
    645. 

  645. <div class="level4">
    646. 

  646. <p><b>Parameters:</b> <i>(x1, x2,
    647. 

  647. x3)</i><br/><b>Returns:</b> x1 * x2 / 3. <i>x1</i> multiplied by
    648. 

  648. <i>x2</i>, divided by <i>x3</i>. Result is rounded to nearest
    649. 

  649. integer.<br/><b>Example:</b> <i>$muldiv(10,6,3)</i> returns &#8220;20&#8221;.
    650. 

  650. </p>
    651. 

  651. <p>Winamp 5.2+ Only.</p></div>
    652. 

  652. 

  653. <h4><a id="sub" name="sub">$sub</a></h4>
    654. 

  654. <div class="level4">
    655. 

  655. <p><b>Parameters:</b> <i>(x1,x2,...,xn)</i> - List of numbers to
    656. 

  656. subtract<br/><b>Returns:</b> x1 - x2 - ... - xn. The result of x2...xn
    657. 

  657. subtracted from x1.<br/><b>Example:</b> <i>$sub(25,1,3,2,3)</i> </p>
    658. 

  658. <p>Winamp 5.2+ Only.</p></div>
    659. 

  659. 

  660. <h4><a id="add" name="add">$add</a></h4>
    661. 

  661. <div class="level4">
    662. 

  662. <p><b>Parameters:</b> <i>(x1,x2,...,xn)</i> - List of numbers to
    663. 

  663. add<br/><b>Returns:</b> x1 + x2 +...+ xn. The addition of all the
    664. 

  664. numbers supplied<br/><b>Example:</b>
    665. 

  665. <i>$add(2,3,%playcount%,%rating%)</i> </p>
    666. 

  666. <p>Winamp 5.2+ Only.</p></div>
    667. 

  667. 

  668. <h4><a id="greater" name="greater">$greater</a></h4>
    669. 

  669. <div class="level4">
    670. 

  670. <p><b>Parameters:</b> <i>(x1, x2)</i> - Two numbers to
    671. 

  671. compare<br/><b>Returns:</b> 1 if <i>x1</i> is greater than
    672. 

  672. <i>x2</i>, otherwise nothing. Similar in use to
    673. 

  673. $ifgreater()<br/><b>Example:</b> <i>$greater(3,2)</i> &#8211; note does not
    674. 

  674. appear to work within a $if() function. </p>
    675. 

  675. <p>Winamp 5.2+ Only.</p></div>
    676. 

  676. 

  677. <h4><a id="max" name="max">$max</a></h4>
    678. 

  678. <div class="level4">
    679. 

  679. <p><b>Parameters:</b> <i>(x1,...,xn)</i> - List of numbers to
    680. 

  680. compare<br/><b>Returns:</b> The largest number in the arguments
    681. 

  681. supplied<br/><b>Example:</b> <i>$max(7,8,3,4)</i> </p>
    682. 

  682. <p>Winamp 5.2+ Only.</p></div>
    683. 

  683. 

  684. <h4><a id="min" name="min">$min</a></h4>
    685. 

  685. <div class="level4">
    686. 

  686. <p><b>Parameters:</b> <i>(x1,...,xn)</i> - List of numbers to
    687. 

  687. compare<br/><b>Returns:</b> The smallest number in the arguments
    688. 

  688. supplied<br/><b>Example:</b> <i>$min(7,8,3,4)</i> </p>
    689. 

  689. <p>Winamp 5.2+ Only.</p></div>
    690. 

  690. 

  691. <h3><a id="string_operations" name="string_operations">String Operations</a></h3>
    692. 

  692. <div class="level3"></div>
    693. 

  693. 

  694. <h4><a id="lower" name="lower">$lower</a></h4>
    695. 

  695. <div class="level4">
    696. 

  696. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> lower
    697. 

  697. case of <i>a1</i><br/><b>Example:</b> <i>$lower(%title%)</i>
    698. 

  698. </p></div>
    699. 

  699. 

  700. <h4><a id="upper" name="upper">$upper</a></h4>
    701. 

  701. <div class="level4">
    702. 

  702. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> upper
    703. 

  703. case of <i>a1</i><br/><b>Example:</b> <i>$upper(%title%)</i>
    704. 

  704. </p></div>
    705. 

  705. 

  706. <h4><a id="replace" name="replace">$replace</a></h4>
    707. 

  707. <div class="level4">
    708. 

  708. <p><b>Parameters:</b> <i>(a1, a2,
    709. 

  709. a3)</i><br/><b>Returns:</b> <i>a1</i> with all occurences of
    710. 

  710. <i>a2</i> replaced by <i>a3</i><br/><b>Example:</b>
    711. 

  711. <i>$replace(dum,u,o)</i> writes &#8220;dom&#8221;. </p>
    712. 

  712. <p>Winamp 5.2+ Only.</p></div>
    713. 

  713. 

  714. <h4><a id="left" name="left">$left</a></h4>
    715. 

  715. <div class="level4">
    716. 

  716. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    717. 

  717. the first <i>x1</i> characters of <i>a1</i><br/><b>Example:</b>
    718. 

  718. <i>$left(%title%)</i> </p>
    719. 

  719. <p>Winamp 5.2+ Only.</p></div>
    720. 

  720. 

  721. <h4><a id="right" name="right">$right</a></h4>
    722. 

  722. <div class="level4">
    723. 

  723. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    724. 

  724. the last <i>x1</i> characters of <i>a1</i><br/><b>Example:</b>
    725. 

  725. <i>$right(%title%)</i> </p>
    726. 

  726. <p>Winamp 5.2+ Only.</p></div>
    727. 

  727. 

  728. <h4><a id="len" name="len">$len</a></h4>
    729. 

  729. <div class="level4">
    730. 

  730. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> the
    731. 

  731. number of characters of <i>a1</i><br/><b>Example:</b>
    732. 

  732. <i>$len(%artist%)</i> </p>
    733. 

  733. <p>Winamp 5.2+ Only.</p></div>
    734. 

  734. 

  735. <h4><a id="substr" name="substr">$substr</a></h4>
    736. 

  736. <div class="level4">
    737. 

  737. <p><b>Parameters:</b> TODO: <i>(a1,
    738. 

  738. a2)</i><br/><b>Returns:</b> TODO:
    739. 

  739. <i>a1</i><br/><b>Example:</b> TODO: <i>$substr()</i> </p>
    740. 

  740. <p>Winamp 5.2+ Only.</p></div>
    741. 

  741. 

  742. <h4><a id="strstr" name="strstr">$strstr</a></h4>
    743. 

  743. <div class="level4">
    744. 

  744. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    745. 

  745. index of first occurence of string <i>a2</i> in
    746. 

  746. <i>a1</i><br/><b>Example:</b> <i>$strstr(aacbbabb,ab)</i> returns
    747. 

  747. &#8220;6&#8221;. </p>
    748. 

  748. <p>Winamp 5.2+ Only.</p></div>
    749. 

  749. 

  750. <h4><a id="strrchr" name="strrchr">$strrchr</a></h4>
    751. 

  751. <div class="level4">
    752. 

  752. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    753. 

  753. index of last occurence of character <i>a2</i> in
    754. 

  754. <i>a1</i><br/><b>Example:</b> <i>$strrchr(aacbbabb,a)</i> returns
    755. 

  755. &#8220;6&#8221;. </p>
    756. 

  756. <p>Winamp 5.2+ Only.</p></div>
    757. 

  757. 

  758. <h4><a id="strlchr" name="strlchr">$strlchr</a></h4>
    759. 

  759. <div class="level4">
    760. 

  760. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    761. 

  761. index of first occurence of character <i>a2</i> in
    762. 

  762. <i>a1</i><br/><b>Example:</b> <i>$strlchr(aacbbabb,a)</i> returns
    763. 

  763. &#8220;1&#8221;. </p>
    764. 

  764. <p>Winamp 5.2+ Only.</p></div>
    765. 

  765. 

  766. <h4><a id="strchr" name="strchr">$strchr</a></h4>
    767. 

  767. <div class="level4">
    768. 

  768. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    769. 

  769. index of first occurence of character <i>a2</i> in
    770. 

  770. <i>a1</i><br/><b>Example:</b> <i>$strchr(aacbbabb,a)</i> returns
    771. 

  771. &#8220;1&#8221; (same as <i>$strlchr()</i> ??). </p>
    772. 

  772. <p>Winamp 5.2+ Only.</p></div>
    773. 

  773. 

  774. <h4><a id="shortest" name="shortest">$shortest</a></h4>
    775. 

  775. <div class="level4">
    776. 

  776. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    777. 

  777. <i>a1</i> or <i>a2</i> based on which has the shorter
    778. 

  778. length.<br/><b>Example:</b> <i>$shortest(%album%,%folder%)</i>
    779. 

  779. </p></div>
    780. 

  780. 

  781. <h4><a id="longest" name="longest">$longest</a></h4>
    782. 

  782. <div class="level4">
    783. 

  783. <p><b>Parameters:</b> <i>(a1, a2)</i><br/><b>Returns:</b>
    784. 

  784. <i>a1</i> or <i>a2</i> based on which has the greater
    785. 

  785. length.<br/><b>Example:</b> <i>$longest(%album%,%folder%)</i>
    786. 

  786. </p></div>
    787. 

  787. 

  788. <h4><a id="abbr" name="abbr">$abbr</a></h4>
    789. 

  789. <div class="level4">
    790. 

  790. <p><b>Parameters:</b> <i>(a1, x1)</i><br/>
    791. 

  791. <b>Returns:</b> <i>a1</i> abbreviated.<br/>
    792. 

  792. <b>Examples:</b> <i>$abbr(%album%)</i> converts Album name of eg. &#8220;Final Fantasy VI&#8221; to &#8220;FFVI&#8221;.<br/>
    793. 

  793. <i>$abbr(Advanced Title Formatting,10)</i> writes &#8220;ATF&#8221;.<br/>
    794. 

  794. <i>$abbr(%album%,10)</i> writes abbreviated Album name, only if longer than 10 char's.<br/>
    795. 

  795. <i>x1</i> is optional. If defined,
    796. 

  796. <i>a1</i> will only be abbreviated when its length exceeds <i>x1</i> char's.</p></div>
    797. 

  797. 

  798. <h4><a id="padcut" name="padcut">$padcut</a></h4>
    799. 

  799. <div class="level4">
    800. 

  800. <p><b>Parameters:</b> <i>(a1, x2)</i><br/><b>Returns:</b>
    801. 

  801. <i>a1</i> padded with spaces or cut off, resulting in a string of <i>x2</i>
    802. 

  802. characters<br/><b>Example:</b> <i>$padcut(%artist%,15)</i> </p></div>
    803. 

  803. 

  804. <h4><a id="cut" name="cut">$cut</a></h4>
    805. 

  805. <div class="level4">
    806. 

  806. <p><b>Parameters:</b> <i>(a1, x2)</i><br/><b>Returns:</b>
    807. 

  807. <i>a1</i>, cut off after the <i>x2</i>th
    808. 

  808. character<br/><b>Example:</b> <i>$cut(%comment%,15)</i> writes the first 15 characters of the Comment field.</p></div>
    809. 

  809. 

  810. <h4><a id="pad" name="pad">$pad</a></h4>
    811. 

  811. <div class="level4">
    812. 

  812. <p><b>Parameters:</b> <i>(string, num,
    813. 

  813. padstr)</i><br/><b>Returns:</b> <i>string</i> padded to at least
    814. 

  814. <i>num</i> chars, with spaces by default, or specify a character (or repeating
    815. 

  815. string) as <i>padstr</i>.<br/><b>Example:</b>
    816. 

  816. <i>$pad(%artist%,40)</i>, or <i>$pad(%artist%,40,.)</i> to pad with periods.
    817. 

  817. </p></div>
    818. 

  818. 

  819. <h4><a id="lpad" name="lpad">$lpad</a></h4>
    820. 

  820. <div class="level4">
    821. 

  821. <p><b>Parameters:</b> <i>(string, num,
    822. 

  822. padstr)</i><br/><b>Returns:</b> <i>string</i> padded to at least
    823. 

  823. <i>num</i> chars on the left, with spaces by default, or specify a character
    824. 

  824. (or repeating string) as <i>padstr</i>.<br/><b>Example:</b>
    825. 

  825. <i>$lpad(%tracknumber%,3)</i>, or <i>$lpad(%tracknumber%,3,0)</i> to pad
    826. 

  826. zeros in front. </p>
    827. 

  827. <p>Winamp 5.2+ Only.</p></div>
    828. 

  828. 

  829. <h4><a id="trim" name="trim">$trim</a></h4>
    830. 

  830. <div class="level4">
    831. 

  831. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b>
    832. 

  832. <i>a1</i> without any leading or trailing spaces<br/><b>Example:</b>
    833. 

  833. <i>$trim(%artist%)</i> </p>
    834. 

  834. <p>Winamp 5.2+ Only.</p></div>
    835. 

  835. 

  836. <h4><a id="repeat" name="repeat">$repeat</a></h4>
    837. 

  837. <div class="level4">
    838. 

  838. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    839. 

  839. <i>a1</i> repeated <i>x1</i> times.<br/><b>Example:</b>
    840. 

  840. <i>$repeat(*,%rating%)</i> </p>
    841. 

  841. <p>($fill() performed this function in Winamp 5.2 and was removed after 5.21.)
    842. 

  842. </p></div>
    843. 

  843. 

  844. <h4><a id="caps" name="caps">$caps</a></h4>
    845. 

  845. <div class="level4">
    846. 

  846. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> lower
    847. 

  847. case of <i>a1</i>, with first letter of each word in upper
    848. 

  848. case<br/><b>Example:</b> <i>$caps(%artist%)</i> </p></div>
    849. 

  849. 

  850. <h4><a id="caps2" name="caps2">$caps2</a></h4>
    851. 

  851. <div class="level4">
    852. 

  852. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b>
    853. 

  853. <i>a1</i>, with first letter of each word in upper
    854. 

  854. case<br/><b>Example:</b> <i>$caps2(%artist%)</i> </p></div>
    855. 

  855. 

  856. <h4><a id="fileext" name="fileext">$fileext</a></h4>
    857. 

  857. <div class="level4">
    858. 

  858. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> file
    859. 

  859. extension of <i>a1</i><br/><b>Example:</b>
    860. 

  860. <i>$fileext(%filename%)</i> </p></div>
    861. 

  861. 

  862. <h4><a id="filepart" name="filepart">$filepart</a></h4>
    863. 

  863. <div class="level4">
    864. 

  864. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b>
    865. 

  865. filename of <i>a1</i> (i.e. without the leading
    866. 

  866. path)<br/><b>Example:</b> <i>$filepart(%filename%)</i> </p></div>
    867. 

  867. 

  868. <h4><a id="filename1" name="filename1">$filename</a></h4>
    869. 

  869. <div class="level4">
    870. 

  870. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b>
    871. 

  871. filename of <i>a1</i> (i.e. without the leading
    872. 

  872. path)<br/><b>Example:</b> <i>$filename(%filename%)</i> </p></div>
    873. 

  873. 

  874. <h4><a id="directory" name="directory">$directory</a></h4>
    875. 

  875. <div class="level4">
    876. 

  876. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    877. 

  877. directory name of <i>a1</i>, after going up by <i>x1</i>
    878. 

  878. levels<br/><b>Example:</b> <i>$directory(%filename%,2)</i><br/>The
    879. 

  879. above example will output &#8220;Music&#8221; if the full path of the file is
    880. 

  880. &#8220;C:\Music\Artist - Album\Song.mp3&#8221;. <i>x1</i> is optional, default is 1. </p>
    881. 

  881. <p>Winamp 5.2+ Only. </p></div>
    882. 

  882. 

  883. <h4><a id="split" name="split">$split</a></h4>
    884. 

  884. <div class="level4">
    885. 

  885. <p><b>Parameters:</b> <i>(a, token, which)</i><br/><b>Returns:</b> Splitting of disc and&#47;or track strings, eg. to show &quot;1&quot; instead of &quot;1&#47;11&quot;
    886. 

  886. <br/><b>Example:</b> <i>[$num(%track%,2)$IfStrNotEqual($split(%track%,/,1),,/$num($split(%track%,/,1),2))]</i>
    887. 

  887. </p>
    888. 

  888. <p>Winamp 5.5+ Only.</p></div>
    889. 

  889. 

  890. <h4><a id="ext" name="ext">$ext</a></h4>
    891. 

  891. <div class="level4">
    892. 

  892. <p><b>Parameters:</b> <i>(a1)</i><br/><b>Returns:</b> file
    893. 

  893. extension of <i>a1</i><br/><b>Example:</b> <i>$ext(%filename%)</i>
    894. 

  894. </p>
    895. 

  895. <p>Winamp 5.2+ Only.</p></div>
    896. 

  896. 

  897. <h4><a id="hex" name="hex">$hex</a></h4>
    898. 

  898. <div class="level4">
    899. 

  899. <p><b>Parameters:</b> <i>(x1, x2)</i><br/><b>Returns:</b>
    900. 

  900. <i>x1</i> formatted as hexidecimal to <i>x2</i> number of digits, padded to
    901. 

  901. the left with zeros.<br/><b>Example:</b> <i>$hex(%tracknumber%,4)</i>
    902. 

  902. </p>
    903. 

  903. <p>Winamp 5.2+ Only.</p></div>
    904. 

  904. 

  905. <h4><a id="dec" name="dec">$dec</a></h4>
    906. 

  906. <div class="level4">
    907. 

  907. <p><b>Parameters:</b> <i>(x1, x2)</i><br/><b>Returns:</b>
    908. 

  908. <i>x1</i> zero padded to the left to form a <i>x2</i> digit
    909. 

  909. number.<br/><b>Example:</b> <i>$dec(%tracknumber%,5)</i> </p>
    910. 

  910. <p>Winamp 5.2+ Only.</p></div>
    911. 

  911. 

  912. <h4><a id="num" name="num">$num</a></h4>
    913. 

  913. <div class="level4">
    914. 

  914. <p><b>Parameters:</b> <i>(x1, x2)</i><br/><b>Returns:</b>
    915. 

  915. <i>x1</i> zero padded to the left to form a <i>x2</i> digit
    916. 

  916. number.<br/><b>Example:</b> <i>$num(%tracknumber%,5)</i><br/></p>
    917. 

  917. <p>Winamp 5.2+ Only.</p></div>
    918. 

  918. 

  919. <h4><a id="null" name="null">$null</a></h4>
    920. 

  920. <div class="level4">
    921. 

  921. <p><b>Parameters:</b> Any number of
    922. 

  922. parameters<br/><b>Returns:</b> Nothing<br/><b>Example:</b>
    923. 

  923. <i>$null()</i><br/>Does absolutely nothing. It is useful mainly in places where
    924. 

  924. a parameter is required, but you want an empty string. </p>
    925. 

  925. <p>Winamp 5.2+ Only.</p></div>
    926. 

  926. 

  927. <h4><a id="pathlpart" name="pathlpart">$PathLPart</a></h4>
    928. 

  928. <div class="level4">
    929. 

  929. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    930. 

  930. The first <i>x1</i> levels of <i>a1</i><br/><b>Example:</b>
    931. 

  931. <i>$PathLPart(%filename%,2)</i><br/>The above example will output &#8220;C:\Music&#8221; if
    932. 

  932. the full path of the file is &#8220;C:\Music\Sonic Youth - Daydream Nation\01 - Teen
    933. 

  933. Age Riot.mp3&#8221;.<br/></p>
    934. 

  934. <p>Winamp 5.3+ Only.</p></div>
    935. 

  935. 

  936. <h4><a id="pathrpart" name="pathrpart">$PathRPart</a></h4>
    937. 

  937. <div class="level4">
    938. 

  938. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    939. 

  939. The last <i>x1</i> levels of <i>a1</i><br/><b>Example:</b>
    940. 

  940. <i>$PathRPart(%filename%,2)</i><br/>The above example will output &#8220;Sonic Youth
    941. 

  941. - Daydream Nation\01 - Teen Age Riot.mp3&#8221; if the full path of the file is
    942. 

  942. &#8220;C:\Music\Sonic Youth - Daydream Nation\01 - Teen Age Riot.mp3&#8221;.<br/></p>
    943. 

  943. <p>Winamp 5.3+ Only.</p></div>
    944. 

  944. 

  945. <h4><a id="pathltrim" name="pathltrim">$PathLTrim</a></h4>
    946. 

  946. <div class="level4">
    947. 

  947. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    948. 

  948. <i>a1</i> minus the first <i>x1</i> levels of
    949. 

  949. <i>a1</i><br/><b>Example:</b>
    950. 

  950. <i>$PathLTrim(%filename%,1)</i><br/>The above example will output &#8220;Music\Sonic
    951. 

  951. Youth - Daydream Nation\01 - Teen Age Riot.mp3&#8221; if the full path of the file is
    952. 

  952. &#8220;C:\Music\Sonic Youth - Daydream Nation\01 - Teen Age Riot.mp3&#8221;.<br/></p>
    953. 

  953. <p>Winamp 5.3+ Only.</p></div>
    954. 

  954. 

  955. <h4><a id="pathrtrim" name="pathrtrim">$PathRTrim</a></h4>
    956. 

  956. <div class="level4">
    957. 

  957. <p><b>Parameters:</b> <i>(a1, x1)</i><br/><b>Returns:</b>
    958. 

  958. <i>a1</i> minus the last <i>x1</i> levels of
    959. 

  959. <i>a1</i><br/><b>Example:</b>
    960. 

  960. <i>$PathRTrim(%filename%,1)</i><br/>The above example will output
    961. 

  961. &#8220;C:\Music\Sonic Youth - Daydream Nation&#8221; if the full path of the file is
    962. 

  962. &#8220;C:\Music\Sonic Youth - Daydream Nation\01 - Teen Age Riot.mp3&#8221;.<br/></p>
    963. 

  963. <p>Winamp 5.3+ Only.</p></div>
    964. 

  964. 

  965. <h3><a id="variables" name="variables">Variables</a></h3>
    966. 

  966. <div class="level3"></div>
    967. 

  967. 

  968. <h4><a id="puts" name="puts">$puts</a></h4>
    969. 

  969. <div class="level4">
    970. 

  970. <p><b>Parameters:</b> <i>(name,
    971. 

  971. value)</i><br/><b>Returns:</b> Stores <i>value</i> to the named
    972. 

  972. variable <i>name</i>. It may be later retrieved using $get(<i>name</i>). Use
    973. 

  973. $put() to store a value and also return the value with the one
    974. 

  974. function.<br/><b>Example:</b> <i>$puts(artist_title,%artist% -
    975. 

  975. %title%)</i> </p>
    976. 

  976. <p>Winamp 5.2+ Only.</p></div>
    977. 

  977. 

  978. <h4><a id="put" name="put">$put</a></h4>
    979. 

  979. <div class="level4">
    980. 

  980. <p><b>Parameters:</b> <i>(name,
    981. 

  981. value)</i><br/><b>Returns:</b> <i>value</i>. Stores <i>value</i>
    982. 

  982. to the named variable <i>name</i>. It may be later retrieved using
    983. 

  983. $get(<i>name</i>). Use $puts() to store a value without returning
    984. 

  984. it.<br/><b>Example:</b> <i>$put(artist_title,%artist% - %title%)</i>
    985. 

  985. </p>
    986. 

  986. <p>Winamp 5.2+ Only.</p></div>
    987. 

  987. 

  988. <h4><a id="get" name="get">$get</a></h4>
    989. 

  989. <div class="level4">
    990. 

  990. <p><b>Parameters:</b> <i>(name)</i><br/><b>Returns:</b>
    991. 

  991. <i>value</i> of <i>name</i> variable previously set by a $put() or $puts()
    992. 

  992. function<br/><b>Example:</b> <i>$get(artist_title)</i> </p>
    993. 

  993. <p>Winamp 5.2+ Only.</p></div>
    994. 

  994. 

  995. <h3><a id="system_info" name="system_info">System Info</a></h3>
    996. 

  996. <div class="level3"></div>
    997. 

  997. 

  998. <h4><a id="systime_second" name="systime_second">$systime_second</a></h4>
    999. 

  999. <div class="level4">
    1000. 

  1000. <p><b>Parameters:</b> TODO: <i>(a1,
    1001. 

  1001. a2)</i><br/><b>Returns:</b> TODO:
    1002. 

  1002. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_second()</i> </p>
    1003. 

  1003. <p>Winamp 5.2+ Only.</p></div>
    1004. 

  1004. 

  1005. <h4><a id="systime_minute" name="systime_minute">$systime_minute</a></h4>
    1006. 

  1006. <div class="level4">
    1007. 

  1007. <p><b>Parameters:</b> TODO: <i>(a1,
    1008. 

  1008. a2)</i><br/><b>Returns:</b> TODO:
    1009. 

  1009. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_minute()</i> </p>
    1010. 

  1010. <p>Winamp 5.2+ Only.</p></div>
    1011. 

  1011. 

  1012. <h4><a id="systime_hour" name="systime_hour">$systime_hour</a></h4>
    1013. 

  1013. <div class="level4">
    1014. 

  1014. <p><b>Parameters:</b> TODO: <i>(a1,
    1015. 

  1015. a2)</i><br/><b>Returns:</b> TODO:
    1016. 

  1016. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_hour()</i> </p>
    1017. 

  1017. <p>Winamp 5.2+ Only.</p></div>
    1018. 

  1018. 

  1019. <h4><a id="systime_day" name="systime_day">$systime_day</a></h4>
    1020. 

  1020. <div class="level4">
    1021. 

  1021. <p><b>Parameters:</b> TODO: <i>(a1,
    1022. 

  1022. a2)</i><br/><b>Returns:</b> TODO:
    1023. 

  1023. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_day()</i> </p>
    1024. 

  1024. <p>Winamp 5.2+ Only.</p></div>
    1025. 

  1025. 

  1026. <h4><a id="systime_month" name="systime_month">$systime_month</a></h4>
    1027. 

  1027. <div class="level4">
    1028. 

  1028. <p><b>Parameters:</b> TODO: <i>(a1,
    1029. 

  1029. a2)</i><br/><b>Returns:</b> TODO:
    1030. 

  1030. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_month()</i> </p>
    1031. 

  1031. <p>Winamp 5.2+ Only.</p></div>
    1032. 

  1032. 

  1033. <h4><a id="systime_year" name="systime_year">$systime_year</a></h4>
    1034. 

  1034. <div class="level4">
    1035. 

  1035. <p><b>Parameters:</b> TODO: <i>(a1,
    1036. 

  1036. a2)</i><br/><b>Returns:</b> TODO:
    1037. 

  1037. <i>a1</i><br/><b>Example:</b> TODO: <i>$systime_year()</i> </p>
    1038. 

  1038. <p>Winamp 5.2+ Only.</p></div>
    1039. 

  1039. 

  1040. <h3><a id="others._todo" name="others._todo">Others. (TODO)</a></h3>
    1041. 

  1041. <div class="level4">
    1042. 

  1042. <h6><b>$select</b><br/><br/><b>$tab</b><br/><br/><b>$crlf</b><br/><br/><b>$char</b></h6></div>
    1043. 

  1043. 

  1044. <h2><a id="examples" name="examples">Examples</a></h2>
    1045. 

  1045. <div class="level2">
    1046. 

  1046. <p>[ .... ] - displays contents of brackets only if at least one of the fields referenced inside has been found, eg.
    1047. 

  1047. <i>[%artist% - ]</i> will show:&nbsp; &quot;Artist - &quot; &nbsp;only if the %artist% tag is populated,
    1048. 

  1048. otherwise it will not show anything at all (including the hyphen and spaces).</p></div>
    1049. 

  1049. 

  1050. <h3><a id="standard_atf" name="standard_atf">Standard ATF syntax</a></h3>
    1051. 

  1051. <div class="level3"><p><b>Syntax:</b>&nbsp;[%artist%&nbsp;-&nbsp;][%album%&nbsp;-&nbsp;][$num(%track%,2)&nbsp;-&nbsp;]$if2(%title%,$filepart(%filename%))<br/>
    1052. 

  1052. <b>Example:</b> Pink Floyd - Animals - 02 - Dogs</p></div>
    1053. 

  1053. <div class="level3"><p></p></div>
    1054. 

  1054. 

  1055. <div class="level4">
    1056. 

  1056. <p></p></div>
    1057. 

  1057. 

  1058. <h3><a id="advanced_atf" name="advanced_atf">Advanced ATF syntax</a></h3>
    1059. 

  1059. <div class="level3"><p class="atf"><b>Syntax:</b>&nbsp;[$if2(%albumartist%,%artist%)&nbsp;-&nbsp;][%album%&nbsp;-&nbsp;][$num(%track%,2)&nbsp;-&nbsp;]<br/>
    1060. 

  1060. <span class="indent">$IfStrNotEqual(%artist%,$if2(%albumartist%,%artist%),[%artist%&nbsp;-&nbsp;])</span><br/>
    1061. 

  1061. <span class="indent">[$if2(%title%,$filepart(%filename%))][$if($fileext(%filename%),'&nbsp;&nbsp;&nbsp;[&nbsp;&nbsp;',)]</span><br/>
    1062. 

  1062. <span class="indent">[%year%&nbsp;&nbsp;|&nbsp;&nbsp;][$fileext(%filename%)&nbsp;][$if(%bitrate%,&nbsp;'|'&nbsp;&nbsp;,)][%bitrate%&nbsp;'kbps'&nbsp;]</span><br/>
    1063. 

  1063. <span class="indent">[$if($fileext(%filename%),']',)][&nbsp;&nbsp;&nbsp;$repeat(*,%rating%)&nbsp;]</span><br/>
    1064. 

  1064. <b>Returns:</b>&nbsp;AlbumArtist&nbsp;-&nbsp;Album&nbsp;-&nbsp;##&nbsp;-&nbsp;Artist&nbsp;-&nbsp;Title&nbsp;&nbsp;[&nbsp;Year&nbsp;|&nbsp;Ext&nbsp;|&nbsp;Bitrate&nbsp;]&nbsp;&nbsp;StarRating<br/>
    1065. 

  1065. <span class="indent2">if AlbumArtist is different to TrackArtist, otherwise shows Standard format.</span><br/>
    1066. 

  1066. <b>Example:</b>&nbsp;Various&nbsp;-&nbsp;Arcana&nbsp;-&nbsp;01&nbsp;-&nbsp;Tripswitch&nbsp;-&nbsp;Calabi&nbsp;Yau&nbsp;&nbsp;&nbsp;[&nbsp;2006&nbsp;&nbsp;|&nbsp;&nbsp;mp3&nbsp;&nbsp;|&nbsp;&nbsp;205&nbsp;kbps&nbsp;]&nbsp;&nbsp;*****</p></div>
    1067. 

  1067. <div class="level3"><p></p></div>
    1068. 

  1068. 

  1069. <div class="level4">
    1070. 

  1070. <p></p></div>
    1071. 

  1071. 

  1072. </div>
    1073. 

  1073. 

  1074. <div class="clearer"></div>
    1075. 

  1075. 

  1076. <div class="stylefoot"><br/>
    1077. 

  1077. <div class="meta">
    1078. 

  1078. <div class="user"></div>
    1079. 

  1079. <div class="doc"><!--advanced_title_formatting.htm - Last modified: 2007/04/27  by DJ Egg --></div>
    1080. 

  1080. </div>
    1081. 

  1081. 

  1082. <div class="bar" id="bar__bottom">
    1083. 

  1083. <div class="bar-left" id="bar__bottomleft"></div>
    1084. 

  1084. <div class="bar-right" id="bar__bottomright">
    1085. 

  1085. <form action="" method="get">
    1086. 

  1086. <a class="nolink" href="#top"><input class="button" title="Back to top" onclick="window.scrollTo(0, 0)" type="button" value="Back to top" /></a>
    1087. 

  1087. </form>
    1088. 

  1088. </div>
    1089. 

  1089. <div class="clearer"></div>
    1090. 

  1090. </div>
    1091. 

  1091. 

  1092. </div>
    1093. 

  1093. </div>
    1094. 

  1094. 

  1095. <div class="no"><br/></div>
    1096. 

  1096. </body>
    1097. 

  1097. </html>
    1098.