View  Edit  Attributes  History  Attach  Print  Search


ACCUEIL | DOCUMENTATION | STRATEGIES | TESTS


Librairie JavacvPro

Classe OpenCV : getBuffer(), getBufferGray(), getBufferR(), getBufferG(), getBufferB()


Description

  • Ces fonctions renvoient un PImage avec le contenu d'un des "buffers image" disponible avec la classe OpenCV de la librairie javacvPro. Respectivement :
    • getBuffer() : renvoie le buffer principal, image RGB 3 canaux. Equivalent de la fonction image()
    • getBufferGray() : renvoie le buffer Gray (niveau de gris, monocanal)
    • getBufferR() : renvoie le buffer R (canal rouge, monocanal) sous forme d'une image RGB 3 canaux (canal G et B laissés à 0)
    • getBufferG() : renvoie le buffer G (canal vert (Green), monocanal) sous forme d'une image RGB 3 canaux (canal R et B laissés à 0)
    • getBufferB() : renvoie le buffer B (canal bleu, monocanal) sous forme d'une image RGB 3 canaux (canal R et G laissés à 0)
  • Les canaux RGB de l'image du buffer principal sont disponibles dans les buffers R, G et B uniquement après appel de la fonction extractRGB().
  • Cet ensemble de fonctions permet une interface entre Processing et OpenCV simplifiée et une manipulation facilitée des images lors du traitement d'image avec les fonctions de la librairie.
  • Voir également : extractRGB(), image()

Déclaration source java

public PImage getBuffer ()
public PImage getBufferGray()
public PImage getBufferR()
public PImage getBufferG()
public PImage getBufferB()

Syntaxe

img=opencv.getBufferR(); // renvoie le buffer rouge dans le PImage

Paramètres

  • opencv : un objet OpenCV déclaré avec le constructeur OpenCV.
  • img : un objet PImage (conteneur image Processing)

Valeur renvoyée

  • Objet PImage contenant l'image présente dans le buffer voulu, respectivement :
    • getBuffer() : renvoie le buffer principal, image RGB 3 canaux. Equivalent de la fonction image()
    • getBufferGray() : renvoie le buffer Gray (niveau de gris, monocanal)
    • getBufferR() : renvoie le buffer R (canal rouge, monocanal) sous forme d'une image RGB 3 canaux (canal G et B laissés à 0)
    • getBufferG() : renvoie le buffer G (canal vert (Green), monocanal) sous forme d'une image RGB 3 canaux (canal R et B laissés à 0)
    • getBufferB() : renvoie le buffer B (canal bleu, monocanal) sous forme d'une image RGB 3 canaux (canal R et G laissés à 0)

Exemple

L'exemple complet suivant est à copier dans Processing et est exécutable imédiatement si vous êtes connectés à internet :


// Programme d'exemple de la librairie javacvPro
// par X. HINAULT - octobre 2011
// Tous droits réservés - Licence GPLv3

// Exemple fonction extractRGB()

import monclubelec.javacvPro.*; // importe la librairie javacvPro

PImage img;

String url="http://www.mon-club-elec.fr/mes_images/online/lena.jpg"; // String contenant l'adresse internet de l'image à utiliser

OpenCV opencv; // déclare un objet OpenCV principal

void setup(){ // fonction d'initialisation exécutée 1 fois au démarrage

        //-- charge image utilisée ---
        img=loadImage(url,"jpg"); // crée un PImage contenant le fichier à partir adresse web

        //--- initialise OpenCV ---
        opencv = new OpenCV(this); // initialise objet OpenCV à partir du parent This
        opencv.allocate(img.width, img.height); // initialise les buffers OpenCv à la taille de l'image

        opencv.copy(img); // charge le PImage dans le buffer OpenCV

        //--- initialise fenêtre Processing
        size (opencv.width()*2, opencv.height()*2); // crée une fenêtre Processing de la 2xtaille du buffer principal OpenCV
        //size (img.width, img.height); // aalternative en se basant sur l'image d'origine

        //--- affiche image de départ ---        
        image(opencv.getBuffer(),0,0); // affiche le buffer principal OpenCV dans la fenêtre Processing

        //--- opérations sur image ---
        opencv.extractRGB(); // extrait les canaux RGB et les copie dans les buffers RGB

        //--- affiche images finales ---
        image(opencv.getBufferR(),opencv.width(),0); // affiche le buffer rouge  OpenCV dans la fenêtre Processing

        image(opencv.getBufferG(),0,opencv.height()); // affiche le buffer vert OpenCV dans la fenêtre Processing

        image(opencv.getBufferB(),opencv.width(),opencv.height()); // affiche le buffer bleu OpenCV dans la fenêtre Processing

       noLoop(); // stop programme
}


