Aide:PixelSearch.txt

Document original V3.3.6.1 :

###Function###
PixelSearch

###Description###
Searches a rectangle of pixels for the pixel color provided.

###Syntax###
PixelSearch ( left, top, right, bottom, color [, shade-variation [, step [, hwnd]]] )


###Parameters###
@@ParamTable@@
left
	left coordinate of rectangle.
top
	top coordinate of rectangle.
right
	right coordinate of rectangle.
bottom
	bottom coordinate of rectangle.
color
	Colour value of pixel to find (in decimal or hex).
shade-variation
	[optional] A number between 0 and 255 to indicate the allowed number of shades of variation of the red, green, and blue components of the colour. Default is 0 (exact match).
step
	[optional] Instead of searching each pixel use a value larger than 1 to skip pixels (for speed).  E.g. A value of 2 will only check every other pixel.  Default is 1.
hwnd
	[optional] Window handle to be used.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns a two-element array of pixel's coordinates. (Array[0] = x, Array[1] = y).
Failure:	Sets @error to 1 if color is not found.
@@End@@


###Remarks###
The search direction varies as follows:
	Left-to-Right - left < right
	Right-to-Left - right < left
	Top-to-Bottom - top < bottom
	Bottom-to-Top - bottom < top
Changing the search direction can be a useful optimization if the color being searched for frequently appears in in a specific quandrat of the search area since less searching is done if the search starts in the most common quadrant.

Remember, a typical display at 1024 x 768 has 786432 pixels. Although PixelSearch is optimized, narrowing the search area helps speed up the result.


###Related###
PixelChecksum, PixelGetColor, PixelCoordMode (Option)


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
PixelSearch

###Description###
Recherche dans un rectangle de pixels, un pixel de couleur définie.


###Syntax###
PixelSearch ( left, top, right, bottom, color [, shade-variation [, step [, hwnd]]] )


###Parameters###
@@ParamTable@@
left
	coordonnée gauche du rectangle.
top
	coordonnée supérieure du rectangle.
right
	coordonnée droite du rectangle.
bottom
	coordonnée inférieure du rectangle.
color
	Valeur de la couleur du pixel à trouver (en décimal ou hexadécimal).
shade-variation
	[optionnel] Un nombre entre 0 et 255 pour indiquer le nombre de variation de nuances autorisées des composantes rouge, verte et bleue de la couleur. Par défaut 0 (correspondance exacte).
step
	[optionnel] Au lieu de chercher chaque pixel, utilise une valeur supérieure à 1 pour passer certains pixels (pour la vitesse). Par exemple : Une valeur de 2 va seulement vérifier un pixel sur deux. 1 par défaut.
hwnd 
	[optionnel] handle de la fenêtre à utiliser.
@@End@@


###ReturnValue###
Succès:	Retourne un tableau à deux éléments, des coordonnées du pixel. (Array [0] = x, Array [1] = y).
Échec:	Met @error à 1 si la couleur n'est pas trouvée.


###Remarks###
La direction de la recherche varie selon ce qui suit :
     De gauche à droite si left < right
     De droite à gauche si right < left
     De haut en bas si top < bottom
     De bas en haut si bottom < top
Changer la direction de recherche peut être une optimisation utile si la couleur recherchée apparaît fréquemment dans une zone spécifique de la zone de recherche. La recherche sera réduite, si elle débute dans la zone la plus courante.

N'oubliez pas qu'un affichage en 1024 x 768 contient 786 432 pixels. Bien que PixelSearch soit optimisé, la réduction de la zone de recherche permet d'accélérer le résultat.


###Related###
<a href="PixelChecksum.htm">PixelChecksum</a>, <a href="PixelGetColor.htm">PixelGetColor</a>, <a href="PixelCoordMode.htm">PixelCoordMode (Option)</a>


###Example###
@@IncludeExample@@

Traducteur : Strofe

Contributeurs (pour les modifications avant le Wiki) : Tlem