Установка

Velitask для Windows ставится из MSI-инсталлятора (рекомендуется) или запускается из ZIP-архива без установки.

Зачем это нужно

Velitask — настольное приложение под Windows. Дистрибутивы собраны вместе с Java Runtime (JRE 21), поэтому отдельно ставить Java не нужно. Двух форматов хватает, чтобы покрыть основные сценарии: системную установку с ярлыками — через MSI; «портативный» запуск с флешки или из любой папки — через ZIP.

Системные требования

Для редактирования и экспорта видео полезен быстрый диск (NVMe) и достаточно RAM — Velitask держит в памяти кадры воспроизведения и кеши сенсоров.

Установка из MSI (рекомендуется)

1. Скачайте файл Velitask-X.Y.Z.msi со страницы загрузок velitask.com.
2. Запустите MSI двойным кликом. Установщик попросит права администратора.
3. Выберите папку установки (по умолчанию — C:\Program Files\Velitask\) и нажмите «Установить».
4. После завершения в меню «Пуск» появится ярлык Velitask, в Add or Remove Programs — пункт для удаления.

Запуск из ZIP-архива (портативный режим)

1. Скачайте Velitask-X.Y.Z.zip со страницы загрузок.
2. Распакуйте архив в любую папку (без пробелов и кириллицы в пути — это надёжнее).
3. Зайдите в распакованную папку и запустите VelitaskApp.exe.

При этом служебные данные Velitask (логи, плагины, шаблоны в %USERPROFILE%\.velitask\) и настройки (в системном реестре) создаются вне ZIP-папки — сама распакованная папка остаётся «чистой».

Где Velitask хранит свои данные

Папка .velitask в профиле создаётся при первом запуске. В ней лежат logs\, plugins\ и templates\. Удаление этой папки очищает логи, плагины и пользовательские шаблоны, но не сбрасывает настройки приложения — тема, язык, список недавних проектов и состояние панелей хранятся отдельно (в системном реестре). Ваши проекты при этом не затрагиваются.

Кеш OSM-тайлов по умолчанию хранится внутри папки проекта (<проект>\.cache\OSM\). В настройках проекта можно переключить хранение на общую папку приложения или на произвольный внешний путь.

Удаление

• Установка из MSI: «Параметры → Приложения → Velitask → Удалить» (или «Программы и компоненты»).
• Запуск из ZIP: просто удалите распакованную папку.
• Чтобы стереть пользовательские данные (логи, плагины, шаблоны) — удалите %USERPROFILE%\.velitask\. Это не сбрасывает настройки приложения (тема, язык, недавние проекты, состояние панелей): они хранятся в системном реестре, а не в .velitask. Полный сброс настроек к значениям по умолчанию выполняется отдельно — функцией сброса настроек внутри приложения.

Связанные разделы

• Знакомство с интерфейсом — что вы видите при первом запуске.
• Первый проект — пошаговый разбор от пустого до экспорта.
• Решение проблем — если что-то не запускается или работает медленно.

Решение проблем

• Двойной клик по VelitaskApp.exe ничего не делает. Проверьте, что распаковали ZIP полностью, а не запускаете прямо из архива. Также Windows может блокировать запуск; в свойствах файла поставьте галку «Разблокировать».
• Установка MSI требует прав администратора и они недоступны. Используйте ZIP-вариант — он не требует установки.
• Антивирус ругается на установщик. Velitask не подписан корпоративной подписью. Добавьте папку программы в исключения антивируса.
• Не запускается на Windows 7/8. Не поддерживается. Минимум — Windows 10 64-bit.

Знакомство с интерфейсом

