简单、高效、实用的图片操作库 —— ImagePut 轻松实现截图、转换、缩放、裁剪等各种功能

本教程内容基于 iseahound 于 2022-11-06 发布的 ImagePut 1.9 版写作。

ImagePut 是 iseahound 写的一个图片操作库，大部分常见图片操作都可以用极为简单的方式实现。

如何使用？

下载 https://github.com/iseahound/ImagePut 里面的 ImagePut (for v1).ahk 重命名为 ImagePut.ahk 。

在你的代码中像这样引用它。

#Include ImagePut.ahk  ; 引用库

能做什么？

ImagePutFile(Image)       ; 将图片存为文件
ImagePutClipboard(Image)  ; 将图片存入剪贴板
ImagePutWindow(Image)     ; 将图片显示出来
ImageShow(Image)          ; 将图片显示出来（无标题栏）
ImagePutBase64(Image)     ; 将图片转换为 base64 编码后的字符串
ImagePutURI(Image)        ; 将图片转换为 base64 编码后的字符串（带 URI 头）
ImagePutHex(Image)        ; 将图片转换为 16进制 编码后的字符串
ImagePutWallpaper(Image)  ; 将图片设为桌面壁纸
ImagePutDesktop(Image)    ; 将图片放在桌面壁纸前、桌面图标后的位置
ImagePutCursor(Image)     ; 将图片设为鼠标样式
ImageEqual(Images*)       ; 比较多张图片是否相同
ImageWidth(Image)         ; 返回图片宽度
ImageHeight(Image)        ; 返回图片高度

参数 Image 非常神奇，可以是屏幕坐标、本地图片、 PDF 文档、 URL 、 base64 字符串、 16进制 字符串等各种形式的图片。

以下使用 ImagePutWindow() 进行演示，方便直接观察结果。

简单示例

显示本地图片

ImagePutWindow("1.png")  ; 显示本地图片

显示网上图片（这里用的是百度的 logo ）

ImagePutWindow("https://www.baidu.com/img/flexible/logo/pc/result.png")  ; 显示网上图片（这里用的是百度的 logo ）

显示 pdf 文档

ImagePutWindow("1.pdf")  ; 显示 pdf 文档

显示 pdf 文档第2页

ImagePutWindow({image:"1.pdf", index:2})  ; 显示 pdf 文档第2页

显示 pdf 文档最后1页

ImagePutWindow({image:"1.pdf", index:-1})  ; 显示 pdf 文档最后1页

根据坐标截图并显示

ImagePutWindow([0, 0, 100, 100])  ; 根据坐标 [X, Y, W, H] 截图并显示

根据窗口截图并显示（这里用的是记事本窗口）

ImagePutWindow("ahk_exe notepad.exe")  ; 根据窗口截图并显示（这里用的是记事本窗口）

显示剪贴板内图片

ImagePutWindow(ClipboardAll)  ; 显示剪贴板内图片

显示当前鼠标指针

ImagePutWindow(A_Cursor)  ; 显示当前鼠标指针

显示当前壁纸

ImagePutWindow("wallpaper")  ; 显示当前壁纸

显示所有显示器内容

ImagePutWindow(0)  ; 显示所有显示器内容

显示第1台显示器内容

ImagePutWindow(1)  ; 显示第1台显示器内容

显示第2台显示器内容

ImagePutWindow(2)  ; 显示第2台显示器内容

显示 base64 编码后的图片（这里是一个鼠标指针图案）

ImagePutWindow("iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAADxSURBVFhH7ZK9CsIwFIVv0bVarZNv4eRT+Iq+hB3r0k1wEUFdi0OLU8GCioPek0S0/i5NApIPCslt4Hw9KRH5GTW7Q17YggW81tSihJ9dGIsSUgBYkrgLAAsSVQFgWOJVABiUeC8ADEl8FjieziYkPguAotjrlvguAPJ8p1PitwBI062UqJ+qQFke1Er9hM9P/dwFEM77chLFYs+BMTXCkTqoCylwC5f33FpiJmrntTqoCz+rhjNeECXJDA7cQhDpbUHc60M4kC2sIbBabdDCQr0xCH85wkUL1J6rqUnCPlogrzMm6g3U0OFwOByOf4PoCtGPXlXT5OFnAAAAAElFTkSuQmCC")  ; 显示 base64 编码后的图片（这里是一个鼠标指针图案）

显示 16进制 编码后的图片（这里是一个鼠标指针图案）

