Cet objet représente une image.

Attention, cette page n'est pas complètement traduite. Voir la version originale : image

Fonction constructeur.

var monObjet = new Image();

var monObjet = new Image(autreImage);

var monObjet = new Image(x, y);

1. autreImage - (Image) l'autre Image à copier

• (ParameterTypeError) type de paramètre incorrect
• (ParameterCountError) compte de paramètre incorrect

Créer une nouvelle image vide.

var monObjet = new Image();

Créer une Image représentant une copie de autreImage .

var monObjet = new Image(autreImage);

Prend une capture d'écran de l'écran entier ou seulement de la fenêtre et conserve le résultat dans une nouvelle Image.

var monObjet = Image.takeScreenshot();

var monObjet = Image.takeScreenshot(fenêtre);

1. fenêtre - (Window) la fenêtre dont vous voulez capturer une image

• (InvalidWindowError) fenêtre invalide

[TODO:Translate]

Take a screenshot of one screen and store the result in a new Image. [Added in Actionaz 3.7.0.]

var myObject = Image.takeScreenshotUsingScreenIndex(0);

1. screenIndex - (integer) the index of the screen to screenshot

• (InvalidScreenIndexError) invalid screen index

Rend une copie de cette Image.

monObjet.clone();

• (Image) une copie de cette Image

var copieDeMonObjet = monObjet.clone();

Renvoie vrai si cette Image et un autre se réfèrent à la même image.

monObjet.equals(autre);

1. autre - (Image) une autre Image

• (bool) vrai si autre se réfère à la même image

if(monPremierObjet.equals(monDeuxièmeObjet))
	//Faire quelque chose

Retourne une chaîne représentant cette Image.

monObjet.toString();

• (string) une chaîne représentant cette Image.

Console.print(monObjet.toString());

On appelle automatiquement cette méthode en essayant de convertir une Image en chaîne.

Met les données de cette Image.

monObjet.setData(data);

1. data - (RawData) RawData de l'image

• (Image) cette image

• (ImageDataError) données d'image invalide

Les formats d'image soutenus sont BMP, GIF, JPG, JPEG, PNG, PBM, PGM, PPM, TIFF, XBM et XPM.

Rend les données de cette Image comme RawData dans le format de BMP.

monObjet.data();

• (RawData) cette Image comme RawData

• (ImageDataError) incapable de recevoir les données d'image

Charge l'Image d'un dossier.

monObjet.loadFromFile(nomDeFichier );

1. nomDeFichier - (string) le nom du fichier à charger

• (Image) cette image

• (LoadImageError) incapable de charger l'image

Les formats d'image soutenus sont BMP, GIF, JPG, JPEG, PNG, PBM, PGM, PPM, TIFF, XBM et XPM.

Enregistre l'image dans un fichier.

monObjet.saveToFile(nomDeFichier);

1. nomDeFichier - (string) nom de fichier à enregistrer dans

• (Image) cette image

• (SaveImageError) incapable de sauver l'image

Les formats d'image soutenus sont BMP, JPG, JPEG, PNG, PPM, TIFF, XBM et XPM.

Applique un filtre sur cette Image.

monObjet.applyFilter(filtre);

monObject.applyFilter(filtre, options);

1. filtre - (Filtre) le filtre à utiliser
2. options - (objet) option de filtre
   • filterChannels - (chaîne) la couleur sur laquelle sera appliquée le filtre. Une chaîne de caractères constituée de zéro ou une occurence des caractères r,g,b,a
   • filterBorderPolicy - (string) utilisé avec le filtre de convolution. Les valeurs sont "mirror", "extend" ou "wrap"
   • convolutionDivisor - (integer) le diviseur de convolution
   • convolutionBias - (integer) le biais de convolution
   • radius - (number) le radius
   • force - (number) la force (Utilise la, Luc!)
   • center - (object) le centre
     • x - (integer) la coordonnée x
     • y - (integer) la coordonnée y

• (Image) cette image

• (ApplyFilterError) incapable d'appliquer le filtre

[TODO:Translate]

Returns a pixel from this Image.

