gx
ba68550f4c
Скелет проекта 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
76 lines
3.9 KiB
CMake
76 lines
3.9 KiB
CMake
cmake_minimum_required(VERSION 3.20)
|
|
project(cuframes-composer
|
|
VERSION 0.1.0
|
|
DESCRIPTION "Multi-source video grid composer на CUDA + NVENC + RTSP"
|
|
LANGUAGES C
|
|
)
|
|
|
|
set(CMAKE_C_STANDARD 11)
|
|
set(CMAKE_C_STANDARD_REQUIRED ON)
|
|
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
|
|
|
|
if(NOT CMAKE_BUILD_TYPE)
|
|
set(CMAKE_BUILD_TYPE Release)
|
|
endif()
|
|
|
|
# ── Опции сборки ────────────────────────────────────────────────────────
|
|
option(BUILD_EXAMPLES "Сборка smoke-test программ из examples/" ON)
|
|
option(BUILD_TESTS "Сборка модульных и интеграционных тестов" OFF)
|
|
|
|
# ── Зависимости ─────────────────────────────────────────────────────────
|
|
|
|
# CUDA Toolkit — для cudart, заголовков cuda.h (Driver API), nvcc.
|
|
# NVENC SDK сам идёт через nv-codec-headers + dlopen libnvidia-encode.so,
|
|
# поэтому CUDA::nvenc намеренно НЕ линкуем (см. дизайн-документ часть 1.6).
|
|
find_package(CUDAToolkit 12.0 REQUIRED)
|
|
find_package(Threads REQUIRED)
|
|
|
|
# dl — для dlopen libnvidia-encode.so в runtime
|
|
find_library(LIBDL_LIBRARY dl REQUIRED)
|
|
|
|
# ── Сторонние библиотеки (subomodules в third_party/) ───────────────────
|
|
|
|
# cuframes — статически линкуем libcuframes. cuframes_static — это static lib
|
|
# который определён в third_party/cuframes/libcuframes/CMakeLists.txt.
|
|
# PIC обязателен — cuframes_static линкуется в наш SHARED libcuframes_composer.
|
|
set(CMAKE_POSITION_INDEPENDENT_CODE ON)
|
|
set(BUILD_TESTING OFF CACHE BOOL "" FORCE)
|
|
set(BUILD_EXAMPLES OFF CACHE BOOL "Cuframes examples" FORCE)
|
|
set(BUILD_TOOLS OFF CACHE BOOL "Cuframes tools" FORCE)
|
|
set(BUILD_FFMPEG_FILTER OFF CACHE BOOL "" FORCE)
|
|
set(BUILD_PYTHON_BINDINGS OFF CACHE BOOL "" FORCE)
|
|
add_subdirectory(third_party/cuframes)
|
|
# Восстанавливаем BUILD_EXAMPLES для наших собственных examples/
|
|
set(BUILD_EXAMPLES ON CACHE BOOL "" FORCE)
|
|
|
|
# nv-codec-headers — header-only, нужны заголовки nvEncodeAPI.h
|
|
# (NVENC) и cuviddec.h (NVDEC, на будущее). Не как target, просто include path.
|
|
set(NVCODEC_HEADERS_DIR
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/third_party/nv-codec-headers/include")
|
|
if(NOT EXISTS "${NVCODEC_HEADERS_DIR}/ffnvcodec/nvEncodeAPI.h")
|
|
message(FATAL_ERROR
|
|
"nv-codec-headers заголовки не найдены в ${NVCODEC_HEADERS_DIR}/ffnvcodec/. "
|
|
"Выполни: git submodule update --init --recursive")
|
|
endif()
|
|
|
|
# ── Подпроекты ──────────────────────────────────────────────────────────
|
|
|
|
# src/ — основная библиотека композитора
|
|
add_subdirectory(src)
|
|
|
|
# examples/ — smoke-test программы (по фазам разработки)
|
|
if(BUILD_EXAMPLES)
|
|
add_subdirectory(examples)
|
|
endif()
|
|
|
|
# ── Сводка конфигурации ─────────────────────────────────────────────────
|
|
message(STATUS "")
|
|
message(STATUS "cuframes-composer ${PROJECT_VERSION} конфигурация:")
|
|
message(STATUS " Build type: ${CMAKE_BUILD_TYPE}")
|
|
message(STATUS " CUDA Toolkit: ${CUDAToolkit_VERSION}")
|
|
message(STATUS " CUDA include: ${CUDAToolkit_INCLUDE_DIRS}")
|
|
message(STATUS " nv-codec-headers: ${NVCODEC_HEADERS_DIR}")
|
|
message(STATUS " BUILD_EXAMPLES: ${BUILD_EXAMPLES}")
|
|
message(STATUS " BUILD_TESTS: ${BUILD_TESTS}")
|
|
message(STATUS "")
|