code.ivysaur.me
/
imagequant
1
0
Fork 0
Code Issues Pull Requests Releases 2 Wiki Activity
Go bindings for libimagequant https://code.ivysaur.me/imagequant/
36 Commits 1 Branch 4 Tags 430 KiB
C 90.3%
Go 9.7%
Go to file
mappu 4b569d0798 doc: track documentation image 2020-05-06 18:24:08 +12:00
cmd/gopngquant build: remove non-portable Cygwin makefile 2018-12-31 16:32:25 +13:00
doc doc: track documentation image 2020-05-06 18:24:08 +12:00
.gitignore hg2git: convert ignores/tags files 2018-12-31 16:33:17 +13:00
Attributes.go add ISC license headers 2016-11-24 21:28:55 +13:00
COPYRIGHT libimagequant (2.8-git-a425e83) GPLv3+ 2016-11-20 13:38:15 +13:00
Histogram.go add ISC license headers 2016-11-24 21:28:55 +13:00
Image.go add ISC license headers 2016-11-24 21:28:55 +13:00
README.md doc: remove meta tags from readme 2018-12-31 17:55:15 +13:00
Result.go add ISC license headers 2016-11-24 21:28:55 +13:00
blur.c libimagequant (2.8-git-a425e83) GPLv3+ 2016-11-20 13:38:15 +13:00
blur.h libimagequant (2.8-git-a425e83) GPLv3+ 2016-11-20 13:38:15 +13:00
cflags_linux.go cflags: remove performance flags, to fix build with new Go whitelist 2018-12-31 16:32:07 +13:00
cflags_windows.go split up cgo CFLAGS into files with separate build tags 2017-03-03 18:16:40 +13:00
go.mod build: convert to Go Modules 2018-12-31 16:32:17 +13:00
imagequant.go split up cgo CFLAGS into files with separate build tags 2017-03-03 18:16:40 +13:00
kmeans.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
kmeans.h update bundled libimagequant from 2.8.0 to 2.9.0 2017-03-03 18:24:02 +13:00
libimagequant.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
libimagequant.h update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
mediancut.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
mediancut.h libimagequant (2.8-git-a425e83) GPLv3+ 2016-11-20 13:38:15 +13:00
mempool.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
mempool.h update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
nearest.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
nearest.h update bundled libimagequant from 2.8.0 to 2.9.0 2017-03-03 18:24:02 +13:00
pam.c update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00
pam.h update bundled pngquant to v2.12.2 2018-12-31 16:35:00 +13:00

README.md

imagequant

Go bindings for libimagequant

libimagequant is a library for lossy recompression of PNG images to reduce their filesize. It is used by the pngquant tool. This go-imagequant project is a set of bindings for libimagequant to enable its use from the Go programming language.

This binding was written by hand. The result is somewhat more idiomatic than an automated conversion, but some defer foo.Release() calls are required for memory management.

Usage

Usage example is provided by a sample utility cmd/gopngquant which mimics some functionality of the upstream pngquant.

The sample utility has the following options:

Usage of gopngquant:
  -In string
        Input filename
  -Out string
        Output filename
  -Speed int
        Speed (1 slowest, 10 fastest) (default 3)
  -Version

Building

This package can be installed via go get: go get code.ivysaur.me/imagequant

The expected package path is code.ivysaur.me/imagequant. Build via go build.

This is a CGO package and requires a C compiler installed. However, if you use go install then future invocations of go build do not require the C compiler to be present.

The imagequant.go file also declares a number of CFLAGS for GCC that allow the included libimagequant (2.8 git-a425e83) to build in an optimal way without using the upstream configure/make scripts.

License

I am releasing this binding under the ISC license, however, libimagequant itself is released under GPLv3-or-later and/or commercial licenses. You must comply with the terms of such a license when using this binding in a Go project.

Changelog

2018-12-31 v2.12.2-go1.2

  • go-imagequant: Update bundled libimagequant from 2.9.0 to 2.12.2
  • build: Switch to Go Modules
  • build: Update bundled CFLAGS for new CGo whitelist (reduces performance)
  • build: Remove nonportable Cygwin makefile

2017-03-03 v2.9.0-go1.1

  • Previously tagged as 2.9go1.1
  • go-imagequant: Update bundled libimagequant from 2.8.0 to 2.9.0
  • go-imagequant: Separate CGO_LDFLAGS for Linux and Windows targets
  • gopngquant: Fix an issue with non-square images

2016-11-24 v2.8.0-go1.0

  • Previously tagged as 2.8go1.0
  • Initial public release

See also