PixelSearch and ImageSearch
Use ImagePutBuffer to create a pixel buffer. See details here.
pic := ImagePutBuffer(0) ; Screen Capture
pic := ImagePutBuffer("A") ; Window Capture (Method #1)
pic := ImagePutBuffer("cats.jpg") ; Open a file
pic := ImagePutBuffer([200, 200, 30, 50]) ; Screenshot [x, y, w, h]
pic := ImagePutBuffer({screenshot: "A"}) ; Screenshot window (Method #2)
pic := ImagePutBuffer({window: "A", crop: [0, 0, 50, 50]}) ; Window + Crop Area
For all 20+ input types, see here.
- Auto deletes as it loses scope. To delete a buffer manually, such as when stored inside an object, use
pic := ""
- Get pixel:
color := pic[x, y]Returns the ARGB value of the pixel. - Set pixel:
pic[x, y] := 0x00FF00(RGB values are assumed to have an alpha of 255)
- width, height - Get the width and height of the image.
- ptr - The pointer to the byte array holding the image.
- size - The size of the byte array.
- pBitmap - A GDI+ Bitmap reference to the byte array.
- crop(x, y, w, h) - Copies the cropped image into a new buffer.
- clone() - Copies the image into a new buffer.
- save(filepath?, quality?) - Defaults to writing a 32-bit ARGB uncompressed .bmp file. Other extensions use ImagePutFile.
- show(window_border?, title?, pos?, style?, styleEx?, parent?) - Use
show(0)orshow(1)for window borders. See ImageShow for details on other parameters.
- PixelSearch(color, variation?)
- ImageSearch(image)
- ColorKey(color?, replacement?) - Replaces one ARGB color with another ARGB color. Default color is the top-left pixel.
- SetAlpha(alpha) - Sets the alpha channel of the entire image. Range: 0-255.
- TransColor(color?, alpha?) - Sets the alpha channel of a single RGB color. For example, if two RGB colors have different alpha values, they can be set the same. Default color is the top-left pixel.
Get a color at [x, y]. Returns an ARGB value.
Note: For comparisons use ARGB like
0xFFD2B318✅ because it starts with 0xFF, not RGB like0xD2B318❌
Get color:
screen_capture := ImagePutBuffer(1) ; Capture Primary Screen
color := screen_capture[100, 200]
MsgBox % color
Check color:
; Gets the pixel at [100, 100].
color := pic[100, 100]
; Check if the pixel is red.
if (color = 0xFFFF0000)
MsgBox
Set a color at [x, y].
Note: RGB values are assumed to have an alpha of 255.
; Sets the pixel at [100, 100] to red.
pic[100, 100] := 0xFF0000
Set multiple pixels by chaining the assignment operator.
; Example: Shows a small red square inside the image.
pic := ImagePutBuffer("https://picsum.photos/100")
pic[0, 0] := pic[0, 1] := pic[0, 2] := 0xFF0000
pic[1, 0] := pic[1, 1] := pic[1, 2] := 0xFF0000
pic[2, 0] := pic[2, 1] := pic[2, 2] := 0xFF0000
pic.show() ; or ImageShow(pic)
Gets [x, y] position of a color.
pic := ImagePutBuffer("https://picsum.photos/300") ; Load image
pic.show() ; or ImageShow(pic) ; Show image
if xy := pic.PixelSearch(0xFFFFFF) ; Get [x, y] of 0xFFFFFF
MouseMove xy[1], xy[2] ; Move cursor
else Reload ; Restart
Specify a number between 0 and 255 (inclusive) to indicate the allowed number of shades of variation in either direction for the intensity of the red, green, and blue components of each pixel's color.
pic := ImagePutBuffer("https://picsum.photos/300") ; Load image
if xy := pic.PixelSearch(0xFFFFFF, 3) { ; Get [x, y] of 0xFFFFFF with variation of 3
MsgBox % "The color found is " pic[xy*] ; Display hex value
pic.show() ; or ImageShow(pic) ; Show image
MouseMove xy[1], xy[2] ; Move cursor
} else Reload ; Restart
Note: The syntax
pic[xy*]is shorthand forpic[xy[1], xy[2]]by using the unpacking operator*to unpack arrays.
Search for colors using the red, green, blue color channel where each color channel has its own variation.
; Red (0x11 ± 3) Green (0x22 ± 15), Blue (0x33 ± 100)
xy := pic.PixelSearch(0x112233, [3, 15, 100])
Search for colors (inclusive) between the red high and low, green high and low, and blue high and low. The color parameter is ignored. Since this specifies a range, it does not matter if it is increasing or decreasing.
; Red (245, 255) Green (137, 155), Blue (142, 99)
xy := pic.PixelSearch(0, [245, 255, 137, 155, 142, 99])
Finds the [x, y] coordinates of all matching pixels. To count the number of matching pixels, check the length of the returned array. Returns a nested array [[x, y], [x2, y2], [x3, y3]...]
pic := ImagePutBuffer("https://picsum.photos/300") ; Load image
pic.show() ; or ImageShow(pic) ; Show image
if xys := pic.PixelSearchAll(0xFFFFFF) { ; Array of [x, y] arrays
if xy := xys[1] ; Get first [x, y]
MouseMove xy[1], xy[2] ; Move cursor
} else Reload ; Restart
; MsgBox % count := xys.length() ; AutoHotkey v1
; MsgBox count := xys.length ; AutoHotkey v2
Search for a matching image. Returns top-left [x, y] of the first match.
pic := ImagePutBuffer(0) ; Screen capture
pic.show() ; or ImageShow(pic) ; Show image
if xy := pic.ImageSearch("test_image.png") ; Search image
MouseMove xy[1], xy[2] ; Move cursor
Cache the search image for faster speed.
pic := ImagePutBuffer(0) ; Screen capture
search := ImagePutBuffer("test_image.png") ; Convert File -> Buffer
pic.show() ; or ImageShow(pic) ; Show image
if xy := pic.ImageSearch(search) ; Search image
MouseMove xy[1], xy[2] ; Move cursor
If the search image contains transparent pixels, they will be ignored and only fully opaque pixels in the search image will be checked.
; Add the Transcolor line to the above example.
search := ImagePutBuffer("test_image.png") ; Convert File -> Buffer
search.TransColor(0xFFFFFF) ; Sets all white pixels to be transparent
Returns an array of all matches in the form of [[x, y], [x2, y2], [x3, y3]...]. To get the number of matches, use the .length property of the returned array.
pic := ImagePutBuffer(0) ; Screen capture
search := ImagePutBuffer("test_image.png") ; Convert File -> Buffer
xys := pic.ImageSearchAll(search) ; Array of [x, y] arrays
if (xys) {
count := xys.length ; Number of matches
xy := xys[1] ; First match
; xy2 := xys[2] ; Second match
; xylast := xys[-1] ; Last match
if (xy) ; Check first [x, y]
MouseMove xy[1], xy[2] ; Move cursor
}