Referencia Completa de Efectos de Video¶

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introducción¶

Este documento proporciona una referencia completa para todos los efectos de video disponibles en los SDKs .NET de VisioForge. Los efectos están disponibles en dos implementaciones distintas:

Tipos de Efectos por Motor SDK¶

Efectos Classic (Solo Windows)¶

• Disponible en: VideoCaptureCore, MediaPlayerCore, VideoEditCore
• Plataforma: Solo Windows (.NET Framework 4.7.2+ y .NET 6-10)
• Tipos:
• VideoEffect* - Procesamiento basado en CPU
• GPUVideoEffect* - Acelerado por GPU (DirectX)
• Maxine* - Efectos impulsados por IA de NVIDIA (GPUs RTX)
• Ubicación: Espacio de nombres VisioForge.Core.Types.VideoEffects

Efectos Multiplataforma¶

• Disponible en: VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX, Media Blocks SDK
• Plataforma: Windows, Linux, macOS, Android, iOS
• Tipos:
• Clases *VideoEffect en VisioForge.Core.Types.X.VideoEffects
• Procesamiento multiplataforma para compatibilidad universal
• Ubicación: Espacio de nombres VisioForge.Core.Types.X.VideoEffects

Importante: Al elegir efectos, seleccione según su SDK objetivo y requisitos de plataforma. Los efectos multiplataforma proporcionan mayor compatibilidad, mientras que los efectos Classic ofrecen optimizaciones específicas de Windows y aceleración GPU DirectX.

Categorías de Efectos¶

Las siguientes secciones enumeran todos los efectos disponibles. Cada efecto incluye marcadores de disponibilidad de SDK: - 🪟 Classic = VideoCaptureCore/MediaPlayerCore/VideoEditCore (Solo Windows) - 🌍 Multiplataforma = VideoCaptureCoreX/MediaPlayerCoreX/VideoEditCoreX/Media Blocks (Multiplataforma)

Efectos de Ajuste de Color¶

Brillo y Oscuridad¶

Contraste y Color¶

Filtros de Color y Conversiones¶

Escala de Grises y Monocromático¶

Inversión de Color¶

Filtros de Canal de Color¶

Gradación de Color¶

Mejora de Imagen¶

Nitidez y Desenfoque¶

Reducción de Ruido¶

Transformaciones Geométricas¶

Rotación y Volteo¶

Escalado y Transformación¶

Efectos Artísticos y Estilísticos¶

Efectos de Película Clásica¶

Efectos de Bordes y Texturas¶

Efectos Especiales de Distorsión (Solo multiplataforma)¶

Los siguientes efectos artísticos están disponibles exclusivamente en la implementación multiplataforma:

Efectos Especiales¶

Desentrelazado¶

Efectos de Transición¶

Superposiciones y Gráficos¶

Superposiciones de Texto¶

Ver: Guía de Superposición de Texto

Superposiciones de Imagen¶

Ver: Guía de Superposición de Imagen

Características Avanzadas de Superposición (Solo multiplataforma)¶

Croma Key (Multiplataforma)¶

Video 360° y VR (Solo Classic)¶

Efectos Impulsados por IA (NVIDIA Maxine - Solo Classic)¶

Requiere GPU NVIDIA RTX con soporte del SDK Maxine.

Mejora de Video¶

Efectos de Contenido¶

Efectos Especiales¶

• VideoEffectColorNoise - Añade ruido de color aleatorio para efectos de grano o interferencia.
• VideoEffectMonoNoise - Añade ruido monocromático (escala de grises).
• VideoEffectSpray - Efecto de pintura en aerosol o puntillista.
• VideoEffectShakeDown - Efecto de sacudida vertical para simulación de impacto o terremoto.

Desentrelazado¶

• VideoEffectDeinterlaceBlend / GPUVideoEffectDeinterlaceBlend - Mezcla campos entrelazados para salida progresiva.
• VideoEffectDeinterlaceCAVT - Desentrelazado Adaptativo Vertical Temporal del Contenido.
• VideoEffectDeinterlaceTriangle - Método de desentrelazado por interpolación triangular.

Efectos de Transición¶

Efectos de Fundido¶

• VideoEffectFadeIn - Fundido gradual de negro a contenido de video.
• VideoEffectFadeOut - Fundido gradual de contenido de video a negro.

