Functions (Javasnice 0.2.1 API)

java.lang.Object
- org.javascool.proglets.detectionForme.Functions

```
public class Functions
extends Object
```
Définit les fonctions de la proglet qui permettent de manipuler les pixels d'une image.

See Also:

code source

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`blur(int num)` Box blur filter
`static void`	`checkRandomShape(String typeShape, int posxShape, int posyShape, int coteShape, double angleRotation)` Vérification de la détection
`static void`	`clearImage(int num)` Réinitialisation des images de travail (fond blanc) On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`closeFileReader()` Fermeture du fichier ouvert en lecture.
`static void`	`closeFileWriter()` Fermeture du fichier ouvert en Ecriture.
`static int`	`codeCouleur(Color c)` Renvoie le code coudeur de la couleur spécifiée
`static void`	`contour(int num)` Contour filter
`static void`	`convolveImage(int num, float[] mask)` Convolue l'image avec le masque spécifié.
`static void`	`copyImage(int num1, int num2)` Copie de l'image de travail num1 dans l'image de travail num2 On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`copyImage(int num1, int num2, int borderWidth)` Copie de l'image de travail num1 dans l'image de travail num2 avec ajout d'une bordure de largeur borderWidth.
`static void`	`copyImage(int num1, int num2, int x, int y, int w, int h)` Copie d'une partie de l'image de travail num1 dans l'image de travail num2 On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`createImage(int num, int width, int height)` Création des images de travail On dispose de 4 images de travail (1,2,3 ou 4) - La taille de l'image ne doit pas être trop importante(pas plus de 500^2).
`static void`	`createImageFromPixMap(int num, int[][] pixMap, int width, int height)` Création d'une image à partir d'un tableau d'entiers On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`createRandomShapeImage(int scenario)` Trace aléatoirement la forme à détecter dans l'image on travail dans l'image de travail [1] la fonction définit une image de 400 x 400
`static void`	`cutImage(int num, int x, int y, int w, int h)` Rogner une image On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`diffuse(int num)` Image diffuser filter
`static void`	`disposeImage()`
`static void`	`disposeImage(int num)` Suppression des images de travail On dispose de 4 images (1,2,3 ou 4) Par défaut on supprime les 4 images de travail.
`static void`	`drawFillOval(int num, int xc, int yc, int w, int h, Color c)` Tracer d'un ovale plein dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`drawFillRect(int num, int xc, int yc, int w, int h, Color c)` Tracer d'un rectangle plein dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`drawOval(int num, int xc, int yc, int w, int h, Color c)` Tracer d'un ovale dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`drawRect(int num, int xc, int yc, int w, int h, Color c)` Tracer d'un rectangle dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`drawSegment(int num, int x1, int y1, int x2, int y2, Color c)` Tracer d'un segment dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`drawString(int num, String str, int x, int y, Color c)` Tracer d'une chaîne de caractères dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`edge(int num)` Edge detection filter
`static int`	`getAlpha(int color)` Returns the alpha component in the range 0-255 in the default sRGB space.
`static int`	`getBlue(int color)` Returns the blue component in the range 0-255 in the default sRGB space.
`static int`	`getGreen(int color)` Returns the green component in the range 0-255 in the default sRGB space.
`static int`	`getImageHeight(int num)` Renvoie la hauteur de l'image.
`static int`	`getImageWidth(int num)` Renvoie la largeur de l'image.
`static int`	`getPixelColor(int num, int x, int y)` Retourne la valeur d'un pixel de l'image de travail.
`static int`	`getRed(int color)` Returns the red component in the range 0-255 in the default sRGB space.
`static boolean`	`isPixelColor(int num, int x, int y, Color c)` teste la valeur d'un pixel de l'image de travail.
`static boolean`	`isPixelColor(int num, int x, int y, int c)`
`static void`	`loadImage(int num, String location)` Charge une image locale ou distante.
`static void`	`loadImageToPixMap(int num, int[][] pixMap)` Chargement d'une image dans un tableau d'entiers On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`openFileReader(String nomFichier)` Ouverture du fichier en lecture.
`static void`	`openFileWriter(String nomFichier)` Ouverture du fichier en Ecriture.
`static void`	`pixelate(int num, int size)` Pixelate an image
`static int`	`readNextCode()` Lecture du code suivant dans le fichier.
`static void`	`resizeImage(int num, int newW, int newH)` Redimensionne l'image à la nouvelle taille spécifiée On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`resizeImageWithHint(int num, int newW, int newH)` Redimensionne l'image à la nouvelle taille spécifiée On utilise ici un rendu supérieur (traitement plus long) On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`rotateImage(int num, double angle)` Rotation de l'image suivant l'angle spécifié On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`saveImage(int num, String location)` Sauvegarde d'une image de travail.
`static void`	`setPixel(int num, int x, int y, Color c)`
`static void`	`setPixel(int num, int x, int y, int c)` Change la valeur d'un pixel de l'image de travail.
`static void`	`setRunnable(Runnable runnable)` Définit une portion de code appelée à chaque clic de souris.
`static void`	`showImage(int num)` Affichage des images de travail dans le panel de la proglet On dispose de 4 images de travail (1,2,3 ou 4)
`static void`	`showPipImage()` Affiche en simultané les 4 images de travail seules les images existantes sont affichées PIP : Picture In Picture
`static void`	`sideDetection(int num)` Détection des bords
`static void`	`writeNextCode(int c)` Ecriture du code suivant (octet) dans le fichier ouvert en écriture.
`static void`	`xxRandomPixelDrawing()` Trace aléatoirement un pixel noir dans l'image on travail dans l'image de travail [1] la fonction définit une image de 400 x 400

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createImage
```
public static void createImage(int num,
                               int width,
                               int height)
```
Création des images de travail On dispose de 4 images de travail (1,2,3 ou 4) - La taille de l'image ne doit pas être trop importante(pas plus de 500^2).

