部署模型>> ImagePut>> 返回
项目作者： iseahound

项目描述 ：
Library for moving image data on Windows. Manage raw pointers to image data, streams, GUI windows, base64, URLs, cursors, screen coordinates, etc. Supports AutoHotkey v1 and v2.
高级语言： AutoHotkey
项目地址: git://github.com/iseahound/ImagePut.git
创建时间： 2020-05-22T19:29:56Z
项目社区：https://github.com/iseahound/ImagePut
开源协议：MIT License
下载


ImagePut

A core library for images in AutoHotkey

image

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.

Note: If you don’t want a large library you can copy paste the relevant functions

So you want to convert an image?

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

  1. str := ImagePutBase64("cats.jpg")

or this

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

or something like this:

  1. 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. 

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

Convert file formats and image types at the same time!

  1. ; Saves a JPEG as a base64 encoded GIF. 
  2. 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!

  1. ; Declare input type as file.
  2. ImagePutWindow({file: "cats.jpg"})
  4. ; Scale 2x and crop 10% from each edge.
  5. ImagePutWindow({file: "cats.jpg", scale: 2, crop:["-10%", "-10%", "-10%", "-10%"]})
  7. ; Unknown image type declared as "image" to be cropped to 200x200 pixels. 
  8. ImagePutWindow({image: "cats.jpg", crop: [0, 0, 200, 200]})
  10. ; Compare a url to a file.
  11. MsgBox % ImageEqual("https://example.com/cats.jpg", "cats.jpg")
  13. ; Validate an image as an actual image.
  14. ImageEqual("cats.jpg")

Features

  • Simple and effective
  • Decipher over 20+ image types
  • Supports newer formats avif, heic, and webp
  • View and debug any image variable 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

Documentation

Engineering

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.

Extra appreciation: https://ko-fi.com/iseahound