cuframes-composer

gx/cuframes-composer

Fork 0

Commit Graph

Author	SHA1	Message	Date
gx	e76360dbc4	docs: руководства пользователя / разработчика / operations (RU+EN) Полный комплект документации к Phase 11b: docs/ru/user.md — для админа инсталляции (motion-mode, PTZ, templates.json, mqtt_overlays.json, ZMQ verbs) docs/ru/developer.md — архитектура (Cell / Layout / Decoration), как добавить новый Cell/Decoration, ABI shim, algorithms (best-fit + asymmetric hysteresis) docs/ru/operations.md — build (host + jammy + incremental bake), deploy, logs/telemetry, troubleshooting (broken pipe, MQTT-overlay, motion-mode) docs/en/*.md — английская версия всех трёх README.md — переписан с overview + ссылками на docs/ Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-06-04 22:02:47 +01:00
gx	ba68550f4c	Phase 1: NVENC через dlopen + источник через cuframes_subscriber Скелет проекта cuframes-composer (LGPL-2.1+) и MVP кодирования одного источника в файл H.264. Что включает Phase 1: - LICENSE (LGPL-2.1+), README с поэтапным планом, корневой CMake - Подмодули: cuframes v0.4 (pinned), nv-codec-headers (n12.2.72.0) - include/cuframes_composer/source.h — публичный API источника с явной машиной состояний (DISCONNECTED → CONNECTING → ACTIVE → STALE → DEAD) и snapshot-паттерном для чтения без блокировки - include/cuframes_composer/nvenc.h — публичный API кодировщика на CUdeviceptr-вход (zero-copy через VMM-mapped указатели) - src/nvenc_loader.{h,c} — dlopen libnvidia-encode.so.1 и инициализация таблицы функций NVENC через NvEncodeAPICreateInstance. Идёт через pthread_once. Сделано отдельно чтобы держать LGPL-совместимость: проприетарный SDK не статически линкуется - src/nvenc.c — обвязка над NVENC: open session, init encoder, кеш registered resources, encode/lock/unlock, flush с EOS, поддержка H.264 CBR low-latency, preset GUID p1/p4/p7 - src/source.c — обвязка над cuframes_subscriber c фоновым потоком, exponential backoff reconnect (1с → 30с), и переходами по таймаутам для stale/dead-детекта - examples/simple_record — smoke-test программа: подписка на cuframes, кодирование, запись в .h264 файл, корректное завершение по SIGINT	2026-06-03 04:28:33 +01:00

Author

SHA1

Message

Date

e76360dbc4

docs: руководства пользователя / разработчика / operations (RU+EN)

Полный комплект документации к Phase 11b:

  docs/ru/user.md        — для админа инсталляции (motion-mode, PTZ,
                            templates.json, mqtt_overlays.json, ZMQ verbs)
  docs/ru/developer.md   — архитектура (Cell / Layout / Decoration),
                            как добавить новый Cell/Decoration, ABI shim,
                            algorithms (best-fit + asymmetric hysteresis)
  docs/ru/operations.md  — build (host + jammy + incremental bake),
                            deploy, logs/telemetry, troubleshooting
                            (broken pipe, MQTT-overlay, motion-mode)
  docs/en/*.md           — английская версия всех трёх
  README.md              — переписан с overview + ссылками на docs/

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-06-04 22:02:47 +01:00

ba68550f4c

Phase 1: NVENC через dlopen + источник через cuframes_subscriber

Скелет проекта cuframes-composer (LGPL-2.1+) и MVP кодирования
одного источника в файл H.264.

Что включает Phase 1:

- LICENSE (LGPL-2.1+), README с поэтапным планом, корневой CMake
- Подмодули: cuframes v0.4 (pinned), nv-codec-headers (n12.2.72.0)
- include/cuframes_composer/source.h — публичный API источника
  с явной машиной состояний (DISCONNECTED → CONNECTING → ACTIVE →
  STALE → DEAD) и snapshot-паттерном для чтения без блокировки
- include/cuframes_composer/nvenc.h — публичный API кодировщика
  на CUdeviceptr-вход (zero-copy через VMM-mapped указатели)
- src/nvenc_loader.{h,c} — dlopen libnvidia-encode.so.1 и инициализация
  таблицы функций NVENC через NvEncodeAPICreateInstance. Идёт через
  pthread_once. Сделано отдельно чтобы держать LGPL-совместимость:
  проприетарный SDK не статически линкуется
- src/nvenc.c — обвязка над NVENC: open session, init encoder, кеш
  registered resources, encode/lock/unlock, flush с EOS, поддержка
  H.264 CBR low-latency, preset GUID p1/p4/p7
- src/source.c — обвязка над cuframes_subscriber c фоновым потоком,
  exponential backoff reconnect (1с → 30с), и переходами по таймаутам
  для stale/dead-детекта
- examples/simple_record — smoke-test программа: подписка на cuframes,
  кодирование, запись в .h264 файл, корректное завершение по SIGINT

2026-06-03 04:28:33 +01:00

2 Commits