Superposiciones y Gráficos¶

Superposiciones de Texto¶

• VideoEffectTextLogo - Superposición de texto flexible con amplia personalización incluyendo fuentes, colores, rotación, efectos y texto animado.
• VideoEffectScrollingTextLogo - Banner de texto desplazable con control de dirección y velocidad.

Ver: Guía de Superposición de Texto

Superposiciones de Imagen¶

• VideoEffectImageLogo - Superposición de imagen soportando PNG, JPG, BMP, GIF animado, con control de transparencia y posicionamiento.

Ver: Guía de Superposición de Imagen

Video 360° y VR¶

• GPUVideoEffectEquirectangular360 - Procesa formato de video 360° equirectangular.
• GPUVideoEffectEquiangularCubemap360 - Convierte entre proyecciones equiangular y cubemap para video 360°.
• GPUVideoEffectVR360Base - Clase base para efectos de video VR 360°.

Efectos Impulsados por IA (NVIDIA Maxine)¶

Requiere GPU NVIDIA RTX con soporte del SDK Maxine.

Mejora de Video¶

• MaxineDenoiseVideoEffect - Reducción de ruido impulsada por IA que preserva inteligentemente los detalles.
• MaxineArtifactReductionVideoEffect - Reduce artefactos de compresión y degradación de video usando IA.
• MaxineSuperResSettings - POCO de configuración para super-resolución IA.

Efectos de Contenido¶

• MaxineAIGSVideoEffect - Pantalla verde/eliminación de fondo impulsada por IA sin requerir pantalla verde real.
• MaxineUpscaleSettings - POCO de configuración para escalado IA.

Parámetros de Efectos¶

Parámetros Comunes¶

Todos los efectos de video soportan estos parámetros estándar:

• Enabled - Si el efecto está activo (puede activarse/desactivarse)
• Name - Identificador para recuperar instancias específicas de efectos
• StartTime - Cuándo comienza el efecto (TimeSpan.Zero = desde el inicio)
• StopTime - Cuándo termina el efecto (TimeSpan.Zero = hasta el final)

Rangos de Valores de Efectos Classic¶

La mayoría de los efectos de ajuste Classic usan rangos de valores 0-255 donde: - 128 típicamente representa neutral/sin cambio - 0 representa mínimo (a menudo más oscuro/más débil) - 255 representa máximo (a menudo más brillante/más fuerte)

Transiciones Animadas (Efectos Classic)¶

Muchos efectos Classic soportan el parámetro ValueStop para animación suave: - Establecer Value para valor inicial - Establecer ValueStop para valor final - Definir StartTime y StopTime para duración de animación

Parámetros de Efectos Multiplataforma¶

Los efectos multiplataforma usan propiedades de elementos multimedia con rangos variables. Consulte la documentación individual de cada efecto para detalles específicos de parámetros.

Comparación de SDKs¶

Efectos Classic (VideoCaptureCore/MediaPlayerCore)¶

• Plataforma: Solo Windows (.NET Framework 4.7.2+ y .NET 6-10)
• Tipos de Procesamiento:
• Basado en CPU: Clases VideoEffect*
• Acelerado por GPU: Clases GPUVideoEffect* (DirectX)
• Impulsado por IA: Clases Maxine* (requiere NVIDIA RTX)
• Rendimiento: Optimizado para Windows, aceleración GPU DirectX
• Compatibilidad: Solo escritorio Windows
• Espacio de nombres: VisioForge.Core.Types.VideoEffects

Efectos Multiplataforma (VideoCaptureCoreX/Media Blocks)¶

• Plataforma: Multiplataforma (Windows, Linux, macOS, Android, iOS)
• Procesamiento: Multiplataforma, aceleración de hardware a través de plugins multimedia
• Rendimiento: Buen rendimiento en todas las plataformas, aceleración GPU varía según plataforma
• Compatibilidad: Universal - escritorio y móvil
• Espacio de nombres: VisioForge.Core.Types.X.VideoEffects
• Características Adicionales:
• Más efectos artísticos (distorsiones, deformaciones)
• Sistema de superposición avanzado (OverlayManager)
• Croma key / detección de movimiento
• Mejor adaptado para plataformas móviles

Ejemplos de Uso¶

Aplicación de Efecto Classic¶

