lampaq-anime4k-plugin

Lampa Anime4K

Экспериментальный плагин для встроенного HTML5-плеера Lampa и совместимых сборок. Он использует WebGL2 и шейдеры Anime4K Restore CNN Soft M и Upscale CNN x2 S, чтобы улучшать изображение во время воспроизведения. Плагин добавляет canvas поверх видео и оставляет воспроизведение, звук и управление штатному плееру.

Обработка проверена в Lampaq пользователем. В Edge на тестовой странице с MSE-видео и структурой слоёв, моделирующей Lampa, проверены также воспроизведение, переключение, полноэкранный режим и возврат к исходному изображению при ошибках. Проверка субтитров и переходов в конкретной сборке Lampaq ещё необходима. Реальная производительность зависит от браузера, устройства, разрешения и источника.

Как работает

Плагин ожидает доступный HTML5 video, WebGL2 и расширение EXT_color_buffer_float. Кадры обрабатываются на устройстве пользователя. Ссылка blob: сама по себе не гарантирует доступ к кадрам. Доступ проверяется при загрузке кадра в WebGL.

В меню настроек плеера пункт Anime4K предлагает варианты Выключено, Быстрый и Восстановление. Выбор сохраняется между сеансами. В общих настройках Anime4K доступны переключатель и выбор режима.
Быстрый использует Upscale CNN x2 S. Восстановление сначала применяет Restore CNN Soft M, затем Upscale CNN x2 S. Для источника 1280×720 промежуточный результат 2560×1440 уменьшается до 1920×1080.
Выход ограничен 1920×1080 с сохранением пропорций и увеличением не более чем в 2 раза. Например, 854×480 становится 1708×960. Источник 1080p и более крупные источники пропускаются.
Оригинальный шейдер включает обработку, когда увеличение больше 1,2 по обеим осям. При меньшем увеличении отображается оригинал.
Во время буферизации, перемотки или скрытой вкладки отображается исходное видео. Обработка продолжается, когда снова доступен кадр.
Если показаны нативные дорожки субтитров браузера или нативное управление видео, плагин показывает оригинал, чтобы они оставались видимыми. Субтитры, которые сама Lampa рисует отдельным слоем, должны оставаться поверх canvas. Субтитры в конкретной сборке необходимо проверить.
При fullscreen контейнера плеера canvas находится внутри него. При fullscreen непосредственно элемента video и в режиме «картинка в картинке» используется оригинальное изображение.
При ошибке WebGL, отказе в доступе к кадрам, потере контекста или продолжительной перегрузке GPU canvas убирается. Плагин повторит попытку при новом источнике либо после выключения и повторного включения.

Размеры и состояние можно посмотреть в консоли браузера:

LampaAnime4K.status()

Поле version показывает загруженную версию, profile — выбранный режим. Значение mode: "anime4k" означает, что обработанный кадр выведен на canvas. Поля source и output содержат размеры. При mode: "original" поле reason объясняет причину. Сведения об ошибке также выводятся в консоль с префиксом [Lampa Anime4K].

Проверка в Lampaq

Запустите серию 720p, убедитесь, что она воспроизводится со звуком, затем включите плагин.
Проверьте LampaAnime4K.status(). Ожидается mode: "anime4k", source: "1280×720" и output: "1920×1080" для файла 1280×720. Сравните одну и ту же сцену с обработкой и без неё.
Проверьте паузу, перемотку, буферизацию, изменение масштаба плеера, полноэкранный режим, смену дорожки звука и видимость используемых субтитров.
Перейдите на следующую серию и закройте плеер. Убедитесь, что изображение не зависает, звук и управление работают, а обработка на новой серии включается автоматически.
Проверьте видео 1080p. Ожидается mode: "original". При ошибке или снижении плавности выключите улучшение и сохраните текст reason и сообщения консоли для диагностики.

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

Исходный код и лицензия

Исходный код плагина находится в plugin.src.js, шейдеры — в vendor/. Команда node build.mjs собирает готовый lampa-anime4k.js, а node build.mjs --check проверяет соответствие сборки исходникам.

Плагин распространяется под MIT. Шейдеры Restore CNN Soft M и Upscale CNN x2 S принадлежат проекту bloc97/Anime4K и содержат уведомление об авторских правах и лицензию MIT.

При реализации проверены публичные исходники Lampa, в частности API настроек, события плеера, HTML5-видео и структура плеера. Приложения на их основе могут отличаться.

This site is open source. Improve this page.