# 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,
навигация по файлам.