View  Edit  Attributes  History  Attach  Print  Search


ACCUEIL | DOCUMENTATION | STRATEGIES | TESTS


Librairie JavacvPro

Classe OpenCV : restore(), restore2()


Description

  • Ces fonctions recharge le buffer principal avec le contenu d'un des "buffers image" de mémorisation d'image RGB 3 canaux disponibles avec la classe OpenCV de la librairie javacvPro. Respectivement :
    • restore() : recharge le buffer Memory dans le buffer principal, image RGB 3 canaux.
    • restore2(): recharge le buffer Memory2 dans le buffer principal, image RGB 3 canaux.
  • Ces 2 buffers sont particulièrement utiles pour le stockage d'images intermédiaires impliquant plusieurs images. Typiquement, on pourra combiner le buffer principal (typiquement issu d'un flux vidéo) et une image stockée dans Memory et garder le résultat obtenu dans le buffer Memory2.
  • Cette utilisation de buffers distincts évite les effets imprévus liés à l'enregistrement successif dans un même buffer de la source et du résultat d'un traitement d'image.
  • Voir également : substract()

Déclaration source java

public PImage restore()
public PImage restore2()

Syntaxe

opencv.restore(); // recharge le buffer Memory dans le buffer principal

Paramètres

  • opencv : un objet OpenCV déclaré avec le constructeur OpenCV.

Valeur renvoyée

  • Aucun. Le buffer principal contient la copie du buffer Memory ou Memory2. Le buffer Memory utilisé n'est pas modifié.

Exemple


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

// Exemple fonction remember(), restore(), getMemory()

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()); // 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

        //--- mémorise image du buffer principal dans buffer Memory
        opencv.remember();

        //--- affiche image de départ via le buffer mémory ---        
        //image(opencv.getMemory(),0,0); // affiche le buffer Memory OpenCV dans la fenêtre Processing

        //--- opérations sur image ---

        opencv.gray("BUFFER"); // transforme le buffer OpenCV désigné en niveau de gris - copie mise dans le buffer Gray

        //--- affiche image finale ---
        image(opencv.getBuffer(),0,0); // affiche le buffer principal OpenCV dans la fenêtre Processing = image traitée

        opencv.restore(); // recharge le buffer memory dans le buffer principal = l'image de départ
        image (opencv.getBuffer(), opencv.width(), 0); // affiche le buffer principal 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.

Commentaires utilisateurs

Aucun

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