Effets vidéo OpenGL - VisioForge Media Blocks SDK .Net¶

Media Blocks SDK .Net

Les effets vidéo OpenGL dans VisioForge Media Blocks SDK .Net permettent une manipulation puissante et accélérée matériellement des flux vidéo. Chaque effet est livré comme MediaBlock autonome (par ex. GLBlurBlock, GLFlipBlock, GLAlphaBlock) et se chaîne entre GLUploadBlock côté entrée et GLDownloadBlock côté sortie. Ce guide couvre les effets disponibles, leurs paramètres de configuration et les autres types OpenGL associés.

Effet de base : GLBaseVideoEffect¶

Tous les effets vidéo OpenGL héritent de la classe GLBaseVideoEffect, qui fournit des propriétés et des événements communs.

Événements :

• OnUpdate : se produit lorsque les propriétés de l'effet doivent être mises à jour dans le pipeline. Appelez OnUpdateCall() pour le déclencher.

Effets vidéo disponibles¶

Cette section détaille les divers effets vidéo OpenGL utilisables. Chaque effet est un MediaBlock indépendant — instanciez directement le bloc (par ex. new GLBlurBlock()) et connectez-le entre GLUploadBlock et GLDownloadBlock (ou entre d'autres blocs GL) dans votre pipeline.

Effet Alpha (GLAlphaVideoEffect)¶

Remplace une couleur sélectionnée par un canal alpha ou définit/ajuste le canal alpha existant.

Propriétés :

Énumération associée : GLAlphaVideoEffectMode

Définit le mode de fonctionnement de l'effet vidéo Alpha.

Effet Blur (GLBlurVideoEffect)¶

Applique un effet de flou via une convolution séparable 9x9. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Bulge (GLBulgeVideoEffect)¶

Crée une distorsion en relief (bombement) sur la vidéo. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Color Balance (GLColorBalanceVideoEffect)¶

Ajuste la balance des couleurs de la vidéo, dont la luminosité, le contraste, la teinte et la saturation.

Propriétés :

Effet Deinterlace (GLDeinterlaceVideoEffect)¶

Applique un filtre de désentrelacement à la vidéo.

Propriétés :

Énumération associée : GLDeinterlaceMethod

Définit la méthode de l'effet vidéo Deinterlace.

Effet Fish Eye (GLFishEyeVideoEffect)¶

Applique un effet de distorsion d'objectif fisheye. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Flip (GLFlipVideoEffect)¶

Retourne ou fait pivoter la vidéo.

Propriétés :

Énumération associée : GLFlipVideoMethod

Définit la méthode de retournement ou de rotation vidéo.

Effet Glow Lighting (GLGlowLightingVideoEffect)¶

Ajoute un effet de halo lumineux à la vidéo. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Grayscale (GLGrayscaleVideoEffect)¶

Convertit la vidéo en niveaux de gris. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Heat (GLHeatVideoEffect)¶

Applique un effet de type signature thermique à la vidéo. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Laplacian (GLLaplacianVideoEffect)¶

Applique un filtre de détection d'arêtes laplacien.

Propriétés :

Effet Light Tunnel (GLLightTunnelVideoEffect)¶

Crée un effet visuel de tunnel lumineux. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Luma Cross Processing (GLLumaCrossProcessingVideoEffect)¶

Applique un effet de cross-processing de luminance (souvent « xpro »). Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Mirror (GLMirrorVideoEffect)¶

Applique un effet miroir à la vidéo. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Resize (GLResizeVideoEffect)¶

Redimensionne la vidéo aux dimensions spécifiées.

Propriétés :

Effet Sepia (GLSepiaVideoEffect)¶

Applique un effet de sépia à la vidéo. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Sin City (GLSinCityVideoEffect)¶

Applique un effet de style cinéma « Sin City » (niveaux de gris avec rehauts rouges). Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Sobel (GLSobelVideoEffect)¶

Applique un filtre de détection d'arêtes de Sobel.

Propriétés :

Effet Square (GLSquareVideoEffect)¶

Applique un effet de distorsion ou de pixellisation « carré ». Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Squeeze (GLSqueezeVideoEffect)¶

Applique un effet de distorsion par compression. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Stretch (GLStretchVideoEffect)¶

Applique un effet de distorsion par étirement. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet Transformation (GLTransformationVideoEffect)¶

Applique des transformations 3D à la vidéo : rotation, mise à l'échelle et translation.

Propriétés :

Effet Twirl (GLTwirlVideoEffect)¶

Applique un effet de distorsion par tourbillon. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Effet X-Ray (GLXRayVideoEffect)¶

Applique un effet visuel de type radiographie. Cet effet ne possède pas de propriétés configurables au-delà de celles héritées de GLBaseVideoEffect.

Identification des effets OpenGL : énumération GLVideoEffectID¶

Cette énumération liste tous les types d'effets vidéo OpenGL disponibles, utilisée par GLBaseVideoEffect.ID.

Configuration du rendu et de la vue OpenGL¶

Ces types aident à configurer la manière dont la vidéo est rendue ou visualisée dans un contexte OpenGL, en particulier pour les scénarios spécialisés comme la VR ou les configurations d'affichage personnalisées.

Paramètres de vue équirectangulaire (GLEquirectangularViewSettings)¶

Gère les paramètres pour le rendu vidéo équirectangulaire (360 degrés), couramment utilisé dans les applications VR. Implémente IVRVideoControl.

Propriétés :

Méthodes :

• IsModeSupported(VRMode mode) : vérifie si le VRMode spécifié est pris en charge.

Événements :

• SettingsChanged : se produit lorsqu'un paramètre de vue est modifié.

Paramètres du moteur de rendu vidéo (GLVideoRendererSettings)¶

Configure les propriétés générales d'un moteur de rendu vidéo OpenGL.

Propriétés :

Énumération associée : GLVideoRendererRotateMethod

Définit les méthodes de rotation pour le moteur de rendu vidéo OpenGL.

Shaders OpenGL personnalisés¶

Permet l'application de shaders GLSL personnalisés au flux vidéo.

Définition de shader (GLShader)¶

Représente une paire de shaders vertex et fragment.

Propriétés :

Constructeurs : - GLShader() - GLShader(string vertexShader, string fragmentShader)

Paramètres de shader (GLShaderSettings)¶

Configure des shaders GLSL personnalisés à utiliser dans le pipeline.

Propriétés :

Constructeurs : - GLShaderSettings() - GLShaderSettings(string vertex, string fragment) - GLShaderSettings(GLShader shader)

Superpositions d'images en OpenGL¶

Fournit des paramètres pour superposer des images statiques sur un flux vidéo dans un contexte OpenGL.

Paramètres de superposition (GLOverlaySettings)¶

Définit les propriétés d'une superposition d'image.

Propriétés :

Constructeur : - GLOverlaySettings(string filename)

Mixage vidéo OpenGL¶

Ces types servent à configurer un mélangeur vidéo OpenGL, permettant de combiner et composer plusieurs flux vidéo.

Paramètres du mélangeur (GLVideoMixerSettings)¶

Étend VideoMixerBaseSettings pour le mixage vidéo spécifique à OpenGL. Gère une liste d'objets GLVideoMixerStream et hérite de propriétés telles que Width, Height et FrameRate.

Méthodes : - AddStream(GLVideoMixerStream stream) : ajoute un flux au mélangeur. - RemoveStream(GLVideoMixerStream stream) : retire un flux du mélangeur. - SetStream(int index, GLVideoMixerStream stream) : remplace un flux à un index spécifique.

Constructeurs : - GLVideoMixerSettings(int width, int height, VideoFrameRate frameRate) - GLVideoMixerSettings(int width, int height, VideoFrameRate frameRate, List<VideoMixerStream> streams)

Flux du mélangeur (GLVideoMixerStream)¶

Étend VideoMixerStream et définit les propriétés d'un flux individuel au sein du mélangeur vidéo OpenGL. Hérite de Rectangle, ZOrder et Alpha de VideoMixerStream.

Propriétés :

Constructeur : - GLVideoMixerStream(Rect rectangle, uint zorder, double alpha = 1.0)

Équation de mélange (énumération GLVideoMixerBlendEquation)¶

Spécifie la manière dont les couleurs source et destination sont combinées lors du mélange.

Fonction de mélange (énumération GLVideoMixerBlendFunction)¶

Définit les facteurs pour les couleurs source et destination dans les opérations de mélange. (Rs, Gs, Bs, As sont les composantes de couleur source ; Rd, Gd, Bd, Ad sont celles de destination ; Rc, Gc, Bc, Ac sont les composantes de couleur constante).

Sources de test virtuelles pour OpenGL¶

Ces classes de paramètres servent à configurer des sources virtuelles générant des motifs de test directement dans un contexte OpenGL.

Paramètres de source vidéo virtuelle (GLVirtualVideoSourceSettings)¶

Configure un bloc source (GLVirtualVideoSourceBlock) produisant des données vidéo de test. Implémente IMediaPlayerBaseSourceSettings et IVideoCaptureBaseVideoSourceSettings.

Propriétés :

Énumération associée : GLVirtualVideoSourceMode

Définit le motif de test généré par GLVirtualVideoSourceBlock.

Méthodes : - Task<MediaFileInfo> ReadInfoAsync() : lit asynchrone les informations multimédias (renvoie des informations synthétiques d'après les paramètres). - MediaBlock CreateBlock() : crée une instance GLVirtualVideoSourceBlock configurée avec ces paramètres.

Blocs de traitement OpenGL¶

Outre les blocs par effet listés ci-dessus, le SDK fournit plusieurs blocs de traitement OpenGL autonomes pour la composition de superpositions, le redimensionnement GPU, la conversion de format, le mixage multi-flux et le rendu accéléré matériellement. Comme les blocs d'effet, ils opèrent sur la mémoire GPU et sont généralement chaînés entre GLUploadBlock (mémoire CPU vers GL) et GLDownloadBlock (GL vers mémoire CPU), ou alimentés directement par d'autres blocs OpenGL. Chaque bloc expose une méthode statique IsAvailable() que vous pouvez appeler pour vérifier la prise en charge d'OpenGL sur le système courant avant de construire le pipeline.

GL Overlay¶

Le GLOverlayBlock compose une image statique (logo, filigrane, graphique) sur le flux vidéo au niveau du GPU, avec positionnement, mise à l'échelle et fondu alpha.

Informations sur le bloc¶

Nom : GLOverlayBlock.

La superposition est configurée avec GLOverlaySettings (voir Paramètres de superposition ci-dessus). Appelez UpdateSettings() après avoir modifié les propriétés de Settings pour appliquer les changements à un pipeline en cours d'exécution.

Exemple de pipeline¶

graph LR;
    UniversalSourceBlock-->GLUploadBlock;
    GLUploadBlock-->GLOverlayBlock;
    GLOverlayBlock-->GLDownloadBlock;
    GLDownloadBlock-->VideoRendererBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

var source = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("test.mp4"));

var glUpload = new GLUploadBlock();

// configurer la superposition d'image
var overlaySettings = new GLOverlaySettings("logo.png")
{
    X = 20,
    Y = 20,
    Width = 160,
    Height = 80,
    Alpha = 0.8
};
var glOverlay = new GLOverlayBlock(overlaySettings);

var glDownload = new GLDownloadBlock();
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1);

