Files
ftview/README.md
T
alexandClaude Sonnet 5 15f0d752f6 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>
2026-09-07 12:44:32 +03:00

63 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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,
навигация по файлам.