Référence complète des effets vidéo¶

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

Introduction¶

Ce document fournit une référence exhaustive de tous les effets vidéo disponibles dans les SDK VisioForge .NET. Les effets sont disponibles dans deux implémentations distinctes :

Types d'effets par moteur SDK¶

Effets classiques (Windows uniquement)¶

• Disponibles dans : VideoCaptureCore, MediaPlayerCore, VideoEditCore
• Plateforme : Windows uniquement (.NET Framework 4.7.2+ et .NET 6-10)
• Types :
• VideoEffect* — traitement basé sur le CPU
• GPUVideoEffect* — accéléré par le GPU (DirectX)
• Maxine* — effets IA NVIDIA (GPU RTX)
• Emplacement : espace de noms VisioForge.Core.Types.VideoEffects

Effets multiplateformes¶

• Disponibles dans : VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX, Media Blocks SDK
• Plateforme : Windows, Linux, macOS, Android, iOS
• Types :
• Classes *VideoEffect dans VisioForge.Core.Types.X.VideoEffects
• Traitement multiplateforme pour compatibilité universelle
• Emplacement : espace de noms VisioForge.Core.Types.X.VideoEffects

Important : lors du choix des effets, sélectionnez en fonction de votre SDK cible et de vos exigences de plateforme. Les effets multiplateformes offrent une compatibilité plus large, tandis que les effets Classiques offrent des optimisations spécifiques à Windows et une accélération GPU DirectX.

Catégories d'effets¶

Les sections suivantes listent tous les effets disponibles. Chaque effet inclut des marqueurs de disponibilité par SDK : - 🪟 Classique = VideoCaptureCore/MediaPlayerCore/VideoEditCore (Windows uniquement) - 🌍 Multiplateforme = VideoCaptureCoreX/MediaPlayerCoreX/VideoEditCoreX/Media Blocks (Multiplateforme)

Effets d'ajustement des couleurs¶

Luminosité et obscurité¶

Contraste et couleur¶

Filtres de couleur et conversions¶

Niveaux de gris et monochrome¶

Inversion de couleur¶

Filtres de canal de couleur¶

Étalonnage colorimétrique¶

Amélioration d'image¶

Netteté et flou¶

Débruitage¶

Transformations géométriques¶

Rotation et retournement¶

Mise à l'échelle et transformation¶

Effets artistiques et stylistiques¶

Effets de film classique¶

Effets de contour et de texture¶

Effets de distorsion spéciaux (multiplateforme uniquement)¶

Les effets artistiques suivants sont disponibles exclusivement dans l'implémentation multiplateforme :

Effets spéciaux¶

Désentrelacement¶

Effets de transition¶

Superpositions et graphiques¶

Superpositions de texte¶

Voir : Guide de superposition de texte

Superpositions d'image¶

Voir : Guide de superposition d'image

Fonctionnalités de superposition avancées (multiplateforme uniquement)¶

Incrustation par chrominance (multiplateforme)¶

Vidéo 360° et VR (Classique uniquement)¶

Effets boostés par IA (NVIDIA Maxine — Classique uniquement)¶

Nécessite un GPU NVIDIA RTX avec prise en charge du SDK Maxine.

Amélioration vidéo¶

Effets de contenu¶

Effets spéciaux¶

• VideoEffectColorNoise — ajoute un bruit de couleur aléatoire pour effets de grain ou d'interférence.
• VideoEffectMonoNoise — ajoute un bruit monochrome (niveaux de gris).
• VideoEffectSpray — effet bombe de peinture ou pointilliste.
• VideoEffectShakeDown — effet de tremblement vertical pour simulation d'impact ou de tremblement de terre.

Désentrelacement¶

• VideoEffectDeinterlaceBlend / GPUVideoEffectDeinterlaceBlend — mélange les champs entrelacés pour une sortie progressive.
• VideoEffectDeinterlaceCAVT — désentrelacement Content Adaptive Vertical Temporal.
• VideoEffectDeinterlaceTriangle — méthode de désentrelacement par interpolation triangle.

Effets de transition¶

Effets de fondu¶

• VideoEffectFadeIn — fondu progressif du noir vers le contenu vidéo.
• VideoEffectFadeOut — fondu progressif du contenu vidéo vers le noir.