pipeline.Connect(source.VideoOutput, glUpload.Input);
pipeline.Connect(glUpload.Output, glOverlay.Input);
pipeline.Connect(glOverlay.Output, glDownload.Input);
pipeline.Connect(glDownload.Output, videoRenderer.Input);

await pipeline.StartAsync();

Plateformes¶

Windows, macOS, Linux, iOS, Android.

GL Resize¶

Le GLResizeBlock effectue une mise à l'échelle vidéo accélérée par GPU vers une résolution cible à l'aide de GLResizeVideoEffect.

Informations sur le bloc¶

Nom : GLResizeBlock.

Exemple de pipeline¶

graph LR;
    UniversalSourceBlock-->GLUploadBlock;
    GLUploadBlock-->GLResizeBlock;
    GLResizeBlock-->GLDownloadBlock;
    GLDownloadBlock-->VideoRendererBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

var source = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("test.mp4"));

var glUpload = new GLUploadBlock();

// redimensionner en 1280x720 sur le GPU
var glResize = new GLResizeBlock(new GLResizeVideoEffect(1280, 720));

var glDownload = new GLDownloadBlock();
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1);

pipeline.Connect(source.VideoOutput, glUpload.Input);
pipeline.Connect(glUpload.Output, glResize.Input);
pipeline.Connect(glResize.Output, glDownload.Input);
pipeline.Connect(glDownload.Output, videoRenderer.Input);

