e02998cea7cb326520896e4a178572ba5e02562c
Phase 3c — динамический текст через libfreetype6: открывается font (.ttf/.otf), измеряется bounding box строки, рендерится в RGBA-атлас с anti-aliased alpha из FT bitmap, заливается в VRAM. На каждом кадре блитится через cfc_cugrid_blit_rgba_nv12 (kernels уже есть). Поддержка UTF-8 через простой inline-decoder (1/2/3/4-byte). cfc_overlay_update_text() переподдерживает re-render atlas (text / color change) — для Phase 4 ZMQ control plane (динамическое изменение NO SIGNAL / RECORDING / timestamp'ов). Адаптация под GTX 1050 (Pascal) в проде: - CMAKE_CUDA_ARCHITECTURES = 61;75;86;89;120 (Pascal + Turing + Ampere + Ada + Blackwell, покрывает все production-кейсы) - grid_record default снижен с 4K@10Mbps на 1080p@4Mbps. 4K требует явных --width 3840 --height 2160 (Pascal NVENC 4K H.264 на грани). - Ссылка на research-документ + NVENC §Input Buffers рядом со staging buffer'ом в nvenc.c с цитатой "the client is required to use buffers allocated using the cuMemAlloc family of APIs". Содержимое Phase 3c: - overlay.h — cfc_overlay_create_text + update_text + text_size. - overlay.c — utf8_next decoder, text_measure (ascender/descender), text_render (alpha-over blend в RGBA), text_rebuild_atlas (VRAM cycle), full FreeType lifecycle. - CMakeLists.txt — find_package(Freetype REQUIRED) + link Freetype::Freetype. - examples/grid_record — флаг --text font,size,r,g,b,x,y,text.
cuframes-composer
Стандалонный композитор-демон для multi-source видео grid через CUDA + NVENC + RTSP.
Заменяет монолитный ffmpeg-конвейер (ffmpeg + vf_cuda_grid фильтр) для случаев, когда нужно:
- Поток продолжает работать при потере любого числа источников (graceful degradation)
- Композитор сам управляет частотой кадров и обработкой ошибок без зависимости от семантики ffmpeg-демухера
- Минимум перемещений данных: zero-copy CUDA от источника
cuframesнапрямую в NVENC
Статус
Phase 1 — MVP. В разработке. Не для боевой эксплуатации.
См. дизайн-документ для архитектурных решений и поэтапного плана.
Зависимости
- cuframes — библиотека zero-copy передачи кадров. Подключена как git submodule.
- nv-codec-headers — MIT-licensed заголовки NVENC API. Подключена как git submodule. Сама библиотека
libnvidia-encode.soгрузится черезdlopenпри старте (это даёт LGPL-совместимость — см. дизайн-документ часть 1.6). - CUDA Toolkit 12.x+ (для cuda runtime и компиляции)
- NVIDIA драйвер 525+ (для NVENC и
cuMemCreatePOSIX FD) - Linux 64-bit (POSIX shm, SCM_RIGHTS)
Дополнительно по фазам:
- Phase 3:
libfreetype(текст),lodepngчерез submodule (PNG-декодирование) - Phase 4:
libzmq(управление)
Сборка
git clone --recursive git@git.goldix.org:gx/cuframes-composer.git
cd cuframes-composer
cmake -B build -G Ninja
ninja -C build
Поэтапный план
| фаза | срок | результат |
|---|---|---|
| 1 | 1 неделя | один источник → NVENC → файл .h264 (доказательство zero-copy) |
| 2 | 2 недели | четыре источника + композиция через libcugrid |
| 3 | 2 недели | оверлеи + RTSP push к mediamtx + AAC passthrough из /live-audio |
| 4 | 1 неделя | паритет ZMQ-управления с фильтром vf_cuda_grid |
| 5 | 1 неделя | боевое развёртывание + MQTT health + watchdog |
| 6 | 2 недели | тесты + бенчмарки + документация |
Итого ~9 недель для одного разработчика.
Лицензия
LGPL-2.1-or-later. См. файл LICENSE.
NVENC SDK headers (third_party/nv-codec-headers) — MIT license, совместима с LGPL.
Languages
C
62.1%
C++
29.7%
Cuda
3.5%
CMake
3.2%
Dockerfile
1.5%