doc: top-level README.md
This commit is contained in:
parent
5d2ee53ed0
commit
94eb53400a
@ -1,3 +1,5 @@
|
|||||||
|
# imagequant
|
||||||
|
|
||||||
Go bindings for libimagequant
|
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.
|
`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.
|
||||||
@ -6,22 +8,24 @@ This binding was written by hand. The result is somewhat more idiomatic than an
|
|||||||
|
|
||||||
Written in Golang
|
Written in Golang
|
||||||
|
|
||||||
=USAGE=
|
## Usage
|
||||||
|
|
||||||
Usage example is provided by a sample utility `cmd/gopngquant` which mimics some functionality of the upstream `pngquant`.
|
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:
|
The sample utility has the following options:
|
||||||
|
|
||||||
`Usage of gopngquant:
|
```
|
||||||
|
Usage of gopngquant:
|
||||||
-In string
|
-In string
|
||||||
Input filename
|
Input filename
|
||||||
-Out string
|
-Out string
|
||||||
Output filename
|
Output filename
|
||||||
-Speed int
|
-Speed int
|
||||||
Speed (1 slowest, 10 fastest) (default 3)
|
Speed (1 slowest, 10 fastest) (default 3)
|
||||||
-Version`
|
-Version
|
||||||
|
```
|
||||||
|
|
||||||
=BUILDING=
|
## Building
|
||||||
|
|
||||||
This package can be installed via go get: `go get code.ivysaur.me/imagequant`
|
This package can be installed via go get: `go get code.ivysaur.me/imagequant`
|
||||||
[go-get]code.ivysaur.me/imagequant git https://git.ivysaur.me/code.ivysaur.me/imagequant.git[/go-get]
|
[go-get]code.ivysaur.me/imagequant git https://git.ivysaur.me/code.ivysaur.me/imagequant.git[/go-get]
|
||||||
@ -32,11 +36,11 @@ This is a CGO package and requires a C compiler installed. However, if you use `
|
|||||||
|
|
||||||
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.
|
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=
|
## 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.
|
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=
|
## Changelog
|
||||||
|
|
||||||
2017-03-03 2.9go1.1
|
2017-03-03 2.9go1.1
|
||||||
- go-imagequant: Update bundled libimagequant from 2.8.0 to 2.9.0
|
- go-imagequant: Update bundled libimagequant from 2.8.0 to 2.9.0
|
||||||
@ -46,7 +50,7 @@ I am releasing this binding under the ISC license, however, `libimagequant` itse
|
|||||||
2016-11-24 2.8go1.0
|
2016-11-24 2.8go1.0
|
||||||
- Initial public release
|
- Initial public release
|
||||||
|
|
||||||
=SEE ALSO=
|
## See also
|
||||||
|
|
||||||
- Pngquant homepage https://pngquant.org/
|
- Pngquant homepage https://pngquant.org/
|
||||||
- Pngquant source code https://github.com/pornel/pngquant
|
- Pngquant source code https://github.com/pornel/pngquant
|
Loading…
Reference in New Issue
Block a user