await pipeline.StartAsync();

Plateformes¶

Windows, macOS, Linux, iOS, Android.

GL Square¶

Le GLSquareBlock applique un effet de distorsion géométrique « square » sur le GPU. Il n'a aucune configuration supplémentaire.

Informations sur le bloc¶

Nom : GLSquareBlock.

Exemple de pipeline¶

graph LR;
    UniversalSourceBlock-->GLUploadBlock;
    GLUploadBlock-->GLSquareBlock;
    GLSquareBlock-->GLDownloadBlock;
    GLDownloadBlock-->VideoRendererBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

var source = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("test.mp4"));

var glUpload = new GLUploadBlock();
var glSquare = new GLSquareBlock();
var glDownload = new GLDownloadBlock();
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1);

pipeline.Connect(source.VideoOutput, glUpload.Input);
pipeline.Connect(glUpload.Output, glSquare.Input);
pipeline.Connect(glSquare.Output, glDownload.Input);
pipeline.Connect(glDownload.Output, videoRenderer.Input);

await pipeline.StartAsync();

Plateformes¶

Windows, macOS, Linux, iOS, Android.

GL Video Converter¶

Le GLVideoConverterBlock effectue une conversion de format de pixel et d'espace colorimétrique accélérée par GPU. Il n'a aucune configuration supplémentaire.