// Efecto basado en CPU
var effect = new VideoEffectGrayscale(
    enabled: true,
    name: "BWEffect"
);
capture.Video_Effects_Add(effect);

// Efecto acelerado por GPU
var gpuEffect = new GPUVideoEffectBrightness(
    enabled: true,
    value: 180,
    name: "Brighten"
);
capture.Video_Effects_Add(gpuEffect);

Aplicación de Efecto Multiplataforma¶

// Escala de grises multiplataforma
var grayscale = new GrayscaleVideoEffect("bw_effect");
await videoCapture.Video_Effects_AddOrUpdateAsync(grayscale);

// Superposición de texto multiplataforma
var textOverlay = new TextOverlayVideoEffect
{
    Text = "Hola Mundo",
    Font = new FontSettings("Arial", "Bold", 24),
    Color = SKColors.Yellow,
    HorizontalAlignment = TextOverlayHAlign.Left,
    VerticalAlignment = TextOverlayVAlign.Top
};
await videoCapture.Video_Effects_AddOrUpdateAsync(textOverlay);

Efecto Animado (Classic)¶

// Fundido a negro durante 3 segundos
var fade = new VideoEffectDarkness(
    enabled: true,
    value: 128,        // Comenzar normal
    valueStop: 255,    // Terminar en oscuridad máxima
    name: "FadeOut",
    startTime: TimeSpan.FromSeconds(57),
    stopTime: TimeSpan.FromSeconds(60)
);
capture.Video_Effects_Add(fade);

Efecto con Tiempo Limitado (Ambos)¶

// Classic: Aplicar efecto solo durante rango de tiempo específico
var flashback = new VideoEffectGrayscale(
    enabled: true,
    name: "Flashback",
    startTime: TimeSpan.FromMinutes(2),
    stopTime: TimeSpan.FromMinutes(2.5)
);
player.Video_Effects_Add(flashback);

// Multiplataforma: Efecto con tiempo limitado
// Ctor: GaussianBlurVideoEffect(double sigma, string name = "gaussian_blur")
var blur = new GaussianBlurVideoEffect(5.0, "blur")
{
    StartTime = TimeSpan.FromSeconds(10),
    StopTime = TimeSpan.FromSeconds(15)
};
await player.Video_Effects_AddOrUpdateAsync(blur);

Consideraciones de Rendimiento¶

Efectos Classic¶

1. Efectos GPU: Mejor rendimiento para video de alta resolución en Windows
2. Apilamiento de Efectos: Minimice efectos simultáneos para mejor rendimiento
3. Efectos Animados: Las animaciones suaves añaden sobrecarga mínima
4. Efectos IA: Los más intensivos en recursos, usar en GPUs RTX
5. Impacto de Resolución: Resoluciones más altas aumentan significativamente los requisitos de procesamiento

Efectos Multiplataforma¶

1. Aceleración de Hardware: Varía según plataforma y compilación del framework multimedia
2. Multiplataforma: Generalmente buen rendimiento en todas las plataformas soportadas
3. Optimización Móvil: Mejor adaptado para móvil que los efectos Classic
4. Sistema de Superposición: Renderizado eficiente de múltiples superposiciones
5. Disponibilidad de Plugins: Algunos efectos requieren plugins multimedia específicos

Disponibilidad por Plataforma¶

Efectos Classic¶

Efectos Multiplataforma¶

Elegir el Tipo de Efecto Correcto¶

Use Efectos Classic Cuando:¶

• ✅ Apunta solo a escritorio Windows
• ✅ Necesita máximo rendimiento en Windows
• ✅ Usa aceleración GPU DirectX
• ✅ Necesita características de IA NVIDIA Maxine
• ✅ Trabaja con motores VideoCaptureCore/MediaPlayerCore

Use Efectos Multiplataforma Cuando:¶

• ✅ Necesita soporte multiplataforma
• ✅ Apunta a plataformas móviles (Android/iOS)
• ✅ Apunta a Linux o macOS
• ✅ Usa VideoCaptureCoreX/Media Blocks
• ✅ Necesita características avanzadas de superposición
• ✅ Necesita croma key o detección de movimiento

Recursos Adicionales¶

• Guía de Superposición de Texto
• Guía de Superposición de Imagen
• Capturador de Muestras de Video
• Cómo Añadir Efectos

Visite nuestro repositorio de GitHub para ejemplos de código completos y ejemplos de implementación.