Home - Himura2la/FestEngine GitHub Wiki

Как начать использовать Fest Engine?

Fest Engine сделан так, чтобы максимально облегчить работу во время мероприятия. Поэтому он требует очень внимательной подготовки файлов. В результате, 10 пунктов этой инструкции про настройку и только 3 про использование.

  1. Организуйте имена треков участников так, чтобы у них была единая структура. Например, как-то так:

    • 104 K. [Неизвестно] Kim - Mayumi Suzuki-Part of Your World (OST Русалочка) №97
    • 136 DSE. [Сразу] Чиби-сан - Harry Potter (Minerva McGonagall) №120
    • 208 T. [С точки] LDA - BTS-Blood, Sweat and Fire №177
  2. У слайдов для проектора (задников) должно быть абсолютно такое же имя. Fest Engine относит все файлы с одинаковым именем к одному номеру и будет ругаться в логе на файлы с одинаковой цифрой, но разным именем.

  3. Напишите регулярное выражение, которое опишет Вашу структуру имён. Расширение учитывать не надо, только имя. В нём обязательно должно быть как минимум две именованные группы: num и name.

    • num -- это уникальный номер заявки по программе, по нему будет проиводиться сортировка номеров и его должны знать Ваши участники. Я в качестве num использую трёхзначные чётные числа в которых сотни обозначают номер блока. Только чётные, чтобы всегда было место куда вставить что-нибудь нечётное между номерами. Мы именно их используем в Cosplay 2 как Номер карточки, очень удобно.
    • name -- это строка, по которой вы сможете понять о какой заявке речь. Она должна быть как можно ближе к тому что объявляют ведущие и что написано в сценарии, чтобы точно знать что запускаешь и никогда не путать треки.

    Примеры регулярных выражений:

    • ^(?P<num>\d{3})\W(?P<name>.+)$. Здесь написано следующее:
      1. Сразу после начала строки ^ идут цифры \d в количестве трех штук {3}. Эту часть надо выделить и назвать "num" (?P<num> ).
      2. Дальше идет любой символ, не являющейся буковй или цифрой (точка, пробел, и т.д.) -- \W
      3. Дальше идет любое положительное количество + любых символов .. Эту часть надо тоже выделить и назвать "name" (?P<name> ).
      4. А дальше конец строки $
    • Если после номера всегда идет точка \. и пробел, то будет так: ^(?P<num>\d{3})\. (?P<name>.+)$, либо можно просто поставить два \W: \W{2}
    • Если номер может содержать буквы (123a, 123b, 123c,...), будет так: ^(?P<num>[\d\w]{3,4})\W(?P<name>.+)$ или так ^(?P<num>\d{3}(\w)?)\W(?P<name>.+)$. Здесь [\d\w] означает "либо цифра либо латинская буква \w", а {3,4} означает "от трех до четырех штук", а (\w)? означает что буква может быть, а может и нет. Если у вас есть чёткая структура имён файлов, вы легко её распарсите. В примере выделяется только две группы, но можно выделить больше, и тогда имена остальных именованных групп образуют столбцы таблицы. Например, приведенные в первом пункте названия описываются вот таким страшным выражением: ^(?P<num>\d{3}) (?P<nom>\w{1,3})\. \[(?P<start>.+?)\] (?P<name>.*) №(?P<_req_id>\d{0,3})$

    Больше о регулярных выражениях можно почитать тут, а проверять и понимать как они устроены можно на сайте regex101.com. Вот, например, все треки Yuki no Odori 7: https://regex101.com/r/bvkkuW/1

  4. Скачать последнюю версию под Вашу платформу из раздела Releases. Я рекомендую использовать Full версию, поскольку Minimal требует наличия плеера VLC нужной разрядности на компьютере. То есть, для 90% компьютеров, подойдет festengine-win64-VLCv2.2.8-full.zip. Если Вы предпочитаете последнюю версию VLC (и не боитесь), качайте её.

  5. Распаковать архив куда-нибудь.

  6. Запустить FestEngine.exe и сохранить файл настроек феста рядом с папкой где треки лежат. ВНИМАНИЕ!!! Чтобы создать новый файл настроек феста, нужно просто попытаться открыть несуществующий файл. Возможно это не слишком интуитивно, но мне так было проще... Дальше будет ещё много не-интуитивного, но весьма удобного 😈

  7. Скопировать регулярное выражение, указать внизу папку с треками. Если треки и задники лежат в нескольких папках, воспользоваться кнопкой +. Если есть, указать всё остальное.

  8. Нажать "Сохранить" и перезапустить программу.

  9. Fest Engine должен открыться с Вашими файлами. Обязательно откройте окно лога из меню "Глагнэ" и проверьте что там нет никаких серьезных предупреждений.

  10. Укажите картинку фонового задника (обычно логотип феста) и папке с подложкой для перерывов и длинных интермедий

  11. Когда подключите проектор к ноутбуку, не забудьте указать какой из мониторов является проетором в настройках

  12. Fest Engine настроен. Удалите резервные копии файла настроек феста и не перемещайте этот файл относительно папок, которые в нём указаны.

  13. Самое время проверить что все файлы правильно открываются. Управление производится с помощью F-ряда. Задействованы кнопки Esc, F1, F2, F3 и немного F4. Управление описано тутъ и в меню Запуск.

  14. Изучить все возможности, перечисленные в разделе Какие ещё киллер-фичи?

  15. Развернуть всё и ещё раз пройтись по всем файлам на том ноутбуке, который будет на фесте подключен к проектору и к микшеру.

  16. Не лажать на фесте ^^

⚠️ **GitHub.com Fallback** ⚠️