Superpositions et graphiques¶

Superpositions de texte¶

• VideoEffectTextLogo — superposition de texte flexible avec personnalisation poussée — polices, couleurs, rotation, effets et texte animé.
• VideoEffectScrollingTextLogo — bannière de texte défilant avec contrôle de direction et de vitesse.

Voir : Guide de superposition de texte

Superpositions d'image¶

• VideoEffectImageLogo — superposition d'image prenant en charge PNG, JPG, BMP, GIF animé, avec contrôle de transparence et de positionnement.

Voir : Guide de superposition d'image

Vidéo 360° et VR¶

• GPUVideoEffectEquirectangular360 — traite le format vidéo 360° équirectangulaire.
• GPUVideoEffectEquiangularCubemap360 — convertit entre projections équiangulaires et cubemap pour vidéo 360°.
• GPUVideoEffectVR360Base — classe de base pour les effets vidéo VR 360°.

Effets boostés par IA (NVIDIA Maxine)¶

Nécessite un GPU NVIDIA RTX avec prise en charge du SDK Maxine.

Amélioration vidéo¶

• MaxineDenoiseVideoEffect — réduction du bruit basée sur l'IA qui préserve intelligemment les détails.
• MaxineArtifactReductionVideoEffect — réduit les artefacts de compression et la dégradation vidéo par IA.
• MaxineSuperResSettings — POCO de paramètres pour la super-résolution IA.

Effets de contenu¶

• MaxineAIGSVideoEffect — suppression d'arrière-plan/écran vert basée sur l'IA sans véritable écran vert physique.
• MaxineUpscaleSettings — POCO de paramètres pour le surdimensionnement IA.

Paramètres des effets¶

Paramètres communs¶

Tous les effets vidéo prennent en charge ces paramètres standard :

• Enabled — indique si l'effet est actif (peut être activé/désactivé)
• Name — identifiant pour récupérer des instances d'effets spécifiques
• StartTime — début de l'effet (TimeSpan.Zero = dès le début)
• StopTime — fin de l'effet (TimeSpan.Zero = jusqu'à la fin)

Plages de valeurs des effets classiques¶

La plupart des effets d'ajustement Classiques utilisent des plages 0-255 où : - 128 représente généralement la neutralité/aucun changement - 0 représente le minimum (souvent le plus sombre/faible) - 255 représente le maximum (souvent le plus lumineux/fort)

Transitions animées (effets classiques)¶

De nombreux effets Classiques prennent en charge le paramètre ValueStop pour une animation fluide : - Définissez Value pour la valeur de départ - Définissez ValueStop pour la valeur de fin - Définissez StartTime et StopTime pour la durée de l'animation

Paramètres des effets multiplateformes¶

Les effets multiplateformes utilisent des propriétés d'éléments multimédias avec des plages variables. Consultez la documentation individuelle des effets pour les détails des paramètres spécifiques.

Comparaison des SDK¶

Effets classiques (VideoCaptureCore/MediaPlayerCore)¶

• Plateforme : Windows uniquement (.NET Framework 4.7.2+ et .NET 6-10)
• Types de traitement :
• Basé sur le CPU : classes VideoEffect*
• Accéléré par le GPU : classes GPUVideoEffect* (DirectX)
• Boosté par IA : classes Maxine* (NVIDIA RTX requis)
• Performances : optimisé pour Windows, accélération GPU DirectX
• Compatibilité : Windows desktop uniquement
• Espace de noms : VisioForge.Core.Types.VideoEffects

Effets multiplateformes (VideoCaptureCoreX/Media Blocks)¶

• Plateforme : multiplateforme (Windows, Linux, macOS, Android, iOS)
• Traitement : multiplateforme, accélération matérielle via les plugins multimédias
• Performances : bonnes sur toutes les plateformes, l'accélération GPU varie selon la plateforme
• Compatibilité : universelle — bureau et mobile
• Espace de noms : VisioForge.Core.Types.X.VideoEffects
• Fonctionnalités supplémentaires :
• Plus d'effets artistiques (distorsions, déformations)
• Système de superposition avancé (OverlayManager)
• Incrustation par chrominance / détection de mouvement
• Mieux adapté aux plateformes mobiles

