Initial commit: FT812 Viewer (reworked - no .XM/.XMZ)

Wild Commander plugin for JPG/PNG/DLS/DXP/AVI via the FT812 (EVE) chip.
XM/XMZ support (and the ESP32 audio-playback code it needed) has been
removed here so this plugin can be installed alongside xmplay
(https://git.alexkorochinskiy.ru/alex/xmplayer.git) without both
registering for the same extensions - see README.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-07 12:44:32 +03:00
co-authored by Claude Sonnet 5
commit 15f0d752f6
11 changed files with 1263 additions and 0 deletions
+62
View File
@@ -0,0 +1,62 @@
# FT812 Viewer
Плагин для Wild Commander (ZX Evolution / TS-Conf), показывающий изображения
и видео через графический чип FT812 (EVE) платы.
> ⚠️ **Это переработанная версия.** Стандартный (оригинальный) `ftview`
> дополнительно сам регистрируется на расширения `.XM` и `.XMZ` и
> проигрывает их через ESP32-сопроцессор. Из этой версии поддержка `.XM` и
> `.XMZ` убрана: воспроизведение модулей вынесено в отдельный плагин
> [xmplay](https://git.alexkorochinskiy.ru/alex/xmplayer.git), а у Wild
> Commander таблица "расширение → плагин" статическая и зашивается в
> заголовок при сборке — если поставить `xmplay` вместе со стандартным
> (не переработанным) `ftview`, оба будут претендовать на одни и те же
> расширения и конфликтовать. Ставить эту версию `ftview` вместе с `xmplay`,
> не стандартную.
## Требования
- ZX Evolution / TS-Conf с графическим чипом FT812 (EVE)
- Wild Commander
## Возможности
- `.JPG`, `.PNG` — просмотр изображений
- `.DLS` — воспроизведение "сырого" display list FT812 (уже скомпилированная
команда отрисовки, без разбора формата)
- `.DXP` — свой формат растрового изображения (заголовок с сигнатурой,
типом и размерами + данные)
- `.AVI` — воспроизведение видео через встроенный видеодекодер FT812
(`MediaFifo`, полноэкранно, со звуком)
## Управление
| Клавиша | Действие |
|---------|-------------------|
| PgDn | Следующий файл |
| PgUp | Предыдущий файл |
| Esc | Выйти |
## Установка
Скопировать `ftview.wmf` в каталог плагинов Wild Commander. Плагин сам
регистрируется на `.JPG`, `.PNG`, `.DLS`, `.DXP` и `.AVI`.
## Сборка
Нужен [SDCC](http://sdcc.sourceforge.net/) версии 4.0.0 (зафиксирована в
`build.bat`) и `hex2bin` — оба есть в тулчейне SDK ZX Evolution. Версия
SDCC важна: собранные другой версией `lib/ft812`/`lib/tsconf`/`lib/sdk`
дают несовместимый ABI (разная конвенция `sdcccall`) без явной ошибки
сборки — плагин просто виснет или ведёт себя не так на реальном железе.
```
build.bat
```
Результат — `ftview.wmf` в корне проекта.
## Статус
Проверено на реальном железе: просмотр JPG/PNG, воспроизведение DLS/AVI,
навигация по файлам.