Parameters:

width - largeur de l'image.

height - hauteur de l'image.

num - numéro de l'image de travail.*

disposeImage
```
public static void disposeImage(int num)
```
Suppression des images de travail On dispose de 4 images (1,2,3 ou 4) Par défaut on supprime les 4 images de travail.

Parameters:

num - numéro de l'image de travail (si précisé, sinon toutes les images).

disposeImage
```
public static void disposeImage()
```

loadImage

public static void loadImage(int num,
                             String location)

Charge une image locale ou distante. La taille de l'image ne doit pas être trop importante (pas plus de 500^2).

Parameters:

num - numéro de l'image de travail dans laquelle charger l'image. On dispose de 4 images (1,2,3 ou 4)

location - Une URL (Universal Resource Location) de la forme:

URL (Universal Resource Location) prises en charge
`http:/path-name`	pour aller chercher le contenu sur un site web
`http:/path-name?param_i=value_i&..`	pour le récupérer sous forme de requête HTTP
`file:/path-name`	pour le charger du système de fichier local ou en tant que ressource Java dans le CLASSPATH
`jar:/jar-path-name!/jar-entry`	pour le charger d'une archive (exemple:`jar:http://javascool.gforge.inria.fr/javascool.jar!/META-INF/MANIFEST.MF`)

Throws:

IllegalArgumentException - Si l'URL est mal formée.

RuntimeException - Si une erreur d'entrée-sortie s'est produite.

saveImage

public static void saveImage(int num,
                             String location)

Sauvegarde d'une image de travail.

Parameters:

num - numéro de l'image de travail On dispose de 4 images (1,2,3 ou 4)

location - Une URL (Universal Resource Location) de la forme:

URL (Universal Resource Location) prises en charge
`ftp:/path-name`	pour sauver sur un site FTP.
`file:/path-name`	pour sauver dans le système de fichier local (le `file:` est optionnel).
`mailto:address?subject=subject`	pour envoyer un courriel avec le texte en contenu.
`stdout:/`	pour l'imprimer dans la console.

Throws:

IllegalArgumentException - Si l'URL est mal formée.

RuntimeException - Si une erreur d'entrée-sortie s'est produite.