ImagePutWindow("89504e470d0a1a0a0000000d4948445200000020000000200806000000737a7af4000000017352474200aece1ce90000000467414d410000b18f0bfc6105000000097048597300000ec300000ec301c76fa864000000f1494441545847ed92bd0ac23014856fd1b55aad936fe1e453f88abe841debd24d7011415d8b438b53c1828a83de9344b4fe2e4d02920f0ac96de07c3d2911f91935bb435ed88205bcd6d4a2849f5d188b1252005892b80b000b1255016058e255001894782f000c497c16389ece26243e0b80a2d8eb96f82e00f27ca753e2b70048d3ad94a89faa40591ed44afd84cf4ffddc0510cefb7212c562cf813135c2913aa80b29700b97f7dc5a62266ae7b53aa80b3fab86335e1025c90c0edc4210e96d41dceb4338902dac21b05a6dd0c242bd31087f39c2450bd49eaba949c23e5a20af3326ea0dd4d0e170381c8e7f83e80ad18f5e55d3e4e1670000000049454e44ae426082")  ; 显示 16进制 编码后的图片（这里是一个鼠标指针图案）

比较3张图片是否相同

ImageEqual(A_Cursor, "cats.jpg", [0,0,100,100])  ; 比较3张图片是否相同

获取图片宽高

MsgBox % ImageWidth("1.png")   ; 获取图片宽度
MsgBox % ImageHeight("1.png")  ; 获取图片高度

举一反三

要把 jpg 转为 gif 怎么办呢？

ImagePutFile("x:\1.jpg", "2.gif")

要把 pdf 转为 jpg 怎么办呢？（这里只转换了第1页）

ImagePutFile("x:\1.pdf", "2.jpg")

要把截图存到剪贴板怎么办呢？

ImagePutClipboard([0, 0, 100, 100])

要把百度logo设为壁纸怎么办呢？

ImagePutWallpaper("https://www.baidu.com/img/flexible/logo/pc/result.png")

要把当前鼠标样式存为字符怎么办呢？

当前鼠标样式 := ImagePutBase64(A_Cursor)

缩放与裁剪

缩放

ImagePutWindow({image: "x:\1.jpg", scale: 1.25})           ; 放大到1.25倍。 scale 可以是小数
ImagePutWindow({image: "x:\1.jpg", scale: 0.5})            ; 缩小到0.5倍。 scale 可以是小数
ImagePutWindow({image: "x:\1.jpg", scale: [300, 600]})     ; 将图片缩放为 300x600 （注意：指定完整宽高的缩放将无视图片原始宽高比）
ImagePutWindow({image: "x:\1.jpg", scale: [300, ""]})      ; 将图片宽度缩放为300 高度按原始宽高比自动缩放
ImagePutWindow({image: "x:\1.jpg", scale: ["auto", 600]})  ; 将图片高度缩放为600 宽度按原始宽高比自动缩放

裁剪

ImagePutWindow({image: "x:\1.jpg", crop: [0, 0, -100, 200]})          ; 格式 [X, Y, W, H] 。这里表示：宽度减少100像素 高度保留200像素
ImagePutWindow({image: "x:\1.jpg", crop: [0, "10%", "50%", "-20%"]})  ; 百分比要加引号。这里表示：从顶端10%的位置开始裁剪 并且宽度保留50% 高度减少20%

高级功能

上面只是介绍了 imagePut 的基本使用，实际上它还有以下这些高级功能。

ImagePutBitmap              ; 存为 Bitmap （Gdip 常用）
ImagePutBuffer              ; 存为 Bitmap 并返回一个对象，可以从对象中读取图片宽高大小或每个像素的值，亦可修改每个像素的值
ImagePutDC                  ; 存入 DC
ImagePutExplorer            ; 将图片保存到最近打开的资源管理器路径中（例如打开了 c:\ 则存到此处，没有则存到桌面）
ImagePutFormData            ; 存为 FormData （POST 方式上传数据时常用）
ImagePutHBitmap             ; 存为 HBitmap （Gdip 常用）
ImagePutHIcon               ; 存为 HIcon （Gdip 常用）
ImagePutRandomAccessStream  ;
ImagePutSafeArray           ;
ImagePutScreenshot          ; 存入屏幕 DC
ImagePutStream              ;
ImagePutWICBitmap           ;
ImageDestroy                ; 销毁 Image

由于高级功能大部分读者是用不到的，因此这里仅作简单解释，详细说明与示例，请移步原始文档自行了解。