View  Edit  Attributes  History  Attach  Print  Search


ACCUEIL | DOCUMENTATION | STRATEGIES | TESTS


Librairie JavacvPro

Classe OpenCV : allocate()


Description

  • La fonction allocate() réalise l'initialisation en une fois et à la même taille de l'ensemble des "buffers image" (mémoire image) utilisés par la librairie. Ces buffers vont permettre l'utilisation simplifiée des images et vont faciliter les échanges entre Processing et OpenCV.
  • Cette fonction est obligatoire afin de pouvoir réaliser des opérations sur des images avec les fonctions de la librairie et est à mettre dans la fonction setup() juste après l'initialisation de l'objet principal OpenCV utilisé par le programme.

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.

Déclaration source java

public void allocate (int widthIn, int heightIn)

Syntaxe

allocate (width, height);

Paramètres

  • width (int) : largeur en pixels à utiliser pour les buffers OpenCV
  • height (int) : hauteur en pixels à utiliser pour les buffers OpenCV

Valeur renvoyée

Aucune

Exemple


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

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

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

        size(320,240);

        opencv = new OpenCV(this); // initialise objet OpenCV à partir du parent This
        opencv.allocate(width,height); // crée les buffers image de la taille voulue

}


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

}
 

Commentaires utilisateurs

  • Typiquement, utiliser la même taille d'image pour les buffers que pour la fenêtre Processing.

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