createImageFromPixMap
```
public static void createImageFromPixMap(int num,
                                         int[][] pixMap,
                                         int width,
                                         int height)
```
Création d'une image à partir d'un tableau d'entiers On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

pixMap - Tableau d'entiers.

width - largeur pixMap.

height - hauteur pixMap.

loadImageToPixMap
```
public static void loadImageToPixMap(int num,
                                     int[][] pixMap)
```
Chargement d'une image dans un tableau d'entiers On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

pixMap - Tableau d'entiers.

showImage
```
public static void showImage(int num)
```
Affichage des images de travail dans le panel de la proglet On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.*

clearImage
```
public static void clearImage(int num)
```
Réinitialisation des images de travail (fond blanc) On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.*

copyImage
```
public static void copyImage(int num1,
                             int num2)
```
Copie de l'image de travail num1 dans l'image de travail num2 On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num1 - numéro de l'image source

num2 - numéro de l'image destination

copyImage
```
public static void copyImage(int num1,
                             int num2,
                             int x,
                             int y,
                             int w,
                             int h)
```
Copie d'une partie de l'image de travail num1 dans l'image de travail num2 On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num1 - numéro de l'image source

num2 - numéro de l'image destination

x - abscisse de la zone à récupérer

y - ordonnée de la zone à récupérer

w - largeur de la zone à récupérer

h - hauteur de la zone à récupérer

copyImage
```
public static void copyImage(int num1,
                             int num2,
                             int borderWidth)
```
Copie de l'image de travail num1 dans l'image de travail num2 avec ajout d'une bordure de largeur borderWidth. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num1 - numéro de l'image source

num2 - numéro de l'image destination

borderWidth - largeur du bord ajouté

cutImage
```
public static void cutImage(int num,
                            int x,
                            int y,
                            int w,
                            int h)
```
Rogner une image On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image à rognenr

x - abscisse de la zone à garder

y - ordonnée de la zone à garder

w - largeur de la zone à garder

h - hauteur de la zone à garder

setPixel
```
public static void setPixel(int num,
                            int x,
                            int y,
                            int c)
```
Change la valeur d'un pixel de l'image de travail. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.*

x - Abcisse de l'image.

y - Ordonnée de l'image.

c - Couleur: "black" (default), "blue", "cyan", "gray", "green", "magenta", "orange", "pink", "red", "white", "yellow".

setPixel

public static void setPixel(int num,
                            int x,
                            int y,
                            Color c)

getPixelColor
```
public static int getPixelColor(int num,
                                int x,
                                int y)
```
Retourne la valeur d'un pixel de l'image de travail. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.*

x - Abcisse de l'image.

y - Ordonnée de l'image.

Returns:

Renvoie la couleur spécifiée (entier)

getAlpha
```
public static int getAlpha(int color)
```
Returns the alpha component in the range 0-255 in the default sRGB space.

Parameters:

color - couleur du pixel (int)

Returns:

the alpha component.

getRed
```
public static int getRed(int color)
```
Returns the red component in the range 0-255 in the default sRGB space.

Parameters:

color - couleur du pixel (int)

Returns:

the red component.

getGreen
```
public static int getGreen(int color)
```
Returns the green component in the range 0-255 in the default sRGB space.

Parameters:

color - couleur du pixel (int)

Returns:

the green component.

getBlue
```
public static int getBlue(int color)
```
Returns the blue component in the range 0-255 in the default sRGB space.

Parameters:

color - couleur du pixel (int)

Returns:

the blue component.

isPixelColor
```
public static boolean isPixelColor(int num,
                                   int x,
                                   int y,
                                   Color c)
```
teste la valeur d'un pixel de l'image de travail. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.*

x - Abcisse de l'image.

y - Ordonnée de l'image.

c - Couleur: "black" (default), "blue", "cyan", "gray", "green", "magenta", "orange", "pink", "red", "white", "yellow".

Returns:

Renvoie true si le pixel est de la couleur spécifiée

isPixelColor

public static boolean isPixelColor(int num,
                                   int x,
                                   int y,
                                   int c)