void  draw() { // fonction exécutée en boucle

}

 

Les buffers images de la classe OpenCV

Présentation

  • La classe OpenCV de la librairie javacvPro crée automatiquement lors de l'initialisation (fonction allocate() ) plusieurs "buffers image" (mémoires images) qui permettent la manipulation simplifiées des images à l'aide des fonctions de la librairie avec OpenCV. La liste des buffers disponibles est la suivante :
    • le buffer principal, image à trois canaux RGB, sur lequel sont appliquées par défaut la plupart des fonctions de la librairie.
    • le buffer Gray, en niveaux de gris, monocanal
    • le buffer R, pouvant recevoir le canal rouge, monocanal.
    • le buffer G, pouvant recevoir le canal vert, monocanal.
    • le buffer B, pouvant recevoir le canal bleu, monocanal.
    • le buffer Memory, qui permet le stockage d'image 3 canaux (voir fonction remember() ).
    • le buffer Memory2, qui permet le stockage d'une image 3 canaux également (voir fonction remember2() ).

Vue d'ensemble des buffers Javacvpro

Initialisation des buffers

  • Tous les buffers sont initialisés et dimensionnés à la même taille à l'aide de la fonction allocate().
  • Pour une initialisation séparée avec des tailles différentes des buffers images et des buffers Memory et Memory2, utiliser les fonctions allocateBuffer() et/ou allocateMemory(), allocateMemory2().
  • Ceci sera particulièrement utile notamment dans le cas de l'utilisation des algorithmes de recherche de correspondance entre une image objet et une scène (avec SURF par exemple).

Informations utiles pour un usage avancé de la librairie javacvPro.

  • Les buffers sont en fait des objets IplImage (conteneur image natif de la librairie OpenCV) implémentés par la librairie javacv (sur laquelle est basée la librairie javacvPro).
  • La plupart des fonctions de la classe OpenCV de la librairie javacvPro sont appliquées par défaut sur le buffer principal.
  • Mais on pourra également utiliser directement les autres buffers en les appelant par leur nom pour toutes les fonctions de la classe OpenCV de la librairie javacvPro qui acceptent en paramètre un objet IplImage. Il suffira dans ce cas de spécifier le buffer voulu par son nom. Par exemple :
opencv.fonction(opencv.Memory2);

où opencv est un objet OpenCV.

Dénomination des buffers de la classe OpenCV :

  • Les noms des buffers disponibles sont :
    • Buffer : buffer principal (3 canaux RGB)
    • BufferGray : buffer Gray (monocanal)
    • BufferR : buffer canal rouge (monocanal)
    • BufferG : buffer canal vert (monocanal)
    • BufferB : buffer canal bleu (monocanal)
    • Memory : buffer mémoire image (3 canaux RGB)
    • Memory2 : buffer mémoire image n°2 (3 canaux RGB)
  • La désignation d'un buffer à l'aide de son nom se fera sous la forme opencv.nom

Identifiants des buffers de la classe OpenCV :

  • Les buffers de la classe OpenCV peuvent également être appelés par les identifiants prédéfinis suivants avec les fonctions recevant un String en paramètre :
    • BUFFER : buffer principal (3 canaux RGB)
    • GRAY : buffer Gray (monocanal)
    • RED : buffer canal rouge (monocanal)
    • GREEN : buffer canal vert (monocanal)
    • BLUE : buffer canal bleu (monocanal)
    • MEMORY : buffer mémoire image (3 canaux RGB)
    • MEMORY2 : buffer mémoire image n°2 (3 canaux RGB)

Synthèse des fonctions utiles pour la manipulation des buffers JavacvPro

Cliquer sur l'image pour agrandir.

Durée d'exécution de la fonction

  • La réalisation de 100 exécutions successives de la fonction getBuffer() dans Processing (sur un Intel Dual Core à 2.33Gz sous Ubuntu 10.04 LTS avec la version OpenCV 2.3.1) pour une image de 320x240 donne une durée moyenne pour chaque exécution de :
    • de 3 ms en mode "interprété" soit une fréquence maximale potentielle de 333 fps.
    • de 3 ms en mode "compilé" soit une fréquence maximale potentielle de 333 fps.

Commentaires utilisateurs

Aucun

Cette page est une création originale de Xavier HINAULT - Tous droits réservés - 2011