ImagePut

A core library for images in AutoHotkey

Imagine a scenario where you have a file but you're trying to get it uploaded into an API. Or you have a function that returns some strange image format, is there any way you can just get it to show its contents? If you pass anything, literally anything you believe is an image to ImagePutWindow() it will show up on screen. And then you can magically transform it to be compatible with that specific API.

Features

Simple and effective
Decipher over 20+ image types
Supports newer formats webp and heic
View and debug your image functions with ImagePutWindow(image)
Screen capture with fast PixelSearch and ImageSearch
Add animated GIFs to AutoHotkey GUIs
Upload images using website apis
Load images from blocks of memory

Beginner

Quick Start
Chinese Documentation (中文) - 这里有一个中文版的使用教程

Intermediate

Documentation

Tutorials

Misc

Enumerate Pixels Using For Loops (AutoHotkey v2 only)

Advanced

Engineering Challenges Q&A - Click here to read some interesting stuff.
Internal Documentation - Understanding how ImagePut works.

So you want to convert an image?

But you don't know how. That's okay because you can just do this:

str := ImagePutBase64("cats.jpg")

or this

ImagePutClipboard("https://example.com/cats.jpg")

or something like this:

pStream := ImagePutStream([0, 0, A_ScreenWidth, A_ScreenHeight])

Working with images should be this easy. ImagePut has automatic type inference, meaning that it will guess whether the input is (1) a file (2) a website url or (3) a series of coordinates that map to the screen. This functionality enables the user to only memorize a single function for any possible input. For a full list of supported input types, click on the documentation link here. For output types click here.

Convert file formats.

; Saves a JPEG as a GIF. 
ImagePutFile("cats.jpg", "gif")

Convert file formats and image types at the same time!

; Saves a JPEG as a base64 encoded GIF. 
str := ImagePutBase64("cats.jpg", "gif")

There's also some weird functions like ImagePutCursor which lets you set anything as your cursor. Make sure you don't choose an extremely large image!

Finally, there are several advanced features. The first is the ability to specify the input type directly. The second is cropping and scaling functionality. Third is use of ImageEqual() a function that can compare multiple inputs across different windows image data types!

; Declare input type as file.
ImagePutWindow({file: "cats.jpg"})

; Scale 2x and crop 10% from each edge.
ImagePutWindow({file: "cats.jpg", scale: 2, crop:["-10%", "-10%", "-10%", "-10%"]})

; Unknown image type declared as "image" to be cropped to 200x200 pixels. 
ImagePutWindow({image: "cats.jpg", crop: [0, 0, 200, 200]})

; Compare a url to a file.
MsgBox % ImageEqual("https://example.com/cats.jpg", "cats.jpg")

; Validate an image as an actual image.
ImageEqual("cats.jpg")

Design Philosophy

100% Compatibility with Gdip_All.ahk
ImagePut is designed to be the fastest
ImagePut should serve as a reference implementation
Specific conversions between formats like PNG file to hIcon are not considered
Users should be able to replace uses of ImagePut with individual functions
Therefore users should be copy and paste individual functions
If you need help extracting a function please ask!

Help and Support

Feel free to ask for any help, questions, or post suggestions, etc.

v1 forum: https://www.autohotkey.com/boards/viewtopic.php?t=76301
v2 forum: https://www.autohotkey.com/boards/viewtopic.php?t=76633

If for some reason you'd like to show extra appreciation: https://ko-fi.com/iseahound

Autumn-one/ImagePut