codeCouleur
```
public static int codeCouleur(Color c)
```
Renvoie le code coudeur de la couleur spécifiée

Parameters:

c - Couleur: "black" (default), "blue", "cyan", "gray", "green", "magenta", "orange", "pink", "red", "white", "yellow".

Returns:

Renvoie la valeur int RGB de la couleur spécifiée

drawRect
```
public static void drawRect(int num,
                            int xc,
                            int yc,
                            int w,
                            int h,
                            Color c)
```
Tracer d'un rectangle dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

xc - abscisse coin haut gauche du rectangle.

yc - ordonnée coin haut gauche du rectangle.

w - largueur côté du rectangle.

h - hauteur côté du rectangle.

c - couleur du tracé.

drawFillRect
```
public static void drawFillRect(int num,
                                int xc,
                                int yc,
                                int w,
                                int h,
                                Color c)
```
Tracer d'un rectangle plein dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

xc - abscisse coin haut gauche du rectangle.

yc - ordonnée coin haut gauche du rectangle.

w - largueur côté du rectangle.

h - hauteur côté du rectangle.

c - couleur du tracé.

drawOval
```
public static void drawOval(int num,
                            int xc,
                            int yc,
                            int w,
                            int h,
                            Color c)
```
Tracer d'un ovale dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

xc - abscisse coin haut gauche du ovale.

yc - ordonnée coin haut gauche du ovale.

w - largueur du carré englobant.

h - hauteur du carré englobant.

c - couleur du tracé.

drawFillOval
```
public static void drawFillOval(int num,
                                int xc,
                                int yc,
                                int w,
                                int h,
                                Color c)
```
Tracer d'un ovale plein dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

xc - abscisse coin haut gauche du ovale.

yc - ordonnée coin haut gauche du ovale.

w - largueur du carré englobant.

h - hauteur du carré englobant.

c - couleur du tracé.

drawSegment

public static void drawSegment(int num,
                               int x1,
                               int y1,
                               int x2,
                               int y2,
                               Color c)

Tracer d'un segment dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:: num - numéro de l'image de travail.; x1 - abscisse point initial.; y1 - ordonnée point initial.; x2 - abscisse point final.; y2 - ordonnée point final.; c - couleur du tracé.*

drawString
```
public static void drawString(int num,
                              String str,
                              int x,
                              int y,
                              Color c)
```
Tracer d'une chaîne de caractères dans l'images de travail On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

str - message à afficher.

x - abscisse coin haut gauche du carré.

y - ordonnée coin haut gauche du carré.

c - couleur du tracé.

getImageWidth
```
public static int getImageWidth(int num)
```
Renvoie la largeur de l'image. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

getImageHeight
```
public static int getImageHeight(int num)
```
Renvoie la hauteur de l'image. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

convolveImage
```
public static void convolveImage(int num,
                                 float[] mask)
```
Convolue l'image avec le masque spécifié. On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

mask - masque de convolution qui doit être défini de la manière suivante : float[ ] masque = { 0.1f, 0.1f, 0.1f, 0.1f, 0.2f, 0.1f, 0.1f, 0.1f, 0.1f};

resizeImage
```
public static void resizeImage(int num,
                               int newW,
                               int newH)
```
Redimensionne l'image à la nouvelle taille spécifiée On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

newW - nouvelle largeur

newH - nouvelle hauteur

resizeImageWithHint
```
public static void resizeImageWithHint(int num,
                                       int newW,
                                       int newH)
```
Redimensionne l'image à la nouvelle taille spécifiée On utilise ici un rendu supérieur (traitement plus long) On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

newW - nouvelle largeur

newH - nouvelle hauteur

rotateImage
```
public static void rotateImage(int num,
                               double angle)
```
Rotation de l'image suivant l'angle spécifié On dispose de 4 images de travail (1,2,3 ou 4)

Parameters:

num - numéro de l'image de travail.

angle - angle de rotation en degrés

showPipImage
```
public static void showPipImage()
```
Affiche en simultané les 4 images de travail seules les images existantes sont affichées PIP : Picture In Picture