Informations sur le bloc¶

Nom : GLVideoConverterBlock.

Exemple de pipeline¶

graph LR;
    GLUploadBlock-->GLVideoConverterBlock;
    GLVideoConverterBlock-->GLSepiaBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

var source = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("test.mp4"));

var glUpload = new GLUploadBlock();
var glConverter = new GLVideoConverterBlock();
var glSepia = new GLSepiaBlock();
var glDownload = new GLDownloadBlock();
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1);

pipeline.Connect(source.VideoOutput, glUpload.Input);
pipeline.Connect(glUpload.Output, glConverter.Input);
pipeline.Connect(glConverter.Output, glSepia.Input);
pipeline.Connect(glSepia.Output, glDownload.Input);
pipeline.Connect(glDownload.Output, videoRenderer.Input);

await pipeline.StartAsync();

Plateformes¶

Windows, macOS, Linux, iOS, Android.

GL Video Mixer¶

Le GLVideoMixerBlock compose plusieurs flux vidéo d'entrée en une seule sortie sur le GPU, avec positionnement, mise à l'échelle, ordre Z, fondu alpha et incrustation par chrominance propres à chaque flux. Il est configuré avec GLVideoMixerSettings (voir Paramètres du mélangeur ci-dessus) et expose un pin d'entrée par flux configuré. Le bloc implémente IVideoMixerControl, de sorte que les flux d'entrée peuvent être interrogés, mis à jour, animés (Input_Move, StartFadeIn, StartFadeOut) et incrustés par chrominance à l'exécution.

Informations sur le bloc¶

Nom : GLVideoMixerBlock.

Exemple de pipeline¶

graph LR;
    Source1Block-->GLUpload1Block;
    Source2Block-->GLUpload2Block;
    GLUpload1Block-->GLVideoMixerBlock;
    GLUpload2Block-->GLVideoMixerBlock;
    GLVideoMixerBlock-->GLDownloadBlock;
    GLDownloadBlock-->VideoRendererBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

// configurer la sortie du mélangeur et deux flux
var mixerSettings = new GLVideoMixerSettings(1280, 720, new VideoFrameRate(30));
mixerSettings.AddStream(new GLVideoMixerStream(new Rect(0, 0, 1280, 720), 0));
mixerSettings.AddStream(new GLVideoMixerStream(new Rect(960, 480, 1280, 720), 1)); // gauche, haut, droite, bas
var glMixer = new GLVideoMixerBlock(mixerSettings);

// première source
var source1 = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("background.mp4"));
var glUpload1 = new GLUploadBlock();
pipeline.Connect(source1.VideoOutput, glUpload1.Input);
pipeline.Connect(glUpload1.Output, glMixer.Inputs[0]);

// deuxième source (image dans l'image)
var source2 = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("overlay.mp4"));
var glUpload2 = new GLUploadBlock();
pipeline.Connect(source2.VideoOutput, glUpload2.Input);
pipeline.Connect(glUpload2.Output, glMixer.Inputs[1]);

var glDownload = new GLDownloadBlock();
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1);
pipeline.Connect(glMixer.Output, glDownload.Input);
pipeline.Connect(glDownload.Output, videoRenderer.Input);

await pipeline.StartAsync();

Plateformes¶

Windows, macOS, Linux, iOS, Android.

GL Video Renderer¶

Le GLVideoRendererBlock affiche le flux vidéo sur une surface IVideoView à l'aide du rendu OpenGL accéléré matériellement. C'est un bloc terminal (entrée seule) qui accepte en entrée la mémoire CPU comme la mémoire GL. Le moteur de rendu est configuré avec GLVideoRendererSettings (voir Paramètres du moteur de rendu vidéo ci-dessus).

Informations sur le bloc¶

Nom : GLVideoRendererBlock.

Exemple de pipeline¶

graph LR;
    UniversalSourceBlock-->GLVideoRendererBlock;

Exemple de code¶

var pipeline = new MediaBlocksPipeline();

var source = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync("test.mp4"));

// VideoView1 est votre contrôle IVideoView sur le formulaire/la page
var glRenderer = new GLVideoRendererBlock(VideoView1);

pipeline.Connect(source.VideoOutput, glRenderer.Input);

await pipeline.StartAsync();

Sur Android, utilisez la surcharge de constructeur qui prend aussi le pipeline : new GLVideoRendererBlock(pipeline, VideoView1).

Plateformes¶

Windows, macOS, Linux, iOS, Android.