myObject.pixel(x, y);

1. x - (integer) x coordinate of the pixel to return
2. y - (integer) y coordinate of the pixel to return

• (Color) the pixel

Sets a pixel from this Image.

myObject.pixel(x, y, color);

myObject.pixel(x, y, colorString);

myObject.pixel(x, y, red, green, blue);

1. x - (integer) x coordinate of the pixel to set
2. y - (integer) y coordinate of the pixel to set
3. color - (Color) color of the pixel to set
4. red - (integer) red value of the color to set
5. green - (integer) green value of the color to set
6. blue - (integer) blue value of the color to set

• (Image) this Image

Mirror this Image.

myObject.mirror(mirrorOrientation);

1. mirrorOrientation - (MirrorOrientation) mirror orientation

• (Image) this Image

Resizes this Image.

myObject.setSize(size);

myObject.setSize(width, height);

1. size - (Size) the new Image size
2. width - (integer) the new width of this Image
3. height - (integer) the new height of this Image

• (Image) this Image

Returns the size of this Image.

myObject.size();

• (Size) the size of this Image

Returns the width of this Image.

myObject.width();

• (integer) the width of this Image

Returns the height of this Image.

myObject.height();

• (integer) the height of this Image

Returns a copy of this Image or only a part of it.

myObject.copy();

myObject.copy(rect);

1. rect - (Rect) the section of this Image to copy

• (Image) a new copy of this Image

Searches for another image contained in this one.

Added in Actionaz 3.0.1.

myObject.findSubImage(otherImage);

myObject.findSubImage(otherImage, options);

1. otherImage - (Image) the Image to find
2. options - (object) search options
   • confidenceMinimum - (integer) the minimum confidence percentage, 100 means perfect match (default: 70)
   • downPyramidCount - (integer) the number of pyramids to use. A pyramid is a subdivision of the image used to accelerate the search. Choose 1 here if the searched image is not very different from this image. (default: 2)
   • method - (Method) the search method to use (default: CorrelationCoefficient) [Added in Actionaz 3.7.0.]

• (object) the matching point, or null if no matching point can be found
  • position - (Point) the matching image center
  • confidence - (integer) the confidence percentage

• (FindSubImageError) an error occured while searching for a sub-image
• (ParameterTypeError) incorrect parameter type

//Searches for an object on the screen
var screenShot = Image.takeScreenshot();
var imageToFind = new Image("object.png");
 
var searchResult = screenShot.findSubImage(imageToFind);
if(searchResult)
    Console.print("Matching image found, position: " + searchResult.position + ", confidence: " + searchResult.confidence);
else
    Console.print("No matching image found.");

Searches for images contained in this one.

Added in Actionaz 3.0.1.

myObject.findSubImages(otherImage);

myObject.findSubImages(otherImage, options);

1. otherImage - (Image) the Image to find
2. options - (object) search options
   • confidenceMinimum - (integer) the minimum confidence percentage, 100 means perfect match (default: 70)
   • downPyramidCount - (integer) the number of pyramids to use. A pyramid is a subdivision of the image used to accelerate the search. Choose 1 here if the searched image is not very different from this image. (default: 2)
   • searchExpansion - (integer) the number of pixels to shift when searching for another matching image (default: 15)
   • maximumMatches - (integer) the maximal number of matches (default: 10)
   • method - (Method) the search method to use (default: CorrelationCoefficient) [Added in Actionaz 3.7.0.]

• (array of objects) the matching points, or null if no matching point can be found
  • position - (Point) the matching image center
  • confidence - (integer) the confidence percentage

• (FindSubImageError) an error occured while searching for a sub-image
• (ParameterTypeError) incorrect parameter type

//Searches for objects on the screen
var screenShot = Image.takeScreenshot();
var imageToFind = new Image("object.png");
 
var searchResult = screenShot.findSubImages(imageToFind);
if(searchResult)
{
    Console.print("Matching images found\n");
 
    for(var i = 0; i < searchResult.length; ++i)
    {
        Console.print("position: " + searchResult[i].position + ", confidence: " + searchResult[i].confidence + "\n");
    }
}
else
    Console.print("No matching images found.");