openFileReader
```
public static void openFileReader(String nomFichier)
```
Ouverture du fichier en lecture.

Parameters:

nomFichier - nom du fichier à ouvrir

readNextCode
```
public static int readNextCode()
```
Lecture du code suivant dans le fichier.

Returns:

valeur suivante lu (type int).

closeFileReader
```
public static void closeFileReader()
```
Fermeture du fichier ouvert en lecture.

openFileWriter
```
public static void openFileWriter(String nomFichier)
```
Ouverture du fichier en Ecriture.

Parameters:

nomFichier - nom du fichier à ouvrir

writeNextCode
```
public static void writeNextCode(int c)
```
Ecriture du code suivant (octet) dans le fichier ouvert en écriture.

Parameters:

c - code à ecrire (type int) seul l'octet de poid faible est écrit.

closeFileWriter
```
public static void closeFileWriter()
```
Fermeture du fichier ouvert en Ecriture.

createRandomShapeImage
```
public static void createRandomShapeImage(int scenario)
```
Trace aléatoirement la forme à détecter dans l'image on travail dans l'image de travail [1] la fonction définit une image de 400 x 400

Parameters:

scenario - définit le type de scénario proposé : - (1) : détection d'un pixel - (2) : détection d'un carré - (3) : détection d'un cercle - (4) : détection cercle ou carré - (5) : détection d'un carré + rotation - (6) : détection d'un carré + rotation + bruit léger - (7) : détection d'un cercle + bruit léger - (8) : détection carré ou cercle + rotation - (9) : détection carré ou cercle + rotation + bruit - (10) : détection d'un carré + rotation + bruit fort - (11) : détection d'un cercle + bruit fort - (12) : détection carré ou cercle + rotation + bruit fort

checkRandomShape
```
public static void checkRandomShape(String typeShape,
                                    int posxShape,
                                    int posyShape,
                                    int coteShape,
                                    double angleRotation)
```
Vérification de la détection

Parameters:

typeShape - type de forme détectée (square ou circle)

posxShape - abscisse du coin haut gauche du carré englobant

posyShape - ordonnée du coin haut gauche du carré englobant

coteShape - largeur du carré englobant

angleRotation - angle de la rotation subit par la forme

xxRandomPixelDrawing
```
public static void xxRandomPixelDrawing()
```
Trace aléatoirement un pixel noir dans l'image on travail dans l'image de travail [1] la fonction définit une image de 400 x 400

sideDetection

public static void sideDetection(int num)

Détection des bords

blur
```
public static void blur(int num)
```
Box blur filter

Parameters:

num - Image number

edge
```
public static void edge(int num)
```
Edge detection filter

Parameters:

num - Image number

diffuse
```
public static void diffuse(int num)
```
Image diffuser filter

Parameters:

num - Image number

contour
```
public static void contour(int num)
```
Contour filter

Parameters:

num - Image number

pixelate
```
public static void pixelate(int num,
                            int size)
```
Pixelate an image

Parameters:

num - Image number

size - Size in pixel of each block

setRunnable
```
public static void setRunnable(Runnable runnable)
```
Définit une portion de code appelée à chaque clic de souris.

Parameters:

runnable - La portion de code à appeler, ou null si il n'y en a pas.

Class Functions

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createImage

disposeImage

disposeImage

loadImage

saveImage

createImageFromPixMap

loadImageToPixMap

showImage

clearImage

copyImage

copyImage

copyImage

cutImage

setPixel

setPixel

getPixelColor

getAlpha

getRed

getGreen

getBlue

isPixelColor

isPixelColor

codeCouleur

drawRect

drawFillRect

drawOval

drawFillOval

drawSegment

drawString

getImageWidth

getImageHeight

convolveImage

resizeImage

resizeImageWithHint

rotateImage

showPipImage

openFileReader

readNextCode

closeFileReader

openFileWriter

writeNextCode

closeFileWriter

createRandomShapeImage

checkRandomShape

xxRandomPixelDrawing

sideDetection

blur

edge

diffuse

contour

pixelate

setRunnable