Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tidbyt/go-libwebp
An implemantaion of Go bindings for libwebp.
https://github.com/tidbyt/go-libwebp
Last synced: about 2 months ago
JSON representation
An implemantaion of Go bindings for libwebp.
- Host: GitHub
- URL: https://github.com/tidbyt/go-libwebp
- Owner: tidbyt
- License: bsd-2-clause
- Created: 2020-01-13T17:14:05.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-09-22T07:51:50.000Z (over 1 year ago)
- Last Synced: 2024-06-19T18:10:33.373Z (7 months ago)
- Language: Go
- Homepage:
- Size: 3.58 MB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
go-libwebp
==========
[](https://godoc.org/github.com/tidbyt/go-libwebp/webp)
A implementation of Go binding for [libwebp](https://developers.google.com/speed/webp/docs/api).
Originally forked from [harukasan/go-libwebp](https://github.com/harukasan/go-libwebp).
## Dependencies
- libwebp 0.5+, compiled with `--enable-libwebpmux`
## Usage
The [examples](./examples) directory contains example codes and images.
### Decoding WebP into image.RGBA
```
package main
import (
"github.com/tidbyt/go-libwebp/test/util"
"github.com/tidbyt/go-libwebp/webp"
)
func main() {
var err error
// Read binary data
data := util.ReadFile("cosmos.webp")
// Decode
options := &webp.DecoderOptions{}
img, err := webp.DecodeRGBA(data, options)
if err != nil {
panic(err)
}
util.WritePNG(img, "encoded_cosmos.png")
}
```
You can set more decoding options such as cropping, flipping and scaling.
### Encoding WebP from image.RGBA
```
package main
import (
"bufio"
"image"
"github.com/tidbyt/go-libwebp/test/util"
"github.com/tidbyt/go-libwebp/webp"
)
func main() {
img := util.ReadPNG("cosmos.png")
// Create file and buffered writer
io := util.CreateFile("encoded_cosmos.webp")
w := bufio.NewWriter(io)
defer func() {
w.Flush()
io.Close()
}()
config := webp.ConfigPreset(webp.PresetDefault, 90)
// Encode into WebP
if err := webp.EncodeRGBA(w, img.(*image.RGBA), config); err != nil {
panic(err)
}
}
```
### Encoding animations from a series of frames
```
package main
import (
"image"
"time"
"github.com/tidbyt/go-libwebp/test/util"
"github.com/tidbyt/go-libwebp/webp"
)
func main() {
// Get some frames
img := []image.Image{
util.ReadPNG("butterfly.png"),
util.ReadPNG("checkerboard.png"),
util.ReadPNG("yellow-rose-3.png"),
}
// Initialize the animation encoder
width, height := 24, 24
anim, err := webp.NewAnimationEncoder(width, height, 0, 0)
if err != nil {
panic(err)
}
defer anim.Close()
// Add each frame to the animation
for i, im := range img {
// all frames of an animation must have the same dimensions
cropped := im.(interface {
SubImage(r image.Rectangle) image.Image
}).SubImage(image.Rect(0, 0, width, height))
if err := anim.AddFrame(cropped, 100*time.Millisecond); err != nil {
panic(err)
}
}
// Assemble the final animation
buf, err := anim.Assemble()
if err != nil {
panic(err)
}
// Write to disk
f := util.CreateFile("animation.webp")
defer f.Close()
f.Write(buf)
}
```
## TODO
- Incremental decoding API
## License
Copyright (c) 2016 MICHII Shunsuke. All rights reserved.
This library is released under The BSD 2-Clause License.
See [LICENSE](./LICENSE).