Winamp jest odtwarzaczem multimedialnym, który pozwala na odtwarzanie większości formatów plików audio (w tym internetowych stacji radiowych) oraz wideo. Winamp współpracuje z przenośnymi odtwarzaczami multimedialnymi, pozwala na nagrywanie i zgrywanie płyt CD, posiada wbudowaną bibliotekę multimediów, korektor graficzny oraz wizualizacje. Dzięki zaawansowanemu mechanizmowi wtyczek ma możliwość praktycznie nieograniczonego rozszerzenia możliwości, zaś dzięki mechanizmowi skórek, może wyglądać jak tylko chcesz...
Poniższy dokument opisuje funkcjonalność ATF w Winampie. ATF (Advanced Title Formatting), czyli Zaawansowane formatowanie tytułów, określa sposób wyświetlania metadanych przez Winampa w oknie edytora list odtwarzania oraz pasku tytułu, w głównym oknie.
Globalny ciąg ATF może być edytowany ręcznie, poprzez stronę preferencji Winampa - Tytuły. Domyślnym ciągiem ATF w Winampie jest ciąg: [%artist%-]$if2(%title%,$filepart(%filename%)
Jeśli pola Wykonawca oraz Tytuł są określone w znaczniku pliku, wynikiem takiego zapisu będzie: Wykonawca-Tytuł. Jeśli natomiast plik nie posiada tych informacji wyświetlona zostanie Nazwa pliku.
Na przykład: ‘jakis_tekst$jakis_tekst%jakis_tekst[]’ -> Wynikiem będzie cały ciąg tekstu bez znaków specjalnych ($,%,[,])
Pola definiowane są przez różne elementy Winampa. Niektóre z nich są specyficzne dla Biblioteki mediów (%rating%, %playcount%), inne pochodzą z Winampa (%filename%, %folder%). Jednak, w większości przypadków, pola definiowane są przez wtyczki wejściowe. Niektóre z nich oferują ich znacznie więcej niż inne. Na przykład, wtyczka Windows Media (in_wm, Winamp 5.12+), definiuje wartości z DOWOLNYCH pól w formie %WM/*% (patrz na sekcję Zaawansowane w oknie Informacje o pliku dla plików wma/wmv/asf).
Zwraca pełną ścieżkę dostępu do pliku. Aby wyświetlić tylko nazwę pliku, użyj funkcji $filepart.
Zwraca klasyfikację utworu, w postacji liczby całkowitej z zakresu 1 do 5 (jeśli utwór jest sklasyfikowany). Aby wyświetlić te dane jako gwiazdki lub inne znaki, użyj funkcji $repeat [Tylko w Winampie 5.2 lub nowszym]
Zwraca pole Numer utworu, bez dodatkowych znaków, np. Utwór 1 zostanie wyświetlony jako 1.
Aby wyświetlić dodatkowe znaki, w postacji zer, np.01, 02...10, 11, użyj funkcji $num lub funkcji $lpad.
Zwraca pole Szybkość transmisji bitów (dla plików VBR użyta zostanie średnia szybkość transmisji bitów)
Zwraca pole Długość utwory w milisekundach. Aby sformatować długość trwania utworu, użyj ciągu: $div(%length%,60000):$num($div($mod(%length%,60000),1000),2)
Zwraca 1, jeśli plik jest plikiem Wideo oraz 0, jeśli jest plikiem audio [Tylko w Winampie 5.2 lub nowszym]
Zwraca 1 dla plików audio VBR (kodowanych ze zmienną szybkością transmisji bitów) oraz 0, dla plików audio CBR (kodowanych ze stałą szybkością transmisji bitów).
Poniżej przedstawione sa pola, które definiowane są przez wtyczki wejściowe (powyżej wymieniono także te, które definiowane są również przez Bibliotekę mediów (%length%, %disc%, %track%, %composer%, %streamtitle%, %albumartist%, %publisher%).
Zwraca pole Wykonawca utworu (odpowiednik pola Wykonawca), jeśli Wykonawca albumu jest inny [Tylko w Winampie 5.3 lub nowszym]
Zwraca pole BPM (Uderzenia na minutę), jeśli dane/pole istnieje [Tylko w Winampie 5.3 lub nowszym]
Zwraca pole Narzędzie kodujące (oprogramowanie użyte do zgrania i zakodowania utworu), np. Winamp 5.34 [Tylko w Winampie 5.3 lub nowszym]
Zwraca pole Typ pliku, np. dla pliku M4A zwraca: Format pliku MPEG-4 Audio [Tylko w Winampie 5.5 lub nowszym]
Zwraca kod International Standard Recording Code, lub ISO 3901 (Informacje) [Tylko w Winampie 5.3 lub nowszym]
Zwraca wartość Wzmocnienia utworu współczynnika wzmocnienia ReplayGain (np. -3.16 dB), jeśli istnieje [Tylko w Winampie 5.3 lub nowszym]
Zwraca wartość Wzmocnienia albumu współczynnika wzmocnienia ReplayGain, jeśli istnieje [Tylko w Winampie 5.3 lub nowszym]
Zwraca szczytową wartość Wzmocnienia utworu współczynnika wzmocnienia ReplayGain, jeśli istnieje [Tylko w Winampie 5.3 lub nowszym]
Zwraca szczytową wartość Wzmocnienia albumu współczynnika wzmocnienia ReplayGain, jeśli istnieje [Tylko w Winampie 5.3 lub nowszym]
Uważaj na znaki spacji po znakach przecinka.
Ciąg: $if(%title%, Ma tytuł, Nie ma tytułu) wyświetli w wyniku: “ Ma tytuł” (zwróć uwagę na spację na początku), a nie “Ma tytuł”.
Prawidłowo zapisany ciąg powinien wyglądać jak ten: $if(%title%,Ma tytuł,Nie ma tytułu).
Jeśli parametr a zawiera przynajmniej jedno prawidłowe, nie puste pole, to jest przetwarzane i zwracane w postaci parametru then, w przeciwnym razie zwracany jest parametr else. Proszę zwrócić uwagę, że funkcja $if(A,A,B) jest równa funkcji $if2(A,B)
Jeśli parametr a zawiera prawidłowe, nie puste pole, to parametr a jest przetwarzany i zwracany, w przeciwnym razie zwracany jest parametr else
Jeśli jeden z parametrów a1... aN zawiera prawidłowe, nie puste pole, wartość jest przetwarzana i zwracana, w przeciwnym razie zwracany jest parametr else.
cN lub else. Funkcja instrukcji wyboru (switch/case), która decyduje o tym, który z parametrów bN jest równy parametrowi a, zwracając odpowiadający mu parametr cN. Jeśli żaden z nich nie pasuje, zwracany jest ostatni parametr else.
Tylko w Winampie 5.2 lub nowszym
Porównywane są wartości liczb całkowitych x1 oraz x2. Jeśli x1 jest większe od x2, to przetwarzany jest parametr then i zwracana jest jego wartość. W przeciwnym razie (x2 jest większe od x1) przetwarzany jest parametr else i zwracana jest jego wartość.
Tylko w Winampie 5.2 lub nowszym
Porównywane są długości ciągu znaków a1 oraz x1. Jeśli ciąg a1 jest dłuższy, parametr then jest przetwarzany i zwracana jest jego wartość. W przeciwnym razie parametr else jest przetwarzany i zwracana jest jego wartość.
Tylko w Winampie 5.2 lub nowszym
Jeśli A = B wykonaj then, w przeciwym razie wykonaj else
Tylko w Winampie 5.2 lub nowszym
Reszta z dzielenia x1 przez x2
Tylko w Winampie 5.2 lub nowszym
x1 / x2. Wynik dzielenia x1 przez x2
Tylko w Winampie 5.2 lub nowszym
x1 * x2 * ... * xn. Podane liczby są mnożone przez siebie.
Tylko w Winampie 5.2 lub nowszym
x1 * x2 / 3. Liczba x1 mnożona jest przez liczbę x2, a następnie dzielona przez liczbę x3. Wynik zaokrąglany jest do najbliższej liczby całkowitej.
Tylko w Winampie 5.2 lub nowszym
x1-x2-...-xn. Od liczby x1 odejmowane są liczby x2...xn.
Tylko w Winampie 5.2 lub nowszym
x1 + x2 +...+ xn. Wynikiem jest suma wszystkich przekazanych liczb.
Tylko w Winampie 5.2 lub nowszym
1, jeśli liczba x1 jest większa od liczby x2, w przeciwnym razie nie wykonuje się. Podobna w użyciu do funkcji $ifgreater()
Tylko w Winampie 5.2 lub nowszym
Największa liczba z przekazanych argumentów.
Tylko w Winampie 5.2 lub nowszym
Wszystkie wystąpienia parametru a2 w parametrze a1 są zastępowane parametrem a3
Tylko w Winampie 5.2 lub nowszym
Pierwszy znak x1 parametru a1
Tylko w Winampie 5.2 lub nowszym
Ostatni znak x1 parametru a1
Tylko w Winampie 5.2 lub nowszym
Liczba znaków parametru a1
Tylko w Winampie 5.2 lub nowszym
Indeks pierwszego wystąpienia łańcucha znaków parametru a2 w parametrze a1
Tylko w Winampie 5.2 lub nowszym
Indeks ostatniego wystąpienia znaku parametru a2 w parametrze a1
Tylko w Winampie 5.2 lub nowszym
Indeks pierwszego wystąpienia znaku parametru a2 w parametrze a1
Tylko w Winampie 5.2 lub nowszym
Indeks pierwszego wystąpienia znaku parametru a2 w parametrze a1
Tylko w Winampie 5.2 lub nowszym
a1 lub a2, w zależności od tego, który z nich ma mniejszą długość.
a1 lub a2, w zależności od tego, który z nich ma większą długość.
Wartość parametru a1 jest skracana. Parametr x1 jest opcjonalny. Jeśli jest zdefiniowany, wartość parametru a1 zostanie skrócona tylko wtedy, gdy jego długość przekroczy ilość znaków określoną przez wartość parametru x1
Wartość parametru a1 uzupełniana jest x2 spacjami lub pomniejszona do x2 znaków.
Wartość parametru a1 pomniejszona o x2 znaków.
Wartość parametru string uzupełniana jest o num znaków (domyślnie spacjami) lub określonym znakiem (lub powtarzanym łańcuchem znaków) przez wartość parametru padstr
Wartość parametru string uzupełniana jest o num znaków z lewej strony (domyślnie spacjami) lub określonym znakiem (lub powtarzanym łańcuchem znaków) przez wartość parametru padstr.
Tylko w Winampie 5.2 lub nowszym
Wartość parametru a1 bez spacji poprzedzających oraz kończących.
Tylko w Winampie 5.2 lub nowszym
Wartość parametru a1 powtórzona jest x1 razy.
Wartość parametru a1 zapisana małymi literami, przy czym pierwsze litery każdego ze słów pisane są z dużej litery.
a1, przy czym, pierwsza litera każdego słowa jest pisana z dużej litery.
Rozszerzenie pliku określonego przez wartość parametru a1
Nazwa pliku będąca wartością parametru a1 (bez ścieżki dostępu)
Nazwa pliku będąca wartością parametru a1 (bez ścieżki dostępu)
Nazwa katalogu ścieżki będącej wartością parametru a1, który znajduje się x1 poziomów wyżej.
Tylko w Winampie 5.2 lub nowszym
Rozbicie łańcucha znaków dysku oraz/lub utworu, np. aby pokazać "1" zamiast "1/11"
Tylko w Winampie 5.5 lub nowszym
Rozszerzenie pliku określonego przez wartość parametru a1
Tylko w Winampie 5.2 lub nowszym
Wartość parametru x1 w postaci liczby szesnastkowej z liczbą zer po lewej stronie określonej przez wartość parametru x2
Tylko w Winampie 5.2 lub nowszym
Wartość parametru x1 wraz z określoną przez wartość parametru x2 liczbą zer poprzedzających.
Tylko w Winampie 5.2 lub nowszym
Wartość parametru x1 wraz z określoną przez wartość parametru x2 liczbą zer poprzedzających.
Tylko w Winampie 5.2 lub nowszym
Nic
Tylko w Winampie 5.2 lub nowszym
Pierwszy poziom x1 parametru a1
Tylko w Winampie 5.3 lub nowszym
Ostatni poziom x1 parametru a1
Tylko w Winampie 5.3 lub nowszym
Wartość parametru a1 bez pierwszego poziomu x1 parametru a1
Tylko w Winampie 5.3 lub nowszym
Wartość parametru a1 bez ostatniego poziomu x1 parametru a1
Tylko w Winampie 5.3 lub nowszym
Przechowuje parametr value w zmiennej name. Może być on później pobrany używając funkcji $get(name). Użyj funkcji $put(), aby przechowywać wartość parametru value oraz zwracać tę wartość.
Tylko w Winampie 5.2 lub nowszym
value. Przechowuje parametr value w zmiennej name. Może być on później pobrany używając funkcji $get(name). Użyj funkcji $puts(), aby przechowywać wartość parametru value bez jej zwracania.
Tylko w Winampie 5.2 lub nowszym
Wartość value parametru zmiennej name, zainicjowanej wcześniej przez funkcję $put() lub $puts().
Tylko w Winampie 5.2 lub nowszym
TODO: a1
Tylko w Winampie 5.2 lub nowszym
TODO: a1
Tylko w Winampie 5.2 lub nowszym
TODO: a1
Tylko w Winampie 5.2 lub nowszym
TODO: a1
Tylko w Winampie 5.2 lub nowszym
TODO: a1
Tylko w Winampie 5.2 lub nowszym
[ .... ] - zawartość znajdująca się w nawiasach kwadratowych zostanie wyswietlona tylko wtedy, gdy znalezione zostanie przynajmniej jedno z jego pól.
Przykład: Zapis [%artist%-] wyświetli: "Wykonawca-" tylko wtedy, gdy znacznik %artist% jest określony. Jeśli nie jest, nie zostaną wyświetlone żadne dane (myślnik oraz spacje także nie).
Składnia: [%artist% - ][%album% - ][$num(%track%,2) - ]$if2(%title%,$filepart(%filename%))
Przykład: Pink Floyd - Animals - 02 - Dogs
Składnia:
$if2(%albumartist%,%artist%)-][%album%-][$num(%track%,2)-]
$IfStrNotEqual(%artist%,$if2(%albumartist%,%artist%),[%artist%-])
[$if2(%title%,$filepart(%filename%))][$if($fileext(%filename%),' [ ',)]
[%year% | ][$fileext(%filename%) ][$if(%bitrate%, '|' ,)][%bitrate% 'kbps' ]
[$if($fileext(%filename%),']',)][ $repeat(*,%rating%) ]
Wynik: Wykonawca albumu-Album-##-Wykonawca-Tytuł [ Rok | Rozszerzenie | Szybkość transmisji bitów ] Klasyfikacja
Jeśli Wykonawca albumu różni się od Wykonawcy utworu, w przeciwnym razie wyświetla format standardowy.
Przykład: Various - Arcana - 01 - Tripswitch - Calabi Yau [ 2006 | mp3 | 205 kb/s ] *****