Searches for another image contained in this one in asynchronous mode.

Added in Actionaz 3.0.1.

myObject.findSubImageAsync(otherImage, callback);

myObject.findSubImageAsync(otherImage, callback, options);

1. otherImage - (Image) the Image to find
2. callback(object) - (function) the function that will be called when the search ends
   • position - (Point) the matching image center
   • confidence - (integer) the confidence percentage
3. options - (object) search options
   • confidenceMinimum - (integer) the minimum confidence percentage, 100 means perfect match (default: 70)
   • downPyramidCount - (integer) the number of pyramids to use. A pyramid is a subdivision of the image used to accelerate the search. Choose 1 here if the searched image is not very different from this image. (default: 2)
   • searchExpansion - (integer) the number of pixels to shift when searching for another matching image (default: 15)
   • method - (Method) the search method to use (default: CorrelationCoefficient) [Added in Actionaz 3.7.0.]

• (Image) this Image

• (FindSubImageError) an error occured while searching for a sub-image
• (ParameterTypeError) incorrect parameter type

//Searches for an object on the screen
var screenShot = Image.takeScreenshot();
var imageToFind = new Image("object.png");
 
screenShot.findSubImageAsync(imageToFind, function(searchResult)
{
    if(searchResult)
        Console.print("Matching image found, position: " + searchResult.position + ", confidence: " + searchResult.confidence);
    else
        Console.print("No matching image found.");
});

Searches for images contained in this one in asynchronous mode.

Added in Actionaz 3.0.1.

myObject.findSubImagesAsync(otherImage, callback);

myObject.findSubImagesAsync(otherImage, callback, options);

1. otherImage - (Image) the Image to find
2. callback(object) - (function) the function that will be called when the search ends
   • position - (Point) the matching image center
   • confidence - (integer) the confidence percentage
3. options - (object) search options
   • confidenceMinimum - (integer) the minimum confidence percentage, 100 means perfect match (default: 70)
   • downPyramidCount - (integer) the number of pyramids to use. A pyramid is a subdivision of the image used to accelerate the search. Choose 1 here if the searched image is not very different from this image. (default: 2)
   • searchExpansion - (integer) the number of pixels to shift when searching for another matching image (default: 15)
   • maximumMatches - (integer) the maximal number of matches (default: 10)
   • method - (Method) the search method to use (default: CorrelationCoefficient) [Added in Actionaz 3.7.0.]

• (Image) this Image

• (FindSubImageError) an error occured while searching for a sub-image
• (ParameterTypeError) incorrect parameter type

//Searches for objects on the screen
var screenShot = Image.takeScreenshot();
var imageToFind = new Image("object.png");
 
screenShot.findSubImagesAsync(imageToFind, function(searchResult)
{
    if(searchResult)
    {
        Console.print("Matching images found\n");
 
        for(var i = 0; i < searchResult.length; ++i)
        {
            Console.print("position: " + searchResult[i].position + ", confidence: " + searchResult[i].confidence + "\n");
        }
    }
    else
        Console.print("No matching images found.");
});

Image filters.

1. ConvolutionFilter: the convolution filter
2. GaussianBlur: a gaussian blur
3. Defocus: blurs the image
4. Highlight: highlight the image
5. Sharpen: sharpens the image
6. SharpenMore: sharpens the image
7. SharpenEvenMore: sharpens the image
8. EdgeDetect: edge detection filter
9. BigEdge: edge detection filter (thicker edges)
10. Emboss: embosses the image (no color preservation)
11. EmbossColor: embosses the image (color preservation)
12. Negative: negates a color channel
13. RemoveChannel: remove a color channel
14. Punch: distorts the image

Mirror orientation.

1. Vertical: a vertical mirror
2. Horizontal: an horizontal mirror

Search method. [Added in Actionaz 3.7.0.]

1. CorrelationCoefficient: correlation coefficient, best for most use cases
2. CrossCorrelation: cross correlation
3. SquaredDifference: squared difference