Инструменты пользователя

Инструменты сайта


foobar2000:tagz:tutorial:tagz_intro

Это старая версия документа!


Введение в написание скриптов с использованием Tagz

Tagz это скриптовый язык используемый в foobar2000 не только для конфигурации внешнего вида плэйлистов, но и вообще для реализации любой функциональности уровня продвинутых пользователей. После изучения этого пособия Вы сможете легко использовать этот язык в любых ситуациях. Но начнем мы все же с азов.

Доступ к тэгам и полям

В своей простейшей форме Tagz просто читает информацию из тэгов Ваших музыкальных фалов. Вот так:

%artist%

Foobar2000 ищет тэг artist в песне и возвращает имя испонителя. В случае если этот тэг отутсвует в файле Вы получите в качестве результата вопросительный знак (?). Все что заключено между знаками % рассматривается как тэг, не смотря на имя. Если Вы используете тэг с именем my field в Ваших файлах, то просто используйте %my field% для того чтобы получить информацию из этого тэга.
Кроме того, точно такой же синтаксис используется для доступа к технической информации, например %bitrate% возвращает битрэйт файла, а %_ispaused% покажет Вам сотсояние текущей песни (пауза/проигрывание). Для того чтобы получить более полное описание функциональности Tagz прочтите Справку по функциям и полям, используемым в скриптах Foobar2000

Подстановки полей

Опять вернемся к нашему полю %artist% . Начиная с версии 0.9 foobar2000 это поле на самом деле является сокращенной формой для:

$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))

Не надо пугаться сложности этого выражения. На самом деле оно говорит: Найти тэг artist. Если его нет, использовать тэг album artist. Если же и его нет, то попытаться использовать тэг composer, а затем performer.

Это на самом деле очень важно знать, что за большинством из наиболее используемых тэгов скрываются подстановки подобные этой. Для полного их перечня обратитесь к уже упомянутой справке по функциям и полям. Эти подстановки введены для того чтобы облегчить жизнь создателей скриптов. Большинство подстановок настолько понятны, что соответсующая комманда %имя поля% Most of the remappings are so common that the respective %field% command was hardly ever used in its bare form but rather in an expression like above all the time.

While remapping indeed makes writing scripts more convenient, sometimes we need access to a raw untampered field value. And we’ve already seen how this is done. To access the raw artist field use:

$meta(artist)

Note that there are no percent signs around the field name this time. You can use this syntax for any field referring to tags of your music files. But don’t use it on technical fields like %bitrate%.

This is all too confusing? Don’t worry, it will become clearer once we start developing a real script. I guess returning to this page then and reading it again, would be a good idea.

~~DISCUSSION~~

foobar2000/tagz/tutorial/tagz_intro.1147781807.txt.gz · Последние изменения: 2006/05/16 15:29 (внешнее изменение)