Главное окно Velitask разделено на меню, боковые панели-инструменты, центральную область с вкладками (где открывается плеер Mixel'а) и статусную строку внизу. Этого достаточно, чтобы открыть проект, добавить источник, собрать композицию и экспортировать результат.

Зачем это нужно

Velitask собирает много разных активностей в одном окне: добавление видео и треков, расстановку индикаторов, синхронизацию времени, просмотр сенсорных таблиц, экспорт. Чтобы не теряться, важно сразу понять, где что лежит и в каком порядке к этому возвращаться.

Главное меню

Боковые панели (вкладки-инструменты)

По бокам центральной области — переключаемые панели. По умолчанию часть открыта слева, часть справа. Любую панель можно закрыть крестиком и вернуть через меню Вид, а также перетащить на другую сторону: правый клик по вкладке → Переместить влево / Переместить вправо (или Закрыть).

• Проект — дерево проекта: видео, GPX-треки, изображения, OSM, сенсоры.
• Слои — список слоёв текущего Mixel'а: видео, карта, графики, индикаторы.
• Индикаторы — каталог установленных индикаторов (плагинов), которые можно положить в Mixel.
• Устройства — список Профилей устройств с настройкой временной зоны и смещения часов.
• Время — синхронизация: какому времени соответствует тот или иной кадр.
• Задачи — очередь фоновых операций: скан источников, генерация превью, экспорт. Здесь видно прогресс и ошибки.
• Свойства — параметры выделенного объекта (слоя, индикатора, источника).

Центральная область: вкладки и плеер Mixel'а

В центре окна — область с вкладками, где открываются документы проекта. Открытый Mixel показывается как плеер композиции с привычными элементами:

• Кнопки В начало, Предыдущий кадр, Воспроизвести / Пауза, Следующий кадр, В конец.
• Слайдер-таймлайн с курсором текущей позиции и поля даты и времени для точного перехода.
• Превью видео и наложенных индикаторов в текущий момент времени.
• Ползунок громкости прослушивания (влияет только на воспроизведение в редакторе, не на экспорт).

Поверх плеера показывается то, что вы видите в финальном экспортированном видео.

Статусная строка

Внизу окна — узкая полоска со статусом. Когда работы нет, показывается «Готов». Во время фоновой операции выводится её название, а при наличии второй задачи — ещё и процент прогресса; рядом появляется индикатор выполнения. Справа — индикатор сетевого состояния («Offline»).

Стартовое окно

При первом запуске показывается окно приветствия с кнопкой «Начать!» и галкой «Показывать это окно при запуске». Снимите галку, если хотите сразу видеть рабочее окно; вернуть приветствие можно через Помощь → Показать окно приветствия.

Что делать дальше

1. Создайте проект — Файл → Создать проект... (Ctrl+N) и выберите папку.
2. Добавьте источник: скопируйте видео или GPX-трек в папку проекта — он подхватится автосканом за несколько секунд.
3. Настройте Профиль устройства, чтобы кадры и треки совпали по времени.
4. Откройте Mixel и добавьте нужные индикаторы.
5. Экспортируйте видео.

Подробный сценарий — в разделе Первый проект.

Связанные разделы

• Установка — если вы ещё не запускали Velitask.
• Первый проект — практическое пошаговое прохождение.
• Mixel и слои — что такое центральный плеер.
• Панель источников — подробно про дерево слева.

Первый проект

15-минутный сценарий: новый проект → добавить видео и GPX-трек → синхронизировать время → положить пару индикаторов в Mixel → экспортировать видео.

Зачем это нужно

Чтобы вы быстро увидели «полный цикл» Velitask. Все шаги ниже работают на одной паре «видео с экшен-камеры + GPX-трек с того же заезда» — это самый частый сценарий.

Понадобится:

• одно видео (например, MP4 с GoPro);
• один GPX-трек, записанный примерно в то же время (с велокомпьютера, часов или смартфона);
• пустая папка, в которой Velitask создаст файл проекта .vtproj и будет искать источники.

Шаги

1. Создайте проект

1. Откройте Velitask.
2. Файл → Создать проект...
3. В диалоге укажите Название проекта (например, my-first-trip) и Папку проекта (например, D:\Velitask\). Velitask создаст в выбранной папке файл <название>.vtproj (БД проекта) — например, my-first-trip.vtproj.
4. Папка, где лежит файл .vtproj, и есть папка проекта: именно её Velitask сканирует в поисках источников.

После создания вы увидите пустой Mixel в центре и пустое дерево источников слева.

2. Добавьте видео

1. Скопируйте файл .mp4 (или .mov) в папку проекта — туда, где лежит файл .vtproj (можно в подпапку).
2. Velitask периодически сканирует папку проекта и сам подхватывает новый файл: в дереве источников появится узел my-clip.mp4, метаданные (длительность, разрешение, fps, дата съёмки) прочитаются автоматически.
3. В фоновых задачах (вкладка Задачи) появится прогресс анализа кадров.

3. Добавьте GPX-трек

1. Скопируйте файл .gpx в папку проекта. Velitask распознаёт GPX по расширению при сканировании.
2. В дереве появится узел my-track.gpx. Внутри него — наборы сенсоров: Geo (координаты), Distance (дистанция от старта), Elevation (высота), Speed (скорость), Slope (уклон) — в зависимости от того, что есть в исходном файле.
3. На вкладке Задачи вы увидите импорт. Дождитесь, пока он закончится — в крупных GPX это занимает заметное время.

4. Сверьте время видео и трека

Видео и GPX почти никогда не «совпадают» сами собой: камера может стоять на другом часовом поясе, GPX — в UTC, и т.п. Это решается через Профиль устройства.

1. Откройте вкладку Устройства.
2. Velitask автоматически заводит Профили устройств: как минимум по одному профилю по умолчанию на каждый тип источника (видео, GPX и т.д.), а если из метаданных удаётся распознать конкретное устройство (марка/модель камеры) — создаётся отдельный профиль и привязывается к источнику. Откройте профиль камеры:
   • Часовой пояс — поставьте тот, в котором были выставлены часы камеры (например, Europe/Moscow).
   • Смещение, сек. — оставьте 0, если часы не врали. Если врали (камера спешила на минуту) — введите сюда смещение.
3. Сделайте то же для профиля GPX-источника. У большинства GPS-устройств трек уже в UTC: оставьте часовой пояс UTC и смещение 0.

Подробнее — в разделе Синхронизация времени.

5. Положите индикаторы в Mixel

1. На вкладке Индикаторы виден список доступных индикаторов: спидометр, текст дистанции, текст времени, карта, текст уклона и т.д.
2. Перетащите нужный индикатор на холст плеера в центре. Например, «Спидометр».
3. В правой панели отобразятся свойства слоя: положение, размер, привязка к источнику. Свяжите индикатор с GPX-сенсором скорости.
4. Аналогично положите «Текст времени» (часы) и «Карту» (мини-карту) — типичный набор для велозаезда.

Подробнее — в разделе Редактор Mixel'а.

6. Просмотрите результат

1. Нажмите Воспроизведение (▶) — Velitask воспроизведёт видео с наложенными индикаторами.
2. Перемотайте курсор таймлайна, проверьте, что цифры скорости/дистанции/времени соответствуют видео.
3. Если что-то не сходится — возвращайтесь к шагу 4 и уточняйте Профиль устройства.

7. Экспортируйте видео

1. Файл → Экспорт → Видео → Видео....
2. Выберите диапазон (по умолчанию — весь Mixel), пресет качества, кодек (H.264 — самый совместимый), fps, аудио.
3. Укажите путь к выходному файлу (например, D:\Velitask\my-first-trip\export.mp4).
4. Запустите экспорт. Прогресс отображается на вкладке Задачи.
5. По завершении в указанной папке появится готовый файл.

Подробнее — в разделе Экспорт видео.

Что попробовать дальше

• Добавить больше видео в один проект и собрать из них последовательность.
• Добавить дополнительные сенсоры (каденс, мощность) — Velitask читает их из GPX, если они там есть.
• Покрутить настройки индикаторов: размер, цвет, положение.
• Сохранить пресет экспорта, чтобы быстро применять те же настройки кодирования к следующим проектам.

Связанные разделы

• Знакомство с интерфейсом
• Модель времени
• Импорт видеофайлов
• Импорт GPX
• Синхронизация времени
• Редактор Mixel'а
• Экспорт видео

Модель времени

Сырое (raw) время остаётся у источника — таким, как его записало устройство. Единое UTC-время Velitask вычисляет на лету через Профиль устройства — пару «часовой пояс + смещение часов» — и нигде не хранит его отдельно (ни в БД, ни в состоянии).

Зачем это нужно

Видео, GPX-треки и сенсорные записи сами по себе несут разное время. У одной камеры часы стоят в Europe/Moscow, у другого устройства — в UTC, у третьего часы спешат на минуту, а GPX-приёмник вообще пишет UTC всегда. Если просто склеить всё «как есть», цифры скорости и дистанции будут показываться не в тот момент.

Velitask решает это так:

1. Все исходные «сырые» отметки времени (raw) хранятся как есть — то, что записало устройство.
2. Через Профиль устройства они пересчитываются в UTC в момент обращения (UTC не хранится, а вычисляется по запросу).
3. В UTC работает вся внутренняя шкала проекта — таймлайн Mixel'а, индикаторы, экспорт.

Пользователь нигде вручную UTC не вводит — он только говорит «у этой камеры часовой пояс такой, и она спешит на столько-то секунд».

Профиль устройства

Профиль устройства — это запись в проекте, которая связывает источник с правилами интерпретации его времени.

Velitask не заводит отдельный Профиль на каждый источник. При импорте он создаёт по одному Профилю по умолчанию на тип источника (он привязывается к корню проекта), а по подсказкам из метаданных файла может дополнительно создать профиль конкретного устройства и точечно привязать его к источнику. Профили перечислены на панели «Устройства» и редактируются там же.

Наследование Профиля

Чтобы не задавать Профиль каждому источнику отдельно, действует наследование по цепочке источник → родительские папки → корень:

1. Если Профиль привязан прямо к источнику — берётся он (приоритет 1).
2. Если нет — поднимаемся по родительским папкам и берём первый найденный Профиль.
3. Если и там нет — Профиль, привязанный к корню проекта.
4. Если ничего нигде не привязано — системный Профиль UTC со смещением 0.

То есть удобно один раз настроить «Профиль для GoPro» в корне проекта и не возвращаться к нему для каждого ролика.

Как часовой пояс и смещение превращаются в UTC

Формула простая:

UTC = raw − tz_offset(raw) + offset

• raw — то, что записало устройство.
• tz_offset(raw) — смещение часового пояса от UTC в этот момент (учитывает летнее/зимнее время).
• offset — пользовательская поправка часов («Смещение часов»); вводится в секундах, внутри хранится в миллисекундах.

Velitask умеет в обе стороны: и записывать в UTC, и показывать локальное время устройства — например, в индикаторе «часы».

Что важно понимать

• Один час разницы — это «забытый» часовой пояс. Если индикаторы съезжают ровно на час, обычно дело не в смещении, а в неверной tz Профиля.
• Несколько секунд разницы — это смещение часов. Камеры обычно врут на 5–60 секунд относительно «эталона». Эти секунды задаются через смещение Профиля: если часы спешат — вводите отрицательное значение, если отстают — положительное.
• GPX почти всегда в UTC. Если в GPX-файле прямо указан UTC (типичный случай) — Профилю достаточно UTC и нулевого смещения.

Связанные разделы

• Синхронизация времени — как фактически сверять и подгонять время в UI.
• Импорт GPX — что Velitask делает с GPX-временем при импорте.
• Решение проблем — раздел про сдвинутые индикаторы.

Mixel и слои

Mixel — основной формат композиции в Velitask: прямоугольный холст с набором слоёв, каждый из которых отображает что-то своё (видео, карту, индикатор, фигуру). Это и то, что вы видите в плеере, и то, что в итоге попадает в экспорт.

Зачем это нужно

В типичном телеметрическом видео нужно показать сразу несколько вещей: само видео с камеры, текущие цифры скорости и дистанции, мини-карту с треком, может быть график уклона. Все это — слои одной композиции. Mixel — это контейнер, который их хранит и проигрывает.

Mixel создаётся и хранится для каждого открытого источника отдельно: когда вы открываете видео или трек, Velitask поднимает (или строит по шаблону) его собственную композицию и сохраняет её рядом с источником в проекте. Главного «единого» Mixel'а у проекта нет — у каждого источника свой.

Из чего состоит Mixel

Слои упорядочены: тот, что выше в списке — ближе к зрителю (поверх остальных).

Какие бывают слои

Из коробки Velitask умеет создавать такие слои:

Слои с данными (кроме видео, картинки, фигур и группы) — это индикаторы встроенного плагина Velitask «из коробки» (VelitaskPlagin.defineIndicators), см. Индикаторы и плагины. Список слоёв расширяется: установив новый плагин, вы добавите в Mixel новые типы.

Привязка слоя к источнику

Слои с данными (Спидометр, Дистанция, Карта, …) показывают цифры из конкретного сенсора конкретного источника. Эта связь хранится в свойствах слоя:

• В свойствах слоя в правой панели есть поле «Источник» (или несколько полей, если индикатор использует несколько каналов — это свойства SensorProperty / SourceProperty).
• При добавлении слоя, компиляции или применении шаблона Velitask автоподбирает подходящий источник: индикатор перебирает источники проекта, отбирает совместимые с нужным сенсором и ставит лучший по своей стратегии (applyDefaultSource). Если автоподбор ошибся, вы переназначаете источник вручную в том же поле.
• Если подходящего источника нет или поле сброшено, слой показывает пусто или «—».

Слои и время

Все слои живут на одной общей шкале — таймлайне Mixel'а в UTC. На любом моменте таймлайна Velitask:

1. Берёт текущее UTC-время курсора.
2. Каждому слою подсовывает значение его сенсора в этот момент.
3. Рисует получившуюся картинку — это и есть кадр Mixel'а.

Шкала — общая, поэтому видео с камеры и цифры с GPX автоматически синхронизированы (если правильно настроены Профили устройств).

Mixel как JSON и шаблон

Mixel можно сохранить не только внутри проекта, но и как отдельный .vttp-шаблон. Такой файл хранит JSON-композицию: слои, порядок, размещение и свойства индикаторов.

Шаблон полезен, когда вы хотите переиспользовать одну раскладку в разных проектах: например, всегда открывать видео с видеослоем, спидометром и картой, а GPX-трек — с картой на весь холст.

Velitask умеет применять такие шаблоны вручную и автоматически:

• вручную — через Инструменты → Применить шаблон...;
• экспортировать текущую композицию — через Файл → Экспорт → Шаблон...;
• автоматически — когда у нового источника ещё нет сохранённого Mixel'а;
• отдельно для миниатюр — через thumbnail-video.vttp, thumbnail-gpx.vttp и thumbnail-image.vttp.

Подробно: Mixel JSON и шаблоны. Отдельно про размещение слоёв в шаблоне: Макеты Mixel в JSON.

Связанные разделы

• Знакомство с интерфейсом — где находится плеер Mixel'а.
• Редактор Mixel'а — практика добавления и настройки слоёв.
• Индикаторы и плагины — что такое индикатор как тип слоя.
• Модель времени — почему всё «совпадает» по времени.
• Mixel JSON и шаблоны — как сохранять и применять .vttp.
• Макеты Mixel в JSON — как управлять положением слоёв в шаблоне.

Mixel JSON и шаблоны

Кратко: Mixel можно сохранить как .vttp-шаблон, положить в папку проекта или пользовательскую папку шаблонов и применять к новым источникам. Внутри .vttp — JSON с описанием слоёв, размещения и свойств.

Зачем это нужно

Обычно Mixel удобнее собирать мышью: добавить видео, карту, спидометр, тексты и настроить их в панели свойств. Но иногда полезно иметь шаблон:

• вы часто собираете одинаковую раскладку для разных заездов;
• хотите хранить удачную композицию как отдельный файл;
• готовите несколько проектов с одинаковыми цветами, размерами и позициями;
• хотите быстро поменять базовые параметры в текстовом JSON;
• собираете шаблон один раз и применяете его к новым видео или GPX-трекам.

JSON — это продвинутый способ работы. Если вы не хотите редактировать файлы вручную, можно просто настроить Mixel в интерфейсе и экспортировать его как шаблон.

Как пользоваться

Создать шаблон из текущего Mixel'а

1. Откройте источник с уже настроенным Mixel'ом.
2. Проверьте слои, порядок, размеры, цвета и привязки к данным.
3. Выберите Файл → Экспорт → Шаблон...
4. Сохраните файл с расширением .vttp.
5. Положите файл в папку проекта или в пользовательскую папку шаблонов.

Пользовательская папка шаблонов по умолчанию:

%USERPROFILE%\.velitask\templates

Её можно изменить в Инструменты → Настройки... → Шаблоны (раздел «Шаблоны микселя»).

Применить шаблон вручную

1. Откройте источник или Mixel, к которому хотите применить шаблон.
2. Выберите Инструменты → Применить шаблон...
3. Выберите Базовый шаблон или конкретный .vttp из проекта.
4. Проверьте список слоёв и привязки к данным.
5. Сохраните проект, если результат подходит.

Применение шаблона заменяет текущую композицию Mixel'а. Перед экспериментами лучше сохранить проект или экспортировать текущий Mixel в отдельный .vttp.

Привязки к данным в шаблоне не хранятся в виде конкретных id. При применении шаблона Velitask сам подбирает источники и сенсоры под текущий источник: слой-источник заполняется текущим источником, а свойства-сенсоры индикаторов подбираются автоматически. Поэтому копировать sourceId, sensorId и похожие id из чужого проекта вручную не нужно — в новом проекте они могут указывать на другие данные или вовсе отсутствовать.

Что такое .vttp

.vttp — это файл шаблона Mixel'а. Внутри находится JSON-композиция:

• список слоёв;
• порядок слоёв;
• размещение каждого слоя;
• свойства индикаторов;
• настройки, которые помогают Velitask применить слой к новому источнику.

Обычный Mixel хранится внутри проекта. .vttp лежит отдельным файлом и нужен для переиспользования.

Где Velitask ищет шаблоны

Когда у источника ещё нет сохранённого Mixel'а, Velitask пытается подобрать default-шаблон автоматически.

Сначала приложение подбирает имя файла:

Для каждого имени проверяются уровни:

Приоритет такой:

1. Сначала более конкретное имя: ride.vttp важнее mp4.vttp, а mp4.vttp важнее video.vttp.
2. Внутри одного имени проектный шаблон важнее пользовательского.
3. Пользовательский шаблон важнее системного.
4. Регистр имени файла не важен: Video.vttp и video.vttp считаются одним вариантом.

Пользовательская и системная папки для default-шаблонов проверяются только на верхнем уровне. Если вы положите video.vttp во вложенную подпапку пользовательских шаблонов, автоматический поиск его не увидит.

Проектные, пользовательские и системные шаблоны

Проектный шаблон удобен, когда один проект должен иметь собственный стиль. Например, положите video.vttp в папку проекта, и новые видео в этом проекте будут получать эту раскладку, если для них ещё нет сохранённого Mixel'а.

Пользовательский шаблон удобен для личного стиля. Например, положите gpx.vttp в %USERPROFILE%\.velitask\templates, и новые GPX-треки в разных проектах будут начинаться с вашей карты или набора индикаторов.

Системные шаблоны поставляются вместе с Velitask. Их лучше не редактировать напрямую: скопируйте нужный .vttp в пользовательскую папку и меняйте копию.

Thumbnail-шаблоны

Thumbnail-шаблоны используются для миниатюр и preview в интерфейсе. Они не заменяют основной Mixel источника.

Сейчас используются такие имена:

Thumbnail-шаблоны ищутся только в пользовательской и системной папке шаблонов. Проектная иерархия для них не используется.

Как устроен JSON Mixel'а

Верхний уровень обычно содержит список layers. Каждый элемент списка — один слой на холсте.

Пример встроенного шаблона для видео:

{
  "layers": [
    {
      "name": "com.velitask.plagin.official.video",
      "data": {
        "maket": { "preset": "fill" }
      }
    },
    {
      "name": "com.velitask.plagin.official.speedometer",
      "data": {
        "maket": { "preset": "auto" }
      }
    },
    {
      "name": "com.velitask.plagin.official.geoMap",
      "data": {
        "maket": { "preset": "auto" }
      }
    }
  ]
}

Что здесь важно:

• layers — порядок слоёв;
• name — техническое имя слоя или индикатора;
• data — настройки этого слоя;
• maket — размещение слоя на холсте;
• preset: fill — слой заполняет доступную область;
• preset: auto — Velitask выбирает подходящее место автоматически.

Подробно про maket, его типы и поля: Макеты Mixel в JSON.

Пример шаблона для GPX-карты:

{
  "layers": [
    {
      "name": "com.velitask.plagin.official.geoMap",
      "data": {
        "maket": { "preset": "fill" },
        "properties": {
          "fitTrack": { "value": true }
        }
      }
    }
  ]
}

Здесь properties содержит свойства конкретного индикатора. В примере fitTrack включает подгонку карты под трек.

Что можно менять вручную

Самые безопасные изменения:

• поменять preset размещения, если вы понимаете разницу между fill и auto;
• изменить простые свойства с понятным значением, например true / false, число или цвет;
• удалить лишний слой из списка layers;
• изменить порядок слоёв в списке;
• скопировать готовый слой из другого шаблона, если нужный индикатор установлен в Velitask.

После каждого изменения проверяйте шаблон в копии проекта. Лучше менять по одному небольшому фрагменту за раз.

Что лучше не трогать

Осторожно относитесь к таким полям:

• name — если такого индикатора нет в вашей установке, слой не появится;
• привязки к источникам и сенсорам, если они есть в шаблоне;
• неизвестные вложенные поля в properties;
• JSON, экспортированный более новой версией Velitask, если вы открываете его в старой версии приложения.

Не копируйте sourceId, sensorId и похожие id из одного проекта в другой вслепую. В новом проекте эти id могут означать другие данные или не существовать.

Проверка шаблона

1. Сделайте копию проекта или используйте тестовый проект.
2. Положите .vttp в папку проекта или пользовательскую папку шаблонов.
3. Откройте источник, для которого у Velitask ещё нет сохранённого Mixel'а.
4. Проверьте, какие слои появились.
5. Проверьте свойства слоёв и привязки к источникам.
6. Пролистайте таймлайн.
7. Сделайте короткий тестовый экспорт или экспорт одного кадра.

Если шаблон применился не так, как ожидалось, временно уберите файл из папки шаблонов и откройте источник снова.

Решение проблем

Связанные разделы

• Mixel и слои — базовая модель Mixel'а.
• Редактор Mixel'а — как собрать композицию в интерфейсе.
• Макеты Mixel в JSON — как настроить размещение слоёв в .vttp.
• Индикаторы и плагины — какие индикаторы можно добавлять слоями.
• Пресеты экспорта видео — другой тип пресетов, не связанный с .vttp.
• Решение проблем — общие ошибки проекта, импорта и экспорта.

Макеты Mixel в JSON

Кратко: maket управляет тем, где слой появится в Mixel'е при применении .vttp-шаблона. В шаблонах Velitask поддерживает три preset: auto, fill и proportional.

Зачем это нужно

Шаблон Mixel'а должен работать не только в одном проекте и одном разрешении. Если вы сохраните слой в точных пикселях, он может выглядеть хорошо в 1920x1080, но съехать или стать слишком маленьким в вертикальном видео, квадратном кадре или 4K.

maket решает эту задачу. Он хранит не просто текущие координаты, а правило размещения слоя:

• заполнить родителя полностью;
• попросить индикатор выбрать своё стандартное место;
• поставить слой в процентах от размера родителя.

Для ручной настройки .vttp чаще всего нужен proportional: он понятный, переносимый и хорошо переживает смену разрешения.

Как пользоваться

1. Откройте .vttp-файл в текстовом редакторе.
2. Найдите нужный слой внутри layers.
3. Внутри data добавьте или измените объект maket.
4. Выберите preset: auto, fill или proportional.
5. Для proportional задайте x, y, w, h.
6. Примените шаблон в Velitask и проверьте результат.

Пример слоя со спидометром в правом верхнем углу:

{
  "name": "com.velitask.plagin.official.speedometer",
  "data": {
    "maket": {
      "preset": "proportional",
      "x": 0.73,
      "y": 0.05,
      "w": 0.22,
      "h": 0.30
    }
  }
}

На холсте 1920x1080 это даст примерно:

Где находится maket

maket находится внутри data конкретного слоя:

{
  "layers": [
    {
      "name": "com.velitask.plagin.official.video",
      "data": {
        "maket": { "preset": "fill" }
      }
    }
  ]
}

Для верхнего слоя родитель - весь холст Mixel'а. Для вложенного слоя родитель - слой или группа, внутри которой он находится.

Что происходит при применении шаблона

Когда Velitask применяет .vttp, он читает JSON в режиме шаблона. Для каждого слоя работает такой порядок:

1. Если есть maket, Velitask применяет его и рассчитывает positionInParent и size.
2. Если maket нет, но есть size и positionInParent, используются точные значения из JSON.
3. Если это шаблон и нет ни maket, ни точных размеров и позиции, применяется auto.

Практический вывод: в .vttp лучше явно задавать maket. Тогда шаблон будет понятнее и устойчивее.

Если в одном слое одновременно есть maket, size и positionInParent, главным будет maket. Точные пиксельные поля останутся в файле, но при загрузке слоя будут проигнорированы.

Типы макетов

Если preset не указан внутри maket, Velitask считает его auto.

Если указан неизвестный preset, Velitask не сможет применить такой maket. Если рядом есть size и positionInParent, будут использованы они. Если это шаблон без точных размеров и позиции, слой в итоге получит auto.

auto

auto выглядит так:

{
  "maket": { "preset": "auto" }
}

auto не хранит координаты, размер, якорь или отступы в .vttp. Вместо этого слой вызывает своё стандартное размещение: внутри Velitask auto запускает applyDefaultParameters() слоя, а тот считает раскладку по правилам индикатора относительно размера родителя.

Для official-индикаторов стандартное размещение задаётся в самом индикаторе через defineMaket: индикатор указывает выравнивание (по вертикали и горизонтали) и базовый размер. Конкретное место в пикселях получается уже из этих правил и размера родителя.

Подтверждённые значения official-индикаторов:

Эти значения нужны как стартовая раскладка. Пользователь может потом двигать и менять слой в редакторе.

Примечание: в коде есть ещё индикатор Slope speed (сверху справа, 400x200), но он не зарегистрирован в official-плагине и в обычной сборке недоступен, поэтому в таблицу выше не вошёл.

Когда выбирать auto:

• вы хотите получить стандартное размещение индикатора;
• вам не важна точная позиция;
• вы делаете очень короткий шаблон, как встроенный video.vttp;
• вы доверяете индикатору подобрать удобное место.

Когда не выбирать auto:

• нужно точно контролировать композицию;
• несколько слоёв должны стоять симметрично;
• шаблон должен одинаково выглядеть на разных проектах;
• вы хотите задать конкретный процент ширины и высоты.

Важно: через .vttp нельзя настроить внутренние отступы auto. В шаблоне можно только выбрать preset: "auto". Если нужны свои координаты, используйте proportional.

fill

fill выглядит так:

{
  "maket": { "preset": "fill" }
}

Он делает простую вещь:

• x = 0;
• y = 0;
• ширина равна ширине родителя;
• высота равна высоте родителя.

Для верхнего слоя это значит: слой займёт весь холст Mixel'а. Для слоя внутри группы это значит: слой займёт всю группу.

Хорошие сценарии:

• основное видео на весь Mixel;
• карта на весь Mixel для GPX-only проекта;
• фоновый прямоугольник внутри группы;
• thumbnail-шаблон, где нужен один слой на всю миниатюру.

Пример:

{
  "name": "com.velitask.plagin.official.video",
  "data": {
    "maket": { "preset": "fill" }
  }
}

Если вы хотите оставить поля по краям, fill не подойдёт. Используйте proportional, например x=0.03, y=0.03, w=0.94, h=0.94.

proportional

proportional выглядит так:

{
  "maket": {
    "preset": "proportional",
    "x": 0.10,
    "y": 0.20,
    "w": 0.30,
    "h": 0.40
  }
}

Поля означают:

Значения обычно задаются от 0.0 до 1.0.

Velitask не ограничивает эти числа жёстко. Отрицательные значения или значения больше 1.0 могут вынести слой за пределы родителя. Иногда это полезно для художественного выхода за край, но чаще это ошибка.

Если поля пропущены, применяются значения по умолчанию:

То есть такой JSON:

{
  "maket": { "preset": "proportional" }
}

эквивалентен слою на весь родитель:

{
  "maket": {
    "preset": "proportional",
    "x": 0.0,
    "y": 0.0,
    "w": 1.0,
    "h": 1.0
  }
}

Для полного заполнения всё равно лучше использовать fill: так шаблон короче и понятнее.

Готовые формулы

Правый верхний угол

Слой занимает 22% ширины, 30% высоты и имеет отступ 5% сверху и 5% справа:

{
  "maket": {
    "preset": "proportional",
    "x": 0.73,
    "y": 0.05,
    "w": 0.22,
    "h": 0.30
  }
}

Почему x = 0.73: 1.0 - 0.05 - 0.22 = 0.73.

Левый нижний угол

Слой занимает 34% ширины, 32% высоты и имеет отступ 4% слева и 5% снизу:

{
  "maket": {
    "preset": "proportional",
    "x": 0.04,
    "y": 0.63,
    "w": 0.34,
    "h": 0.32
  }
}

Почему y = 0.63: 1.0 - 0.05 - 0.32 = 0.63.

Центр

Слой занимает 40% ширины и 25% высоты, стоит по центру:

{
  "maket": {
    "preset": "proportional",
    "x": 0.30,
    "y": 0.375,
    "w": 0.40,
    "h": 0.25
  }
}

Формулы:

• x = (1.0 - w) / 2;
• y = (1.0 - h) / 2.

Нижняя плашка на всю ширину

{
  "maket": {
    "preset": "proportional",
    "x": 0.0,
    "y": 0.88,
    "w": 1.0,
    "h": 0.12
  }
}

Так удобно делать нижнюю информационную панель.

Карта с полями

{
  "maket": {
    "preset": "proportional",
    "x": 0.03,
    "y": 0.56,
    "w": 0.34,
    "h": 0.39
  }
}

Подходит для карты в левом нижнем углу с небольшим отступом от краёв.

Небольшой выход за край

{
  "maket": {
    "preset": "proportional",
    "x": -0.02,
    "y": -0.02,
    "w": 1.04,
    "h": 1.04
  }
}

Так можно слегка увеличить фон или карту, чтобы избежать тонкой пустой полосы по краю. Используйте осторожно: часть слоя окажется за пределами холста.

maket, size и positionInParent

В обычном сохранении Mixel может хранить точные пиксельные поля:

{
  "size": { "...": "..." },
  "positionInParent": { "...": "..." }
}

Для шаблонов это менее удобно: пиксели зависят от конкретного разрешения.

В .vttp лучше использовать:

{
  "maket": {
    "preset": "proportional",
    "x": 0.70,
    "y": 0.06,
    "w": 0.25,
    "h": 0.30
  }
}

Если maket есть, он рассчитывает размер и позицию заново. Если maket нет, Velitask пробует использовать size и positionInParent.

Что происходит при смене размера Mixel'а

Когда размер холста Mixel'а меняется, Velitask заново применяет макеты верхних слоёв:

• fill снова растягивается на весь холст;
• proportional пересчитывается по новым ширине и высоте;
• auto снова применяет стандартное размещение индикатора.

Поэтому proportional хорошо подходит для шаблонов, которые должны жить в 16:9, 1:1, 9:16 или 4K.

Как Velitask экспортирует maket

Когда вы экспортируете текущий Mixel как шаблон, Velitask сохраняет слой в template-режиме.

Важно: на текущий момент экспорт всегда сохраняет размещение как proportional, независимо от того, какой preset был активен у слоя. Даже если у слоя стоял auto или fill, в шаблон попадёт proportional: Velitask берёт текущие пиксельные координаты и размер слоя и делит их на размер родителя, получая x, y, w, h.

То есть активный preset auto или fill при экспорте не сохраняется как есть, а заменяется на эквивалентный proportional, рассчитанный из текущей раскладки.

Практический совет: после экспорта шаблона откройте .vttp и при необходимости вручную замените получившийся proportional обратно на auto или fill, если вы хотите именно эти presets. Для точного контроля места достаточно проверить, что у нужных слоёв стоит proportional с понятными x, y, w, h.

Как выбрать подходящий preset

Частые ошибки

Проверка макета

1. Сделайте копию .vttp.
2. Измените maket только у одного слоя.
3. Примените шаблон к тестовому источнику.
4. Проверьте слой на обычном размере Mixel'а.
5. Измените размер Mixel'а или экспортное разрешение и проверьте ещё раз.
6. Убедитесь, что слой не выходит за края и не перекрывает важные элементы.

Связанные разделы

• Mixel JSON и шаблоны - общий формат .vttp и правила поиска шаблонов.
• Mixel и слои - базовая модель слоёв.
• Редактор Mixel'а - визуальная настройка слоёв.
• Поддерживаемые форматы - где описан формат .vttp.

Индикаторы и плагины

Индикатор — это «виджет» поверх видео: спидометр, текст скорости, мини-карта, график уклона. Все индикаторы поставляются плагинами; стандартный набор уже встроен, дополнительные можно установить отдельно.

Зачем это нужно

Велитаск-видео обычно состоит из самой картинки с камеры и набора накладок с цифрами и графикой: чтобы зритель видел скорость, уклон, дистанцию, текущую точку на карте. Эти накладки в Velitask называются индикаторами.

Индикаторы — расширяемая часть. Стандартный набор покрывает типичный велозаезд / трекинг, а дальше — плагины: индикаторы для парапланов, лодок, авто, кастомные графики и т.д.

Что такое плагин

Плагин — это модуль, который привозит с собой:

• Индикаторы (новые типы слоёв в Mixel'е).
• Иногда — фигуры, шрифты, иконки.
• Свою локализацию.

Плагин не меняет ядро приложения и не заменяет существующие индикаторы — он только добавляет новое в каталог. Свою служебную информацию (например, штатный плагин при импорте источника рассчитывает и сохраняет группы уклона) плагин держит в собственной таблице — отдельной для каждого плагина, а не в общих данных проекта.

Где видно индикаторы

Стандартный набор (плагин Velitask)

Список может расти от версии к версии — заглядывайте на вкладку Индикаторы после обновления.

Фигуры индикатора

Некоторые индикаторы — это не один элемент, а контейнер с фигурами: например, у спидометра внутри может быть стрелка, шкала, подпись. Такие фигуры можно выбирать.

• На вкладке Индикаторы разверните карточку индикатора — под описанием показан список поддерживаемых фигур с галками. Отмеченные фигуры добавляются вместе с индикатором, когда вы перетаскиваете его на холст. (Раньше состав фигур был фиксированным — теперь вы выбираете его сами.)
• Добавить фигуру к уже стоящему индикатору можно позже: на вкладке Слои правый клик по слою-индикатору → Добавить фигуры → выберите нужную фигуру. Подменю показывается только у индикаторов, поддерживающих фигуры.

Установка дополнительных плагинов

Плагины поставляются как отдельные .jar-файлы. Velitask ищет их при запуске в папках-источниках; по умолчанию это %USERPROFILE%\.velitask\plugins\. Кроме того, рядом с приложением есть встроенная (bundled) папка plugins со штатными плагинами — её менять не нужно.

Простой способ. Положите .jar в %USERPROFILE%\.velitask\plugins\ (создайте папку, если её нет). Папка пересканируется в фоне — новый индикатор появится во вкладке Индикаторы; перезапуск не требуется.

Окно «Плагины»

Открывается через меню Инструменты → Плагины.... Здесь видно все обнаруженные плагины таблицей со столбцами Имя, Версия, Статус (активен / загрузка / перезагрузка / отключён / ошибка / обнаружен), Индикаторы (сколько индикаторов привозит плагин) и Действия. Сверху — поиск по имени / автору.

Для каждого плагина доступно:

• Перезагрузить — перечитать .jar без перезапуска приложения.
• Отключить / Включить — временно убрать плагин из работы (его индикаторы исчезнут из каталога) и вернуть обратно.
• Открыть папку — показать, откуда загружен .jar.

Кнопка «Настроить источники…» ведёт в настройки, где список папок-источников можно дополнить, удалить или переупорядочить (раздел Папки с плагинами). Двойной клик по строке открывает подробную карточку плагина.

Если плагин не появился — проверьте его статус в окне «Плагины» (ошибка) или лог приложения (%USERPROFILE%\.velitask\logs\velitask.log): там видно, удалось ли загрузить файл.

Скины индикаторов

Скин — это именованный набор настроек оформления индикатора (цвета, толщина обводки, прозрачность, шрифт, форма), который применяется одним кликом. Скин избавляет от необходимости каждый раз выкручивать десяток ползунков, чтобы индикатор «выглядел красиво».

Какие скины бывают

В Velitask три источника скинов для одного и того же индикатора:

Например, у спидометра автор может объявить встроенные скины «Default», «Night», «Racing» — они появятся в подменю «Скин».

Какой скин применяется при добавлении

При перетаскивании индикатора на холст он добавляется с теми настройками, что заложены в нём по умолчанию — никакой скин автоматически не применяется. Если вам нужен другой вид, выберите скин вручную через подменю «Скин» (см. ниже) или подкрутите отдельные свойства.

При открытии существующего проекта ранее настроенное оформление индикаторов сохраняется.

Как сменить скин

1. Откройте Mixel.
2. На вкладке Слои правой кнопкой щёлкните по слою-индикатору.
3. В контекстном меню выберите подменю «Скин».
4. Кликните по нужному варианту — его настройки сразу применятся к слою.

После применения скина все «визуальные» свойства индикатора (Цвет, Толщина обводки, Прозрачность и т.п.) обновляются. «Невизуальные» свойства не трогаются: если у вас был привязан конкретный сенсор-источник или включено фоновое аудио — это останется как было.

Сохранение собственного скина

Если вы накрутили хорошую комбинацию настроек и хотите её повторно использовать:

1. Правый клик на слое → Скин → Сохранить в скин….
2. Выберите файл .vtskin (новый или существующий — добавится в него) и подтвердите.
3. Введите имя скина — например, «Мой ночной» или «Для зимних видео».

После этого ваш скин появляется в подменю «Скин» — и доступен ровно так же, как встроенные.

Файлы .vtskin

.vtskin — это маленький JSON-файл, в котором хранится один или несколько ваших скинов для разных индикаторов. Что в нём удобно:

• Перенос между проектами. Скопируйте .vtskin в папку другого проекта — Velitask найдёт его и покажет в меню «Скин» соответствующих индикаторов.
• Делиться с коллегами. Файл можно отправить, и у получателя в его проекте появятся ваши скины.
• Один файл — много индикаторов. Один .vtskin может хранить, например, скины спидометра, компаса и графика уклона — целый «комплект» под один стиль видео.

Velitask ищет .vtskin в папке проекта (рекурсивно). Никаких глобальных мест — каждый проект использует свой набор файлов.

Что хранится в скине

Логика простая: скин — это про оформление, не про данные. Поэтому, переключив скин у спидометра, вы не потеряете привязку к GPX-источнику; перенеся .vtskin в новый проект, вы не утянете туда чужие источники.

Когда меню «Скин» не появляется

Подменю «Скин» в контекстном меню видно только у тех индикаторов, чей автор объявил для них скины (в плагине). У некоторых стандартных и пользовательских индикаторов скинов может не быть — тогда подменю просто скрыто. Это нормально.

Связанные разделы

• Mixel и слои — что такое слой Mixel'а в целом.
• Редактор Mixel'а — как добавлять и настраивать индикаторы.
• Сенсорная телеметрия — на каких данных индикаторы работают.

Импорт видеофайлов

Velitask читает видео через FFmpeg, а в проект добавляет файлы с расширением .mp4 и .mov. Источник добавляется не через меню импорта, а копированием файла в папку проекта — Velitask сканирует её сам.

Зачем это нужно

Видео — основа большинства проектов. Все индикаторы и графики накладываются именно на него. Velitask должен «увидеть» видео, прочитать длительность, разрешение и (если есть) дату съёмки в метаданных.

Какие файлы понимает Velitask

В проект Velitask добавляет видеофайлы с расширением .mp4 и .mov — именно эти расширения распознаёт сканер проекта. Декодирование идёт через встроенный FFmpeg (JavaCV), поэтому внутри контейнера обычно понимается широкий набор кодеков:

Конкретный набор кодеков определяется возможностями встроенной сборки FFmpeg; Velitask не проверяет их отдельным списком. Если ваш файл в другом контейнере (AVI, MKV, WebM, MTS/AVCHD и т.п.), пересохраните (ремультиплексируйте) его в .mp4 или .mov любым видеоредактором — тогда Velitask его подхватит.

Как добавить видео в проект

Velitask работает с проектом как с папкой на диске. Отдельной команды «импорт» или перетаскивания файлов в окно нет — источник добавляется через файловую систему:

1. Откройте папку проекта в проводнике (ту, что вы указали при создании проекта).
2. Скопируйте в неё видеофайл .mp4/.mov. Можно разложить файлы по подпапкам — структура папок отразится в дереве источников.
3. Velitask периодически сканирует папку проекта (примерно раз в 3 секунды) и сам добавит файл — в дереве на вкладке Проект появится новый источник (дерево повторяет структуру папок и файлов), а на вкладке Задачи — прогресс чтения метаданных.

Несколько файлов добавляются так же — просто скопируйте их все в папку проекта.

Что происходит после добавления

1. Чтение метаданных. Разрешение, длительность и время создания (creation_time), если оно есть в метаданных файла. fps и кодек в базу источника не записываются. Если creation_time в файле нет, время съёмки остаётся незаданным — дата изменения файла не подставляется.
2. Создание Профиля устройства. Velitask автоматически создаёт новый Профиль или подвязывает источник к существующему по подсказкам из метаданных файла (теги make, model, device_make, device_model, encoder), а не по имени файла. Если подсказок нет, источник наследует Профиль по умолчанию.
3. Подготовка кадрового кеша. Превью кадров вычитываются по запросу при перемотке таймлайна. Долгое предварительное декодирование не запускается — это экономит время и место.

Файл остаётся лежать в папке проекта — Velitask ссылается на него по месту. Не удаляйте и не переименовывайте видео в обход приложения, пока работаете с проектом.

Где видео в Mixel'е

После импорта оно ещё не на холсте — вам нужно положить его как слой:

1. Откройте вкладку Индикаторы, найдите индикатор видео.
2. Перетащите его на холст.
3. В свойствах слоя укажите ваш видеоисточник.

Подробнее — в разделе Редактор Mixel'а.

Звук

Звук берётся из видео-слоя: у индикатора видео есть свойство аудио, и только когда оно включено, дорожка проигрывается в плеере и попадает в экспорт. Громкость настраивается там же.

При экспорте звук всегда перекодируется в AAC: даже при выборе варианта «Копия» (без перекодирования) на несовместимой дорожке Velitask переключается на AAC, поэтому побитовое копирование исходной аудио-дорожки не гарантируется.

Связанные разделы

• Поддерживаемые форматы — детальный список расширений.
• Импорт GPX — добавление GPS-трека к видео.
• Редактор Mixel'а — как положить видео слоем.
• Решение проблем — если файл не открывается.

Решение проблем

• Файл не открылся, в логе FFmpeg-ошибка. Скорее всего файл повреждён или это поток без заголовка. Пересохраните файл в любом видеоредакторе и попробуйте снова.
• Velitask не видит дату съёмки. Не во всех файлах есть метаданные с датой (creation_time). Если её нет, время съёмки остаётся незаданным — дата изменения файла не подставляется, и корректное время нужно задать вручную через Профиль устройства.
• «Длительность 0 сек». Файл импортирован, но плеер показывает пустой таймлайн. Это бывает с файлами без правильного индекса. Помогает пересохранение в любом видеоредакторе.

Импорт GPS-треков (GPX)

GPX-файлы Velitask читает напрямую: трек превращается в набор сенсоров — Geo (координаты), Distance, Elevation, Speed, Slope. Источник добавляется копированием .gpx в папку проекта; Velitask подхватывает его сам. Большие треки читаются в фоне.

Зачем это нужно

GPS-трек — главный источник «цифр» для типичного проекта: скорость, дистанция, координаты для мини-карты, высота, уклон. Все индикаторы поверх видео обычно работают именно от GPX.

Что Velitask делает с GPX

После импорта одного .gpx Velitask автоматически создаёт несколько сенсоров — отдельных каналов данных:

Из дополнительных полей точки Velitask распознаёт только температуру (теги temperature / temp / atemp) и заводит для неё сенсор Temperature. Другие расширения GPX (мощность, каденс, пульс) на этом этапе не разбираются.

Как добавить трек

Как и видео, GPX добавляется через папку проекта — отдельной команды импорта нет:

1. Скопируйте файл .gpx в папку проекта (или подпапку) любым файловым менеджером.
2. Velitask при очередном сканировании папки распознает расширение и сам прочитает трек.

Что происходит дальше

1. В дереве (вкладка Проект) файл ваш-трек.gpx появится в той папке, куда вы его положили. Разверните узел файла — сенсоры (Geo, Distance, Elevation, Speed, Slope, …) подгрузятся при первом разворачивании.
2. На вкладке Задачи виден прогресс. Очень крупные треки (десятки тысяч точек) читаются заметно дольше.
3. По завершении сенсоры доступны для привязки к индикаторам Mixel'а.

Время в GPX

Метки времени в GPX читаются как ISO-инстанты (UTC) — Velitask берёт их «сырыми» (raw), как в файле. Дальше время источника проходит общую Модель времени: итоговый UTC получается через Профиль устройства, а не из самого GPX.

Профиль для источника подбирается автоматически: при сканировании запускается задача привязки профилей. Для GPX подсказка имени устройства берётся из атрибута creator корневого тега <gpx>. Если подходящего устройства нет — источник наследует профиль по умолчанию с корня проекта. Подробнее — Модель времени и Синхронизация времени.

Если GPX «не той длительности»

GPX — это последовательность точек с временными метками. Если первая точка имеет время T0, последняя — T1, то длительность сенсора будет T1 − T0. Это не привязано к длительности видео: один трек может покрывать несколько видеоклипов или, наоборот, быть короче ролика.

После импорта вы расставляете слои с этими сенсорами; Velitask автоматически показывает значения только в той части таймлайна, где трек существует.

Несколько треков в одном проекте

Можно импортировать несколько GPX в один проект: каждый станет своим источником. Это удобно, когда вы записываете трек на нескольких устройствах одновременно (часы + велокомпьютер) или хотите сравнить треки.

При создании слоя-индикатора вы выбираете, из какого именно GPX-источника брать данные.

Связанные разделы

• Сенсорная телеметрия — что такое сенсор и как они хранятся.
• Каталог сенсоров — все типы и единицы измерения.
• Модель времени — почему нужен Профиль устройства.
• Редактор БД — как заглянуть в импортированные точки.

Решение проблем

• GPX импортировался, но Speed везде нули. Точки идут с одинаковым временем (или времени нет вовсе). Velitask ничего не может вычислить. Нужен другой источник трека.
• Высоты нет, графика нет. Не во всех GPX пишут <ele>. Уклон тоже посчитать не из чего.
• Импорт идёт очень долго. Это нормально для больших треков — точек могут быть десятки тысяч. Смотрите прогресс на вкладке Задачи.
• Точки трека «съезжают» во времени. Это вопрос Профиля устройства, не самого импорта — см. Синхронизация времени.

Сенсорная телеметрия

Сенсор — это один канал измерений, привязанный к источнику: скорость, дистанция, мощность, координаты, температура. Сенсоры хранятся в БД проекта как последовательности «атомов» (точек с временной меткой).

Зачем это нужно

Любой индикатор на холсте Mixel'а работает с данными — берёт их из сенсора. Чтобы понять, какой индикатор что покажет и где взять цифры, полезно представлять, как устроены сенсоры.

Что такое сенсор и атом

Один источник может содержать несколько сенсоров разных типов. Из одного GPX это типично: Geo + Distance + Elevation + Speed + Slope.

Откуда берутся сенсоры

Подробнее про типы — в Каталог сенсоров.

Как сенсоры видны в проекте

1. Откройте дерево источников (вкладка «Проект»).
2. Разверните любой источник — увидите список его сенсоров.
3. Двойной клик по сенсору открывает Редактор БД для этого сенсора (см. Редактор БД).

Хранение

• Все атомы сохраняются в базу проекта. Это локальный файл — никаких облаков, никаких сетевых обращений.
• Большие треки могут давать десятки и сотни тысяч атомов. База справляется без проблем; для просмотра в Редакторе БД используется страничный показ.

«Сырое» и обработанное значение

Velitask не «причёсывает» значения за вас: если в GPX-треке есть выбросы скорости (например, 200 км/ч на велосипеде из-за GPS-сбоя), они попадут в сенсор как есть, и индикатор тоже их покажет.

При этом импорт всё же не дословный:

• из исходных координат и высоты строятся производные сенсоры — Дистанция, Скорость, Уклон (а в GPX ещё и сама Скорость);
• точки с нулевыми/пустыми координатами и точки с немонотонным временем (время не больше предыдущего) пропускаются;
• в телеметрии .tmg по разреженным каналам (давление, температура, наклон, электрика, колесо, каденс) может переноситься последнее известное значение, если в очередной строке канал не заполнен.

Что можно с этим сделать:

• Отредактировать атомы вручную через Редактор БД — заменить, удалить пиковые значения.
• Использовать Редактор атома сенсора, чтобы увидеть, как одна точка влияет на индикатор.

Сенсор и время

Каждый атом несёт своё «сырое» время устройства. Через Профиль устройства оно превращается в UTC и попадает на общий таймлайн Mixel'а. Поэтому правильный Профиль — это не «формальность», а основа корректной синхронизации.

Связанные разделы

• Каталог сенсоров — все типы и единицы.
• Импорт GPX — основной способ получения сенсоров.
• Редактор БД — просмотр и правка атомов.
• Редактор атома сенсора — превью отдельного атома.
• Модель времени — как «сырое» время становится UTC.

OSM-тайлы

Velitask показывает мини-карту через OpenStreetMap (OSM). Тайлы (квадратные кусочки карты) скачиваются по мере необходимости и кешируются на диск, поэтому повторный просмотр того же региона работает оффлайн.

Зачем это нужно

Мини-карта с маркером текущей позиции и треком — один из главных индикаторов в видео велозаездов и поездок. Velitask берёт картинку карты с серверов OpenStreetMap. Чтобы это было быстро, не зависело от интернета на этапе экспорта и не било по серверам OSM при каждом кадре, тайлы кешируются локально.

Как это работает

1. Когда индикатор Карта оказывается в Mixel'е, он определяет нужный регион и масштаб.
2. Карта разрезается на квадратные тайлы (256×256 пикселей).
3. Velitask проверяет, есть ли каждый тайл в локальном кеше:
   • Есть — берёт оттуда (мгновенно).
   • Нет — скачивает с сервера OSM в фоне и кладёт в кеш. Для уже отрисованного места используется заглушка / предыдущий уровень.

Где лежит кеш

По умолчанию кеш хранится внутри папки проекта: <проект>\.cache\OSM\.

Это поведение задаётся в Настройки → Файлы и папки:

• поле «Папка кеша OSM-тайлов» — путь к внешней общей папке кеша;
• галка «Хранить внутри папки проекта» (по умолчанию включена) — пока она включена, поле пути не используется и кеш каждого проекта лежит в его подпапке .cache\OSM\. Снимите галку, чтобы хранить тайлы всех проектов в одной общей папке по указанному пути.

Структура — стандартная для OSM (по уровню масштаба и координатам тайла). Кеш не очищается автоматически: со временем папка может разрастись до сотен мегабайт или гигабайт, если вы много путешествовали по разным регионам в проектах.

Удалить кеш безопасно — Velitask просто заново скачает нужные тайлы. На результаты в проектах это никак не повлияет.

Оффлайн-работа

Если вы один раз отрисовали карту нужного региона на нужных масштабах, дальше она доступна оффлайн. Полезный приём перед поездкой без интернета:

1. Импортируйте GPX заранее.
2. Поставьте индикатор Карта в Mixel.
3. Прокрутите весь таймлайн на нужном масштабе — Velitask загрузит все тайлы по треку.
4. Дальше можно работать без сети.

Лимиты OSM-серверов

Серверы OpenStreetMap.org — публичные и бесплатные, но имеют политику честного использования: десятки одновременных запросов с одного IP могут привести к временному блокированию. Velitask старается это уважать: загрузка идёт через очереди задач с задержками между запросами, при ответе сервера о превышении лимита (429) включается пауза-backoff и повторная попытка, уже скачанные и стоящие в очереди тайлы не запрашиваются повторно.

Растровый источник тайлов — https://tile.openstreetmap.org/{z}/{x}/{y}.png; в интерфейсе он не меняется.

Что показывается на карте

Сама карта — это просто фон. Поверх неё индикатор Карта рисует:

• Трек — линия по точкам Geo-сенсора.
• Маркер текущей позиции — на месте, соответствующем UTC-времени курсора в Mixel'е.
• (Опционально) направление, информацию о текущей точке — в зависимости от настроек индикатора.

Векторные данные карты (Overpass)

Кроме растровых тайлов Velitask умеет подтягивать векторные данные OSM — названия населённых пунктов и административные границы. Они берутся не с тайл-сервера, а через Overpass API и используются, чтобы подписывать места и рисовать границы поверх карты.

Сервер Overpass настраивается в Настройки → Карты (OSM), поле «Сервер Overpass API»:

• можно выбрать один из предустановленных адресов или ввести свой URL;
• изменение применяется после переоткрытия проекта.

Загрузка идёт фоновыми задачами (видны на вкладке Задачи): отдельно скачиваются векторные данные и границы (задача «Загрузка данных карты...»), отдельно — населённые пункты (задача «Загрузка населённых пунктов...»). Сами растровые тайлы грузит задача «Загрузка тайлов карты...». Результат кешируется так же, как тайлы, поэтому повторный показ того же региона работает оффлайн.

Связанные разделы

• Импорт GPX — откуда берётся трек для карты.
• Mixel и слои — как добавить карту слоем.
• Редактор Mixel'а — настройки индикатора Карта.

Решение проблем

• Карта серая, тайлы не грузятся. Проверьте интернет. Если за прокси — Velitask не имеет встроенной настройки прокси, придётся полагаться на системную.
• Карта работает, но в одном месте «дырка». Пробит кеш для этих тайлов — удалите соответствующую подпапку в .cache\OSM (или в общей папке кеша, если она задана) или просто весь кеш.
• Кеш занимает много места. Это нормально для активных пользователей. Удалите папку .cache\OSM проекта (или общую папку кеша) — Velitask пересоздаст по мере надобности.
• Тайлы выглядят размыто. Вы смотрите карту на масштабе, для которого не подгружен подходящий уровень тайлов. Прокрутите/поменяйте масштаб — Velitask догрузит нужные.

Импорт изображений

Кратко: кроме видео и треков Velitask умеет работать с источником-картинкой — статичным изображением как основой Mixel'а. Удобно для постеров, титульных кадров и оверлеев на однотонном фоне. Добавляется копированием файла в папку проекта. Распознаются .jpg, .jpeg, .png, .bmp, .gif, .tif, .tiff.

Зачем это нужно

Не всё в проекте — движущееся видео. Иногда нужна неподвижная подложка: титульный кадр заезда, фон под набор индикаторов, картинка-заставка. Источник-картинка даёт ровно это — статичное изображение, поверх которого работают те же слои и индикаторы, что и над видео.

Как добавить изображение

Так же, как видео и треки, — через папку проекта:

1. Скопируйте файл изображения (.jpg, .png и т.п.) в папку проекта или подпапку.
2. При очередном сканировании Velitask добавит в дерево (вкладка Проект) узел источника-картинки с миниатюрой.
3. Фоновой задачей прочитаются размеры изображения (ширина и высота). Время начала источника берётся из даты изменения файла, а длительность фиксированная — 60 секунд. EXIF и параметры съёмки не читаются.

Файл остаётся в папке проекта — Velitask ссылается на него по месту.

Работа с источником-картинкой

• Двойной клик по узлу открывает редактор — тот же холст Mixel'а, что и для видео, но в основе лежит неподвижный кадр.
• Поверх картинки добавляются любые индикаторы и фигуры (см. Редактор Mixel'а).
• В дереве проекта источник показывается с миниатюрой — Velitask рисует её через композицию Mixel'а.

Экспорт

Источник-картинку можно выгрузить:

• как изображение (один кадр с наложенными индикаторами);
• как видео — статичная картинка с оверлеями (длительность берётся из периода источника, по умолчанию 60 секунд; например, заставка перед заездом).

Любой экспорт попадает в Журнал рендеров.

Связанные разделы

• Поддерживаемые форматы — какие растровые форматы читаются.
• Редактор Mixel'а — наложение индикаторов на картинку.
• Экспорт изображения — сохранить кадр в PNG.

Решение проблем

• Изображение не появилось в дереве. Проверьте, что формат поддерживается (основные растровые форматы). При проблеме посмотрите лог приложения (%USERPROFILE%\.velitask\logs\velitask.log).
• Неверное время источника. Время начала источника-картинки берётся из даты изменения файла, поэтому может не совпадать с реальным моментом съёмки. Если время важно для синхронизации, задайте его вручную через Профиль устройства.

Панель «Проект»

Левая вкладка Проект — это дерево всех источников и сенсоров проекта. Дерево отражает содержимое папки проекта: что лежит в папке (видео .mp4/.mov, GPX, изображения, телеметрия .tmg), то и показано. Двойной клик по узлу открывает соответствующий редактор.

Зачем это нужно

Все данные проекта (видео, GPX, изображения, телеметрия) Velitask хранит как файлы в папке проекта и показывает их источниками в одном дереве. Из этого дерева вы:

• видите всё, что есть в проекте, в одном месте;
• быстро открываете данные для просмотра и редактирования;
• создаёте по источнику таймлайн.

Состав дерева задаётся через файловую систему: добавить, удалить, переименовать или сгруппировать источники по папкам — значит сделать это с файлами в папке проекта (см. Импорт видео). Velitask подхватывает изменения при автоматическом сканировании.

Как устроено дерево

Узлы дерева:

У узлов есть собственная иконка по типу.

Что делается в дереве, а что в папке проекта

То есть состав проекта вы меняете в файловой системе, а дерево — это его «зеркало» плюс несколько команд открытия.

Иконки и миниатюры

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

Открытие узла

• Источник (видео, GPX, изображение, телеметрия) — двойной клик или Enter открывает редактор Mixel'а.
• Сенсор — двойной клик или Enter открывает таблицу данных сенсора.

Контекстное меню

Правый клик по узлу открывает контекстное меню. Набор пунктов:

• Информация — показать сводку по источнику (тип, время, длительность, привязанный Профиль устройства).
• Привязать к устройству... — привязать к источнику Профиль устройства.
• Создать таймлайн — создать таймлайн по выбранному узлу. Доступно для источника, папки и корня проекта; для сенсоров — нет.

Слой в Mixel создаётся из панели Индикаторы (см. ниже).

Связанные разделы

• Импорт видео, Импорт GPX — как наполнить дерево.
• Сенсорная телеметрия — про сенсоры внутри источников.
• Редактор Mixel'а — как собрать композицию из источников.
• Синхронизация времени — про Профили устройств.

Синхронизация времени

Чтобы цифры в индикаторах совпадали с тем, что происходит на видео, у каждого источника должен быть правильный Профиль устройства. Этот раздел — практика: куда смотреть, как править, как проверять.

Зачем это нужно

Если индикатор скорости показывает «37 км/ч», а на видео человек стоит — значит сдвинуто время одного из источников. Velitask живёт в едином UTC, но «правильность» этого UTC зависит от того, насколько корректны Профили устройств, через которые сырое время приводится к UTC.

См. Модель времени для теории.

Где и что настраивать

Все Профили — на панели Устройства в левой части окна. Каждый Профиль — отдельная карточка; двойной клик по карточке открывает редактор устройства.

Типичные конфигурации

Видео с экшен-камеры

Камеры пишут локальное время по своим внутренним часам. Спрашивайте себя:

• На какой часовой пояс камера была настроена? — это значение в поле tz.
• Били часы на сколько-то секунд? — это смещение.

Проверка: возьмите кадр с привязкой к чему-то объективному (старт по сигналу, проезд через известную точку), сравните с тем же моментом из GPX. Несовпадение в секундах → крутите смещение. Несовпадение в часах → крутите часовой пояс.

GPX-трек

В подавляющем большинстве — UTC, смещение 0. Не трогайте, если не уверены, что устройство пишет иначе.

Несколько источников от одного устройства

Если у вас три ролика с одной GoPro, удобно один Профиль «GoPro Hero 11» назначить всем трём. Привязку делайте к общей родительской папке (или корню) через диалог «Привязать к устройству» — тогда все вложенные ролики унаследуют Профиль по цепочке, и правка одной карточки коснётся всех роликов. Чаще всего Velitask распознаёт такие ролики сам по подсказкам авто-распознавания.

Сценарий синхронизации

1. Импортируйте видео и GPX (см. Первый проект).
2. Откройте панель Устройства. При импорте Velitask автоматически создаёт Профиль по умолчанию на корень для каждого типа источника (отдельный — для видео, отдельный — для GPX), а конкретные источники привязывает по подсказкам авто-распознавания. Отдельный Профиль под источник создаётся только когда метаданные дали осмысленное имя устройства.
3. Для GPX оставьте UTC, смещение 0.
4. Для видео:
   • Поставьте часовой пояс камеры (тот, в котором стояли её часы при съёмке).
   • Смещение пока 0.
5. Положите в Mixel слои Video и Speed (текст) (со скоростью из GPX-сенсора).
6. Найдите момент, когда вы можете точно сравнить: на видео виден стоп, спидометр на GPX тоже падает в ноль.
7. Если стоп на видео и ноль скорости в GPX расходятся на N секунд — впишите смещение в Профиль видео. Знак подбирайте по подсказке поля: часы спешат → отрицательное значение, отстают → положительное. Если не угадали направление — сдвиг увеличится; тогда поменяйте знак.
8. Подтвердите изменение и проверьте ещё раз. При необходимости подправьте.

Групповая синхронизация

Профили не копируются — один и тот же Профиль привязывается к нескольким узлам. Когда настроен Профиль камеры, привяжите его к общей папке (или корню) через диалог «Привязать к устройству»: все вложенные источники этого типа унаследуют Профиль по цепочке. Снять привязку можно кнопкой «✕ удалить привязку» в цепочке блока «Корректировка времени».

Проверка после правки

• Сместить курсор на разные участки таймлайна — убедиться, что цифры идут в ногу с видео.
• На длинных треках обычно достаточно проверить начало и конец. Если в обеих точках совпадает, в середине почти всегда тоже.

Связанные разделы

• Модель времени — теория, без которой непонятно, что мы крутим.
• Импорт GPX, Импорт видео — что попадает в дерево.
• Решение проблем — частые случаи рассинхронизации.

Решение проблем

• Сдвиг ровно час (или N часов). Это часовой пояс. Камера была на другом часовом поясе, чем вы выставили в Профиле. Поставьте правильный часовой пояс, смещение оставьте 0.
• Сдвиг произвольное число секунд. Часы устройства неточные. Подгоняйте смещение.
• Сдвиг разный в разных частях видео. Скорее всего, во время съёмки часы заметно «плыли» — типично для старых камер. Полностью устранить эту проблему через Профиль не получится; либо использовать только часть видео, либо принять погрешность.
• GPX и видео идеально совпадают на старте, но в конце расходятся. Тот же случай — дрейф часов. Особенно у дешёвых GPS, где время не подтягивается к спутникам.

Редактор Mixel'а

Mixel — главный редактор композиции. Здесь вы добавляете слои, привязываете их к источникам, двигаете и масштабируете, проигрываете и проверяете результат.

Зачем это нужно

Все, что попадёт в финальное видео, проходит через Mixel: видеослой снизу, индикаторы поверх. Редактор Mixel'а — это не отдельное окно, а сам центральный плеер Velitask: то, что вы видите при запуске, и есть он.

Главные элементы

Добавление слоя

Слои добавляются из каталога индикаторов в панели «Индикаторы». Это единственное место, откуда в Velitask что-то перетаскивается на холст; перетаскивания источников из дерева «Проект» на холст нет.

Кнопка «Добавить» в панели «Слои» просто открывает панель «Индикаторы» — выбор и добавление происходят там.

Перетаскиванием

1. Откройте панель «Индикаторы».
2. Найдите нужный индикатор (например, Спидометр).
3. Перетащите его на холст. Drop-цель — только холст; перетаскивания в список слоёв нет.
4. Velitask создаст слой и откроет его свойства справа.

Через контекстное меню каталога

Правый клик по индикатору в панели «Индикаторы»:

• «Добавить на миксель» — добавить в корень Mixel'а;
• «Добавить в выделенный слой» — добавить внутрь выделенного слоя. Пункт доступен, только когда выделен слой-индикатор того же типа, что и добавляемый.

После того как слой создан, свяжите его с нужным источником в свойствах (см. ниже).

Привязка к источнику

Слою-индикатору обычно нужен сенсор источника. Это поле показывается в свойствах. Для большинства типов:

• Один индикатор — один сенсор. Например, Спидометр связан с одним сенсором скорости.
• Некоторые индикаторы могут принимать несколько сенсоров (например, Карта + трек + опционально маркер).

Если источник не задан, индикатор показывает заглушку или «—».

Перемещение и масштабирование

В свойствах слоя — координаты, ширина и высота. Способы:

• Двигать прямо на холсте (drag-and-drop).
• Менять размер за угловые / краевые маркеры.
• Точно вводить значения в свойствах: поля x, y, Ширина, Высота — числовые поля со стрелками (можно ввести число или подкрутить ±).
• Включать привязку к якорям (ставить «к нижнему правому углу холста с отступом 24 px»).

Блок «Положение» всегда находится внизу панели свойств — под именем слоя и параметрами индикатора.

Большинство величин задаётся либо в пикселях, либо в процентах от холста. Проценты удобны, если вы планируете экспортировать в разных разрешениях — слой автоматически масштабируется.

Порядок, имя и вложенность слоёв

Правый клик по слою в панели «Слои» открывает контекстное меню. Кроме скинов и удаления в нём есть:

Имя слоя. В списке слой показывается под своим именем, если вы его задали, иначе — как «<тип> #<короткий код>» (например, «Спидометр #a1b2c3»). Переименовать слой можно в поле «Имя» вверху панели свойств; пустое имя возвращает автоматическое.

Вложенность. Новый индикатор добавляется внутрь выделенного слоя-индикатора, если он выбран в дереве, — иначе в корень Mixel'а. Так можно собирать составные блоки: например, поместить текст и иконку внутрь общего контейнера. В списке слоёв это видно как вложенные узлы.

Скорость воспроизведения

В панели свойств плеера есть поле «Скорость» — скорость воспроизведения и экспорта (числовое поле со стрелками, по умолчанию 1.0). Значения больше 1 ускоряют ролик (например, 2.0 — вдвое быстрее), меньше 1 — замедляют.

Когда скорость отличается от 1.0×, на плеере появляется бейдж с текущим значением. Скорость учитывается и при экспорте, но с одним ограничением: при скорости ≠ 1.0× звук не экспортируется (см. Экспорт видео).

Скины слоя

Правый клик на слое-индикаторе → подменю «Скин» показывает встроенные и пользовательские варианты оформления. Один клик — и весь набор визуальных свойств (цвета, обводка, прозрачность) меняется одновременно. Подробнее — в Индикаторы и плагины → Скины индикаторов.

Слой видео

Видеослой особый: его кадр меняется в зависимости от текущего UTC-времени и Профиля устройства. На таймлайне вне диапазона видеоисточника слой показывает чёрный фон или пустоту (зависит от настройки).

Несколько видеослоёв можно положить рядом — например, картинка-в-картинке (PiP) или сравнение двух камер.

Сохранение

Mixel сохраняется как часть проекта: все ваши перестановки, свойства слоёв, настройки индикаторов пишутся в базу проекта. Сохранение не автоматическое — изменения записываются командой «Файл → Сохранить» (или Ctrl+S). Пока есть несохранённые изменения, пункт «Сохранить» активен; после записи он снова гаснет.

Если нужно переиспользовать композицию в других проектах, экспортируйте её как .vttp-шаблон через «Файл → Экспорт → Шаблон...». Обычная работа в редакторе и JSON-шаблон описывают одну и ту же композицию: редактор меняет её визуально, а JSON — как структуру. Подробнее: Mixel JSON и шаблоны.

Связанные разделы

• Mixel и слои — теоретическая часть.
• Индикаторы и плагины — что лежит в каталоге.
• Сенсорная телеметрия — на каких данных работают индикаторы.
• Экспорт видео — что Mixel превращается в файл.
• Mixel JSON и шаблоны — экспорт и применение .vttp.
• Макеты Mixel в JSON — точная настройка размещения слоёв в .vttp.

Редактор БД

Редактор БД — табличный просмотр сенсорных атомов проекта. Открывается на сенсоре во вкладке «Таблица сенсоров»: показывает строки с метками времени и значениями, позволяет переключать источник/сенсор, режим времени и листать страницы.

Зачем это нужно

Большинство пользователей работают с сенсорами через индикаторы — не задумываются о том, что под капотом таблица. Но иногда нужно «заглянуть в данные»: проверить, что импорт не потерял точки; найти выброс скорости; посмотреть, в какой момент времени GPX перешёл из движения в стоп.

Для всего этого есть Редактор БД — отдельная вкладка проекта «Таблица сенсоров».

Как открыть

• Двойной клик по сенсору в дереве источников.
• Выбор сенсора в дереве и нажатие Enter.

Откроется вкладка «Таблица сенсоров» с таблицей данных выбранного сенсора. На проект используется одна такая вкладка: при открытии другого сенсора она переключается на новую пару «источник + сенсор».

Главные элементы окна

Режим времени и размер страницы запоминаются между сеансами. Кнопка ⟲ сбрасывает настройки колонок (единицы, ширины, сортировку) для текущего типа сенсора.

Колонки таблицы

Колонки зависят от типа сенсора. Общие для всех:

Дополнительные — по типу:

Подробнее — Каталог сенсоров.

Что можно делать

Таблица предназначена только для просмотра: редактирование ячеек и удаление строк выполняется в Редакторе атома сенсора, а не в самой таблице.

Связанные разделы

• Сенсорная телеметрия — что такое атом сенсора.
• Редактор атома сенсора — открывается из таблицы для конкретной строки.
• Каталог сенсоров — все типы и колонки.

Редактор атома сенсора

Редактор атома сенсора показывает одну точку сенсора (одну строку из БД) рядом с превью Mixel'а в этот момент. Удобно, когда нужно понять, как именно одна точка влияет на индикаторы и видео.

Зачем это нужно

Просмотр в Редакторе БД показывает данные «в таблице». Но иногда хочется увидеть, что именно в это мгновение покажет Mixel. Например:

• Посмотреть, как конкретное значение атома выглядит в кадре и в индикаторах.
• Понять, в какую точку трека попадает конкретный атом.
• Проверить, что импортированный атом действительно соответствует фрагменту видео.

Редактор атома сенсора — это маленький Mixel-плеер, привязанный к выбранному атому.

Это режим просмотра. Значения атома пока только показываются — изменить их прямо в форме нельзя (редактирование запланировано в следующей версии). Поэтому редактор используется для анализа, а не для исправления данных.

Как открыть

В Редакторе БД выберите строку в таблице и:

• сделайте по ней двойной клик, либо
• нажмите Enter.

Откроется вкладка с двумя половинами:

• Слева: форма с полями атома (только просмотр).
• Справа: превью Mixel'а в момент времени этого атома.

Что внутри

Левая половина — форма атома

• Поля по типу сенсора (например, широта/долгота для координат, значение мощности для Watt).
• Подписи полей — это локализованные русские заголовки колонок (те же, что в таблице Редактора БД), а единицы и формат значений берутся из настроек той же таблицы.
• Все поля доступны только для чтения — значения показываются, но не редактируются.

Навигация по атомам

Внизу вкладки расположен футер с кнопками ‹ и › — они переходят к предыдущему / следующему по времени атому того же сенсора. Рядом футер показывает статус текущей строки в виде #<id> · <таблица>.

При переходе превью справа само перематывается на момент времени нового атома.

Правая половина — превью Mixel'а

Это полноценный мини-плеер Mixel'я:

• Холст с теми же слоями, что и в основном Mixel'е проекта (или с упрощённым набором — это зависит от настроек превью).
• Кнопки воспроизведения: в начало, предыдущий кадр, Воспроизвести / Пауза, следующий кадр, в конец.
• Слайдер и поля даты/времени — позволяют поставить курсор в нужную точку в окрестности атома.
• Колесо мыши над холстом перематывает по одному кадру (с зажатым Shift — на 10 кадров).

В верхней панели превью (справа) есть кнопка Сохранить и чекбокс Автосохранение. Они относятся к самому превью-Mixel'ю, а не к значению атома: запоминают, как именно настроено превью (слои, их параметры). Если включить Автосохранение, изменения превью сохраняются автоматически с небольшой задержкой.

«Скопировать главный микцель»

В верхней панели превью есть кнопка Скопировать главный микцель. Она заменяет превью Mixel'а на копию главного — полезно, если вы хотите видеть атом в контексте полной композиции, а не упрощённой превью-схемы.

Типичный сценарий

1. В Редакторе БД нашли подозрительный атом (например, скорость 200 км/ч).
2. Двойной клик (или Enter) → открыли его в Редакторе атома сенсора.
3. В правом превью видите соответствующий кадр и индикаторы.
4. Видите: на видео велосипед стоит, в индикаторе всё равно 200 км/ч — выброс GPS.
5. Кнопками ‹ / › переходите к соседним атомам и сравниваете их значения, чтобы понять масштаб выброса.
6. Запоминаете проблемный атом, чтобы вернуться к нему позже — исправление данных выполняется отдельно (см. Сенсорная телеметрия).

Связанные разделы

• Редактор БД — открывается до этого редактора.
• Сенсорная телеметрия — что такое атом.
• Mixel и слои — что показывает превью.

Экспорт видео

Готовый Mixel сохраняется в видеофайл через Файл → Экспорт → Видео → Видео.... Поддерживаются H.264 (MP4) и QTRLE (MOV); пункт «ProRes (MOV)» по факту тоже даёт QTRLE-MOV. Все кадры рендерятся через FFmpeg в фоновой задаче.

Зачем это нужно

Финальный смысл проекта — получить файл, который можно отправить друзьям, выложить в YouTube или показать на телевизоре. Velitask собирает видеофайл из Mixel'а: видеослой + все индикаторы поверх него, плюс звук исходного видео.

Запуск экспорта

1. Откройте проект и собранный Mixel.
2. Файл → Экспорт → Видео → Видео...
3. Появится диалог «Экспорт видео» с настройками.
4. Заполните параметры (см. ниже) и нажмите OK (или Отмена, чтобы закрыть без экспорта). После OK выбирается файл сохранения.
5. Прогресс отобразится на вкладке Задачи. По завершении — готовый файл в указанной папке.

Параллельно можно работать в Velitask: экспорт идёт в фоне.

Параметры диалога

Диапазон

Можно экспортировать только часть Mixel'а — например, один заезд из всего проекта. Это смещения от начала Mixel'а, а не абсолютное UTC-время; отдельного поля длительности нет.

Кодек и контейнер

Пресет (качество) и FPS

Отдельных полей разрешения и пресетов вида low/medium/high в диалоге нет. Разрешение итогового файла равно размеру Mixel'а (базовый канвас — Full HD 1920×1080). «Пресет» в секции «Видео» — это набор параметров качества для H.264:

Пресеты влияют на H.264; для QTRLE/ProRes-секций набор полей другой (без потерь). FPS задаётся спиннером (допустимый диапазон 0.1–60), по умолчанию — частота кадров из настроек проекта. Чем выше fps, тем дольше экспорт и больше файл.

Аудио

Звук включается чекбоксом «Включить звук» (для экспорта видео он включён по умолчанию). Пока чекбокс снят, выбор пресета и его поля недоступны. Опции «без звука» в списке пресетов нет — за это отвечает сам чекбокс.

Про «Копию». Диалог проверяет совместимость и под пресетом показывает подсказку: либо «✓ Совместимо — будет использован stream copy», либо «⚠ Авто-fallback на AAC Medium: …» с причиной (нет включённых аудио-источников, несколько источников нужно смикшировать, громкость слоя ≠ 1.0). На практике, даже когда показано «совместимо», звук всё равно кодируется в AAC Среднее: реальный stream-copy в пайплайне экспорта не реализован.

Если задана скорость воспроизведения, отличная от 1.0× (см. Редактор Mixel'а → Скорость воспроизведения), звук не экспортируется — чекбокс «Включить звук» отключается, и в диалоге появляется предупреждение «Скорость изменена — звук не экспортируется».

История экспортов

Каждый запуск экспорта (видео, отдельного слоя, изображения) записывается в Журнал рендеров: там видно, что и с какими настройками отрендерено, можно открыть результат и повторить рендер. Записи журнала затем используются как элементы при сборке таймлайнов для монтажных программ.

Как работает экспорт

1. Velitask проходит по таймлайну от «Начала» до «Конца» с шагом 1/fps.
2. Для каждого кадра собирает Mixel: видеоисточники, индикаторы, фигуры — всё рисуется в одно изображение.
3. Изображение передаётся выбранному кодеку (через FFmpeg).
4. Звук берётся из аудио-источника и кодируется в AAC (выбранным битрейтом); stream-copy не применяется.
5. Готовые кадры и звук пакуются в контейнер (MP4 или MOV).

Скорость экспорта зависит от:

• Разрешения и fps.
• Количества и сложности слоёв (особенно карты и графики).
• Производительности CPU (декодирование и кодирование — программные).
• Скорости диска (много чтения исходного видео и записи итогового файла).

Связанные разделы

• Пресеты экспорта видео — сохранить набор настроек кодирования.
• Поддерживаемые форматы — детали по входным/выходным форматам.
• Экспорт изображения — для постера или превью.
• Решение проблем — если экспорт падает или зависает.

Решение проблем

• Экспорт «застрял» на N%. Откройте логи (%USERPROFILE%\.velitask\logs\velitask.log). Иногда FFmpeg споткнулся на повреждённом фрагменте исходного видео.
• В файле нет звука. Проверьте, что установлен чекбокс «Включить звук». Если он снят автоматически — вероятно, у Mixel'а задана скорость воспроизведения ≠ ×1: при такой скорости звук не экспортируется. Звук всегда кодируется в AAC, поэтому несовместимости с MP4 быть не должно.
• Размер файла очень большой. Скорее всего вы выбрали QTRLE (или «ProRes», который тоже даёт QTRLE-MOV). Это нормально — это мастер-кодек без потерь. Для отправки/публикации используйте H.264 (mp4).
• Экспорт идёт слишком долго. Уменьшите fps или выберите более «лёгкий» пресет качества (Эконом). Разрешение определяется размером Mixel'а — уменьшите канвас, если нужно. Карты и графики — самые «тяжёлые» индикаторы; временно отключите их, если нужно быстро.

Экспорт изображения

Один кадр Mixel'а сохраняется как PNG через Файл → Экспорт → Картинка.... Полезно для постеров, превью к видео и социальных сетей.

Зачем это нужно

Иногда не нужен видеофайл — нужна одна красивая картинка с наложенными индикаторами:

• постер к видео для YouTube;
• иллюстрация для блога;
• кадр для отчёта или презентации;
• быстрый «снимок» интересного момента.

Экспорт изображения делает именно это: рендерит Mixel в один момент времени и сохраняет в файл.

Как сделать

1. Установите курсор таймлайна на нужный кадр.
2. Файл → Экспорт → Картинка...
3. В диалоге Сделать снимок укажите путь и имя выходного файла (формат — только PNG).
4. Нажмите Сохранить.

Картинка рендерится в нативном размере Mixel'а. Снимок сохраняется синхронно, прямо в момент нажатия; отдельная задача в разделе Задачи не создаётся.

Снимок рендерится без фона Mixel'а, поэтому итоговый PNG может содержать прозрачные области.

Связанные разделы

• Экспорт видео — для видеофайла.
• Поддерживаемые форматы — детальный список.
• Редактор Mixel'а — настройка композиции перед экспортом.

Пресеты экспорта видео

Пресет экспорта — это готовый набор параметров кодирования, который выбирается из списка в диалоге Файл → Экспорт → Видео.... Пресетов два независимых вида: пресет видео (качество H.264) и пресет аудио. Они выставляют сразу все параметры соответствующего кодека одним выбором.

Что такое пресет в Velitask

Пресеты в Velitask — это встроенный список готовых наборов, а не сохраняемые пользователем именованные конфигурации. Нельзя завести собственный пресет «YouTube 1080p» и сохранить его под именем — кнопки «Сохранить пресет» и поля для имени в диалоге нет.

Вместо этого вы выбираете подходящий пункт из встроенного списка, а если ни один не подходит — переходите в режим «Свои настройки» и правите параметры вручную.

Не путайте пресеты экспорта с шаблонами Mixel'а. Пресет экспорта отвечает за то, как кодировать видеофайл. Шаблон Mixel'а отвечает за то, какие слои и индикаторы находятся в композиции. Подробнее о шаблонах композиции: Mixel JSON и шаблоны.

Два списка пресетов

В диалоге экспорта есть два отдельных поля «Пресет» — в секции «Видео» и в секции «Аудио». Они выбираются независимо друг от друга.

Пресеты видео

Все встроенные пресеты видео — это H.264. Они отличаются балансом «качество / размер файла» (внутренне — параметр CRF и скорость кодирования x264):

Пресеты аудио

Пресет «Копия» работает только когда исходный звук можно передать без перекодирования. Если это невозможно (например, нет включённого аудио-источника, источников несколько и нужен микс, либо у слоя изменена громкость), диалог покажет подсказку, а при экспорте автоматически переключится на AAC Среднее.

Как пользоваться

1. Откройте диалог Файл → Экспорт → Видео...
2. В секции «Видео» выберите нужный пресет в списке «Пресет». Параметры кодека заполнятся автоматически.
3. При желании уточните «Кодек» и «Частота кадров» — это отдельные поля рядом, в пресет видео они не входят.
4. В секции «Аудио» выберите пресет звука (либо снимите галочку «Включить звук», если звук не нужен).
5. Нажмите OK, чтобы запустить экспорт, или Отмена.

Режим «Свои настройки»

Если выбрать пункт «Свои настройки», под списком раскрываются поля с конкретными параметрами кодека (для видео) или звука (для аудио), доступные для ручного редактирования.

Переключение в этот режим происходит и автоматически: как только вы вручную меняете любое поле параметров кодека, выбор в списке «Пресет» сам переключается на «Свои настройки» — чтобы было видно, что значения больше не соответствуют готовому пресету.

Что входит в пресет, а что нет

Запоминание выбора

Velitask запоминает последний выбранный пресет видео и аудио (а также ручные значения для «Свои настройки» и состояние галочки «Включить звук»). Эти данные хранятся в настройках текущего проекта (SQLite-таблица settings проекта), поэтому при следующем экспорте того же проекта диалог откроется с прежним выбором.

Это не общая на все проекты настройка: в другом проекте память выбора своя.

Связанные разделы

• Экспорт видео — детали параметров.
• Mixel и слои — что именно попадает в экспорт.
• Mixel JSON и шаблоны — шаблоны композиции .vttp.
• Поддерживаемые форматы.

Журнал рендеров

Кратко: Журнал рендеров — это история всех экспортов проекта (видео, слои, изображения). Открывается через Инструменты → Журнал рендеров. Из журнала можно открыть результат, скопировать путь, перерендерить запись теми же параметрами и удалить ненужное.

Зачем это нужно

Когда вы экспортируете оверлеи и композиции по отдельности, файлов быстро становится много: спидометр одного заезда, карта другого, целый Mixel третьего. Журнал рендеров собирает их в одну таблицу — видно, что, когда и с какими настройками было отрендерено, где лежит файл и всё ли в порядке.

Журнал — ещё и фундамент для таймлайнов: именно его записи становятся элементами при сборке таймлайна для монтажной программы.

Как пользоваться

1. Откройте проект.
2. Инструменты → Журнал рендеров — откроется вкладка с таблицей записей. Если вкладка уже открыта, повторный вызов просто активирует её.
3. Каждый экспорт (видео, слой, изображение) автоматически добавляет строку в журнал.
4. Двойной клик по строке открывает папку с файлом в проводнике.

Вкладка восстанавливается вместе с проектом — журнал не нужно открывать заново каждый раз.

Панель инструментов

Колонки таблицы

Время в журнале показывается в локальном поясе, а не в UTC, как в остальном приложении, — чтобы по часам было понятно, когда именно вы запускали рендер.

Панель деталей

Под таблицей — две части для выбранной записи:

• Превью слева: первый кадр результата. Для записей с прозрачностью (альфа-канал) фон рисуется шахматкой, чтобы прозрачные области были видны.
• Метаданные справа: заголовок вида «<индикатор> @ <источник>», полный путь к файлу, размер файла, разрешение, строка «FPS · кодек · alpha», размер исходного Mixel'а, позиция слоя внутри Mixel'а, время создания и завершения (в вашем часовом поясе).

Подписи полей на этой панели в текущей версии выводятся по-английски: File (путь), Size (размер файла), Resolution (разрешение), FPS/Codec (FPS и кодек), Source mixel (размер исходного Mixel'а), Position (позиция слоя), Created (создано), Finished (завершено).

Контекстное меню записи

Кнопка ⋮ в строке (или правый клик):

Пункты, работающие с файлом, недоступны, если файла нет на месте.

Повторный рендер

Render again удобен, когда вы поправили слой и хотите пересобрать тот же оверлей, не настраивая экспорт заново. Velitask:

1. Откроет редактор исходного источника.
2. Найдёт нужный слой по его идентификатору.
3. Повторно экспортирует его с прежними параметрами — тот же файл, кодек, частота кадров и поддержка прозрачности.

Результат перезаписывает ту же запись журнала, а не создаёт новую. Тот же повтор доступен прямо из дерева слоёв редактора Mixel'а — пункт Экспорт… в контекстном меню слоя (для слоёв верхнего уровня, у которых уже есть история рендеринга).

Откуда берутся записи

Журнал наполняет любой экспорт из редактора источника:

• Экспорт видео целой композиции;
• экспорт отдельного слоя;
• Экспорт изображения.

Связанные разделы

• Таймлайны — собрать записи журнала в таймлайн для монтажной программы.
• Экспорт видео — откуда появляются записи.
• Редактор Mixel'а — повторный рендер из дерева слоёв.

Решение проблем

• Строка со значком ✗ (ошибка). Откройте логи (%USERPROFILE%\.velitask\logs\velitask.log) — обычно причина в исходном видео или нехватке места. Поправьте и используйте Рендер заново.
• Пункты «Открыть файл» / «Открыть папку» серые. Файл удалён или перемещён. Запись можно убрать через Удалить запись или перерендерить через Рендер заново.
• Время не совпадает с таймлайном проекта. Это нормально: журнал показывает локальное время запуска рендера, а Mixel работает в UTC.

Таймлайны

Кратко: Таймлайн собирает готовые рендеры и видео-источники в общем временном окне и выгружает их в FCPXML, XML (FCP7) или OTIO — чтобы открыть всю раскладку в DaVinci Resolve, Final Cut Pro, Premiere и других монтажных программах. Открывается через Инструменты → Список таймлайнов.

Зачем это нужно

Velitask хорошо рендерит отдельные оверлеи и целые композиции, но финальный монтаж многие делают в профессиональном редакторе. Чтобы не расставлять там клипы и оверлеи вручную, Velitask переносит всю раскладку: какие элементы, где по времени, на какой дорожке, в какой позиции и размере. В монтажной программе вы получаете готовый таймлайн, остаётся только доработать.

Элементы таймлайна берутся из Журнала рендеров и видео-источников проекта.

Как создать таймлайн

1. В панели Проект правый клик по источнику или папке → Создать таймлайн.
2. Velitask вычислит временное окно по источнику и подтянет в него пересекающиеся записи журнала рендеров и видео-источники.
3. Откроется вкладка редактора таймлайна — настройте состав и экспортируйте.

Все ваши таймлайны хранятся в проекте; список открывается через Инструменты → Список таймлайнов.

Список таймлайнов

Вкладка Инструменты → Список таймлайнов показывает все таймлайны проекта.

• Сверху — поле Поиск (фильтр по имени, подсказка «по имени таймлайна…»), кнопка Обновить и счётчик «{n} записей».
• Таблица: Имя, Старт, Длит., Items (число элементов), Создан, Обновлён.
• Под таблицей — блок Детали выбранного таймлайна с деталями выбранной строки: Output (путь экспорта), Items, Старт, Длительность, Canvas, Создан, Notes, Обновлён.

Двойной клик по строке открывает таймлайн. Правый клик даёт меню:

Редактор таймлайна

Панель инструментов

Окно таймлайна

Две таблицы

Окно делится на две таблицы перетаскиваемым разделителем (его положение запоминается).

Видео-источники в окне — видео, попавшие в окно:

• галочка в строке (и общий переключатель в шапке) — включить/исключить видео из экспорта;
• колонки: превью, Имя, Время видео, Offset (смещение от начала окна), Длит., Дорожка (дорожка V1, V2…);
• переключатель «Включать отдельные дорожки для видео-источников» управляет тем, попадут ли видео в экспорт отдельными дорожками.

Items в окне таймлайна — рендеры (оверлеи) из журнала, попавшие в окно:

• галочка в строке (и общий переключатель в шапке) — включить/исключить элемент;
• колонки: превью, Индикатор (название слоя; «— (весь mixel)» для рендера целой композиции; «🗑 запись удалена», если запись удалена), Время видео, Offset, Длит., Позиция, Размер, Lane, Статус (✓ всё на месте, «⚠ нет файла» нет файла, «🗑 запись удалена» запись удалена).

Строки с удалённым источником или пропавшим файлом подсвечиваются. Снизу — счётчик «{items} items · {videos} видео».

Экспорт таймлайна

1. Нажмите Run export → — откроется диалог сохранения Сохранить таймлайн.
2. Формат определяется расширением файла:

При первом экспорте предлагается имя с расширением .xml, фильтр XML (FCP7 xmeml) стоит первым. Последний использованный формат запоминается и в следующий раз предлагается первым.

После экспорта папку с файлом открывает кнопка Открыть папку.

По умолчанию выбран XML (xmeml), потому что DaVinci Resolve надёжнее всего импортирует именно этот формат — у FCPXML встречаются проблемы с позиционированием клипов, чьё разрешение не совпадает с разрешением секвенции.

Импорт в монтажную программу

После экспорта импортируйте файл в свой редактор (например, в DaVinci: File → Import → Timeline). Если программа сообщает, что часть клипов «не найдена» (offline), укажите ей папку с исходными видео — после этого она сама подтянет остальные файлы. В DaVinci можно один раз добавить папки исходников в Preferences → Media Storage, и дальнейшие импорты будут привязываться автоматически.

Сохранение

Таймлайн (имя, окно, заметки, состав элементов и видео, дорожки и позиции) хранится в проекте. Сохраняется по Ctrl+S и автоматически при экспорте.

Связанные разделы

• Журнал рендеров — откуда берутся элементы таймлайна.
• Экспорт видео — отрендерить оверлеи и композиции.
• Поддерживаемые форматы — детали по форматам обмена.

Решение проблем

• В монтажной программе клипы «offline» / не найдены. Это стандартное поведение при импорте обменных форматов: укажите папку с исходными видео при импорте либо добавьте её в Media Storage.
• Красная строка «⚠ нет файла» или «🗑 запись удалена». Рендер удалён из журнала или файл перемещён. Перерендерьте его из Журнала рендеров и обновите состав кнопкой ⟲ Обновить.
• FCPXML расставил клипы не на свои места. Используйте формат XML (FCP7 xmeml) — он предлагается по умолчанию и импортируется надёжнее.

Поддерживаемые форматы

Velitask добавляет в проект видео .mp4/.mov, GPS-треки в GPX, изображения в основных растровых форматах и телеметрию .tmg. На выход — H.264 в MP4, QTRLE в MOV, изображения в PNG.

Видео — на вход

В проект добавляются (распознаются сканером по расширению) только два контейнера:

Файлы в других контейнерах (.avi, .mkv, .webm, .flv, .mpeg, .ts, .mts/AVCHD и т.п.) Velitask в проект не добавит — их нужно сначала пересохранить (ремультиплексировать) в .mp4 или .mov любым видеоредактором.

Видео-кодеки

Декодирование внутри .mp4/.mov идёт через FFmpeg (поставляется в составе JavaCV). Набор поддерживаемых кодеков целиком определяется встроенной FFmpeg-сборкой — приложение его не валидирует и не ограничивает. Обычно доступны H.264 (AVC), H.265 (HEVC), VP8, VP9, AV1, ProRes, DNxHD, MJPEG, MPEG-2 и многие другие, но конкретный список зависит от версии сборки.

Аудио-кодеки

AAC, MP3, AC-3, Opus, Vorbis, PCM, FLAC.

Видео — на выход

Velitask кодирует через FFmpeg. Доступны:

Выбор контейнера определяется расширением выходного файла: .mp4 → H.264, .mov → QTRLE. Отдельного ProRes-кодера в текущей версии нет: пункт «ProRes» в диалоге экспорта фактически записывает тот же QTRLE-MOV (различие сохраняется только в журнале рендеров).

Аудио на выходе всегда кодируется в AAC. Пункт «Копия» означает попытку перенести звук без перекодирования, но в текущем конвейере экспорта он автоматически переводится в AAC, поэтому на практике звук в выходном файле — всегда AAC.

GPS-треки

Дополнительные поля GPX от Garmin (мощность, каденс, пульс) — читаются.

Телеметрия

Изображения

Карты

OpenStreetMap (тайлы 256×256, шаблон URL https://tile.openstreetmap.org/{z}/{x}/{y}.png). Альтернативные тайл-серверы — конфигурируются, но в стандартной поставке выбран только OSM.

Шаблоны Mixel'а

.vttp можно применить вручную или положить в папку шаблонов, чтобы Velitask использовал его как default-композицию для новых источников. Подробнее — Mixel JSON и шаблоны.

Связанные разделы

• Импорт видео, Импорт GPX.
• Экспорт видео, Экспорт изображения.
• Mixel JSON и шаблоны.
• Макеты Mixel в JSON.
• OSM-тайлы.

Каталог сенсоров

Сенсоры — это каналы данных в проекте. Под каждый тип Velitask хранит свой набор полей. В этом разделе — все поддерживаемые типы с единицами измерения и тем, откуда они берутся.

Зачем это нужно

Когда вы выбираете «источник данных» для индикатора Mixel'а или фильтруете строки в Редакторе БД, вы видите тип сенсора. Этот раздел — справочник: чего ждать от каждого типа.

Таблица типов

Velitask поддерживает 14 типов сенсоров. В дереве проекта каждый показывается под своим русским именем.

Тип Watt хранит напряжение и ток (voltage / amperage), а не готовое значение мощности. Тип Electric — отдельный, более полный: напряжение, ток и мощность с дельтами. Оба типа существуют независимо.

Поля атома

Каждый атом — это запись с временной меткой и значениями полей этого типа. Общие поля у всех типов:

Дополнительные поля по типам. В колонке «Поля модели» — всё, что хранится в проекте; в колонке «Видно в Редакторе БД» — колонки, которые реально показываются в таблице.

Единицы измерения

Глобальный выбор системы единиц (Настройки → «Единицы измерения») применяется ко всем индикаторам мгновенно:

Связанные разделы

• Сенсорная телеметрия — общая концепция.
• Импорт GPX — основной источник сенсоров.
• Редактор БД — где смотреть атомы.

Горячие клавиши

Сводка основных сочетаний клавиш в Velitask. На macOS вместо Ctrl используется Cmd.

Файл и проект

Настройки

Списки и деревья

Снятие выделения

Замечание

Точный набор сочетаний может незначительно отличаться от версии к версии. Если какое-то сочетание у вас не сработало — проверьте подсказку рядом с пунктом меню (Velitask показывает его в скобках).

Воспроизведением (старт/пауза, переход в начало и конец, шаг по кадрам) удобнее управлять кнопками плеера: соответствующих горячих клавиш в текущей версии нет.

Связанные разделы

• Знакомство с интерфейсом — где найти каждое из этих действий мышью.
• Редактор Mixel'а.

Частые вопросы (FAQ)

Короткие ответы на самые типичные вопросы. Если нужного нет здесь — заглядывайте в Решение проблем.

Velitask бесплатный?

Да. Это настольное приложение, скачиваемое со страницы velitask.com.

Какие данные Velitask отправляет в интернет?

Только запросы за OSM-тайлами (карта). Сами проекты, видео и треки никуда не уходят — они хранятся локально на вашем компьютере. Без интернета приложение работает, кроме скачивания новых фрагментов карты.

Где хранятся проекты?

В папке, которую вы выбрали при создании проекта. Внутри неё — база проекта с метаданными и сенсорами, а также сами видео и GPX. Velitask обращается к файлам по пути внутри папки проекта (имя файла и при необходимости вложенная подпапка) — ссылок на внешнее расположение нет, поэтому файлы должны лежать в папке проекта.

Сколько проектов могут быть открыты одновременно?

В текущей версии — один. Чтобы переключиться на другой проект, закройте текущий и откройте новый.

Можно ли использовать Velitask для авто / лодки / парапланов / бега?

Да. Концептуально не привязано к велосипеду — любая активность с GPS-треком и видео работает. Часть индикаторов (типа каденс) специфична для велосипеда, но они опциональны.

Что такое Mixel?

В Velitask Mixel — конечная композиция: холст со слоями, который вы видите в плеере и получаете при экспорте. Пользователь работает с Mixel'ом, добавляет в него слои и настраивает их свойства.

Чем плагин отличается от индикатора?

Плагин — внешний модуль (.jar-файл), который привозит с собой набор индикаторов. Индикатор — конкретный «виджет», который вы кладёте слоем в Mixel. То есть плагин — это поставщик, индикатор — единица в каталоге.

Можно ли работать с проектами Velitask на macOS / Linux?

Сейчас Velitask официально поддерживается только на Windows. Версии для macOS и Linux в планах; готовых установщиков пока нет.

Что будет с проектом, если я переименую исходный видео-файл?

Velitask ищет файл по сохранённому имени внутри папки проекта, поэтому после переименования источник перестанет открываться. Чтобы восстановить его, верните файлу прежнее имя в папке проекта и заново отсканируйте проект — отдельного UI для указания нового пути нет.

Velitask умеет монтировать видео (вырезать, склеивать, эффекты)?

Нет. Velitask делает наложения — индикаторы поверх видео, а монтаж не его задача. Сначала склейте видеомонтажом, потом положите готовый файл в папку проекта Velitask.

Можно ли сохранить шаблон Mixel'а с индикаторами и применять к новым проектам?

Да. Настройте Mixel в редакторе, затем выберите Файл → Экспорт → Шаблон... и сохраните .vttp. Такой шаблон можно применить вручную через Инструменты → Применить шаблон... или положить в папку шаблонов, чтобы Velitask использовал его для новых источников автоматически. Подробнее — Mixel JSON и шаблоны.

Сколько времени занимает экспорт?

Сильно зависит от длины ролика, разрешения, fps и сложности слоёв. Грубо: экспорт 5-минутного 1080p60 видео с типовым набором индикаторов на современном CPU занимает 5–15 минут.

Можно ли продолжить экспорт после ошибки?

Нет, экспорт всегда начинается с начала указанного диапазона. Если упало на 99% — придётся запустить заново, но можно сократить диапазон.

Поддерживает ли Velitask работу с несколькими камерами одновременно (multicam)?

В одном Mixel'е можно положить несколько видеослоёв (например, картинка-в-картинке). Полноценный multicam-монтаж с переключением между камерами — нет.

Где взять помощь, если что-то не работает?

• Решение проблем в этой документации.
• Логи: %USERPROFILE%\.velitask\logs\velitask.log.
• Сайт проекта velitask.com — там обычно есть контакты.

Решение проблем

Что делать, когда Velitask ведёт себя не так, как ожидалось. Список симптомов, причин и способов починки. Если ничего из перечисленного не помогает — соберите логи (см. в конце) и обратитесь за поддержкой.

Velitask не запускается

Импорт

Время и синхронизация

Подробнее — Синхронизация времени.

Карта

Mixel и индикаторы

Подробнее о правилах поиска и проверки шаблонов — Mixel JSON и шаблоны.

Экспорт

Производительность

Логи

Если ничего из перечисленного не помогает, понадобится лог:

• Файл лога: %USERPROFILE%\.velitask\logs\velitask.log.
• Что в нём: хронология событий приложения и ошибки.
• Что делать: перезапустите Velitask, повторите проблемное действие, скопируйте свежую часть лога в файл, отправьте в поддержку.

Сброс настроек приложения

Если приложение явно «сломалось» в плане настроек (тема, последний и недавние проекты, состояние панелей), важно знать, где эти настройки хранятся:

• Настройки интерфейса (тема, последний/недавние проекты, состояние панелей, пути из «Файлы и папки») хранятся не в .velitask, а в системном хранилище Java Preferences. На Windows это реестр в ветке HKEY_CURRENT_USER (узел com.velitask.desktop/1.0.0). Полный сброс этих настроек выполняет само приложение командой Edit → Reset Preferences (внутри вызывается VelitaskPrefs.resetPreferences()).
• Папка %USERPROFILE%\.velitask хранит логи (logs/) и пользовательские ресурсы, но не интерфейсные настройки. Её удаление чистит логи и ресурсы, но не сбрасывает тему/последний проект.

# Чистка логов и пользовательских ресурсов (НЕ сбрасывает тему/последний проект):
Remove-Item -Recurse "$env:USERPROFILE\.velitask"

Для полного сброса интерфейсных настроек используйте команду сброса в самом приложении (Edit → Reset Preferences) — после неё, возможно, потребуется перезапуск. Ни то, ни другое не трогает ваши проекты — они хранятся в выбранной вами папке проекта.

Связанные разделы

• Установка — про требования и проблемы установки.
• Знакомство с интерфейсом, Первый проект.
• Синхронизация времени — основной источник «непонятностей».
• Поддерживаемые форматы — если что-то не открывается.
• Mixel JSON и шаблоны — если не применился .vttp.
• Макеты Mixel в JSON — если слой оказался не там, где ожидалось.