FFmpeg NVDEC Decoder

Propósito: la herramienta evalúa la decodificación FFmpeg acelerada por NVDEC para una entrada de medios dada. Está orientada a desarrolladores que integran FFmpeg con GPUs Nvidia, ingenieros de medios que evalúan pipelines acelerados por hardware, equipos de QA que validan el soporte de códecs y investigadores que benchmarkean el rendimiento de decodificación. Aborda escenarios en los que la aceleración de hardware puede no estar disponible o estar mal configurada y proporciona un informe de capacidades estructurado y orientación para automatización. No realiza una decodificación real; proporciona un informe de capacidades y orientación para automatización.
Núcleo: la herramienta se basa en una matriz de capacidades y un modelo de throughput ligero. Funciones requeridas: input_path y propiedades de medios (ancho, alto, fotogramas, lista de códecs); objetivo de GPU (gpu_model o nvdec_version) y modo de decodificación. Salidas: decode_supported, path (NVDEC, Software, Hybrid), estimated_fps, supported_codecs y notes. Funciones opcionales/avanzadas: multiplicadores de rendimiento por códec, manejo de profundidad de color y HDR, comparaciones multi-muestra y opciones de exportación (JSON/CSV).
Entradas y salidas: Entradas incluyen input_path (string), width (int, px), height (int, px), framerate (float, fps), codecs (array de strings), gpu_model (string, opcional), nvdec_version (string, opcional), decoding_mode (string, requerido). Salidas incluyen decode_supported (boolean), path (string), estimated_fps (float), supported_codecs (array), notes (string).
Algoritmos y cálculos: El sistema utiliza una matriz de capacidad y un modelo ligero para derivar una estimación de FPS cuando NVDEC está disponible. Se normaliza según complejidad del códec, resolución y capacidad de hardware, y se informa con advertencias. Las constantes están diseñadas para guiar flujos de automatización.
Errores y casos extremos: Entradas no válidas (dimensiones negativas, FPS cero), códecs desconocidos, archivos ausentes o GPUs sin NVDEC conducen a valores predeterminados seguros y advertencias en pipelines automatizados. Falta de datos externos resulta en un fallback informativo en lugar de fallo.
Industria/Región y Localización: Las unidades son fps y píxeles. El modelo sigue estándares internacionales de codificación de medios y no depende de una región específica. El manejo de datos es interno y cumple con expectativas de seguridad empresarial.
Supuestos y Exclusiones: Se asume que las entradas son accesibles y válidas; no se realiza decodificación real; los resultados son estimaciones para planificación y automatización. Se excluyen benchmarking exhaustivos, garantías de huella de memoria y comparaciones de rendimiento entre controladores.