id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
712	enhanced PixelSearch - search direction & logical mask	haura		"A) Search direction: 
For symmetry, support should be included for:
  1. left-to-right, top-to-bottom (default & only current option)
  2. right-to-left, top-to-bottom
  3. left-to-right, bottom-to-top
  4. right-to-left, bottom-to-top

Various software (not just games) use gauges on screen and the ability to efficiently find the top/bottom/left/right extremes of a monochrome area would have high utility.

B) Search using a logical-AND ""pixel mask"": 
Accept X and Y dimensions of a pixel mask. Here, a ""pixel mask"" is an array of pixels in which _all_ pixels must match the target color for the search to terminate. Shade-variation parameter applies. 
Of course this pixel mask must be smaller in X and Y dimensions than the rectangle of pixels being searched.

Sometimes onscreen gauges have gradations or text superimposed and so erroneous matches are possible and these situations can require complex (and slow) functions to be written to avoid false positive search results. Requiring _all_ pixels within a search rectangle to match the target color will provide an efficient program building block for such applications.

C) Search using a logical-OR ""pixel mask"": 
Corollary to (B) only using a logical-OR ""pixel mask"" and the condition for terminating the search changes to being when _none_ of the pixels in ""pixel mask"" match the target color. Shade-variation parameter applies. 

Note that this yields a _different_ result than the result from a ""single pixel at a time"" style search. 

This is useful for those gauges that taper off or have rounded extremities however, it may _also_ be used to effectively ignore any text or gradations superimposed on a monochrome gauge. 

"	Feature Request	closed		AutoIt		None	Rejected	PixelSearch