Exemples d'utilisation¶

Application d'un effet classique¶

// Effet basé sur le CPU
var effect = new VideoEffectGrayscale(
    enabled: true,
    name: "BWEffect"
);
capture.Video_Effects_Add(effect);

// Effet accéléré par le GPU
var gpuEffect = new GPUVideoEffectBrightness(
    enabled: true,
    value: 180,
    name: "Brighten"
);
capture.Video_Effects_Add(gpuEffect);

Application d'un effet multiplateforme¶

// Niveaux de gris multiplateforme
var grayscale = new GrayscaleVideoEffect("bw_effect");
await videoCapture.Video_Effects_AddOrUpdateAsync(grayscale);

// Superposition de texte multiplateforme
var textOverlay = new TextOverlayVideoEffect
{
    Text = "Hello World",
    Font = new FontSettings("Arial", "Bold", 24),
    Color = SKColors.Yellow,
    HorizontalAlignment = TextOverlayHAlign.Left,
    VerticalAlignment = TextOverlayVAlign.Top
};
await videoCapture.Video_Effects_AddOrUpdateAsync(textOverlay);

Effet animé (Classique)¶

// Fondu au noir sur 3 secondes
var fade = new VideoEffectDarkness(
    enabled: true,
    value: 128,        // Démarrage normal
    valueStop: 255,    // Fin à l'obscurité maximale
    name: "FadeOut",
    startTime: TimeSpan.FromSeconds(57),
    stopTime: TimeSpan.FromSeconds(60)
);
capture.Video_Effects_Add(fade);

Effet limité dans le temps (les deux)¶

// Classique : appliquer l'effet uniquement sur une plage temporelle spécifique
var flashback = new VideoEffectGrayscale(
    enabled: true,
    name: "Flashback",
    startTime: TimeSpan.FromMinutes(2),
    stopTime: TimeSpan.FromMinutes(2.5)
);
player.Video_Effects_Add(flashback);

// Multiplateforme : effet limité dans le temps
// 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);

Considérations de performance¶

Effets classiques¶

1. Effets GPU : meilleures performances pour vidéo haute résolution sur Windows
2. Empilement d'effets : minimisez les effets simultanés pour de meilleures performances
3. Effets animés : les animations fluides ajoutent une charge minimale
4. Effets IA : les plus gourmands en ressources, à utiliser sur GPU RTX
5. Impact de la résolution : les résolutions plus élevées augmentent significativement les exigences de traitement

Effets multiplateformes¶

1. Accélération matérielle : varie selon la plateforme et la version du framework multimédia
2. Multiplateforme : performances généralement bonnes sur toutes les plateformes prises en charge
3. Optimisation mobile : mieux adapté au mobile que les effets Classiques
4. Système de superposition : rendu multi-superposition efficace
5. Disponibilité des plugins : certains effets nécessitent des plugins multimédias spécifiques

Disponibilité par plateforme¶

Effets classiques¶

Effets multiplateformes¶

Choisir le bon type d'effet¶

Utilisez les effets classiques lorsque :¶

• ✅ Vous ciblez uniquement Windows desktop
• ✅ Vous avez besoin de performances maximales sur Windows
• ✅ Vous utilisez l'accélération GPU DirectX
• ✅ Vous avez besoin des fonctionnalités IA NVIDIA Maxine
• ✅ Vous travaillez avec les moteurs VideoCaptureCore/MediaPlayerCore

Utilisez les effets multiplateformes lorsque :¶

• ✅ Vous avez besoin d'une prise en charge multiplateforme
• ✅ Vous ciblez les plateformes mobiles (Android/iOS)
• ✅ Vous ciblez Linux ou macOS
• ✅ Vous utilisez VideoCaptureCoreX/Media Blocks
• ✅ Vous avez besoin de fonctionnalités de superposition avancées
• ✅ Vous avez besoin d'incrustation par chrominance ou de détection de mouvement

Ressources supplémentaires¶

• Guide de superposition de texte
• Guide de superposition d'image
• Capteur d'échantillons vidéo
• Comment ajouter des effets

Visitez notre dépôt GitHub pour des exemples de code complets et des exemples d'implémentation.