Skip to content

HugoSmits86/nativewebp

Repository files navigation

Codecov Coverage Go Reference License: MIT

Native WebP for Go

This is a native WebP encoder written entirely in Go, with no dependencies on libwebp or other external libraries. Designed for performance and efficiency, this encoder generates smaller files than the standard Go PNG encoder and is approximately 50% faster in execution.

Currently, the encoder supports only WebP lossless images (VP8L).

Decoding Support

We provide WebP decoding through a wrapper around golang.org/x/image/webp, with an additional DecodeIgnoreAlphaFlag function to handle VP8X images where the alpha flag causes decoding issues.

Benchmark

We conducted a quick benchmark to showcase file size reduction and encoding performance. Using an image from Google’s WebP Lossless and Alpha Gallery, we compared the results of our nativewebp encoder with the standard PNG encoder.

For the PNG encoder, we used png.BestCompression. Likewise, nativewebp was configured with nativewebp.BestCompression so both encoders were benchmarked using their maximum compression settings.

PNG encoder nativeWebP encoder reduction

file size 120 kb 95 kb 21% smaller
encoding time 42945049 ns/op 35413726 ns/op 17% faster

file size 46 kb 35 kb 24% smaller
encoding time 98509399 ns/op 42626779 ns/op 57% faster

file size 236 kb 190 kb 19% smaller
encoding time 178205535 ns/op 96800750 ns/op 46% faster

file size 53 kb 39 kb 26% smaller
encoding time 29088555 ns/op 19877708 ns/op 32% faster

file size 139 kb 119 kb 14% smaller
encoding time 63423995 ns/op 27813126 ns/op 56% faster

image source: https://developers.google.com/speed/webp/gallery2

Installation

To install the nativewebp package, use the following command:

go get github.com/HugoSmits86/nativewebp

Usage

Here’s a simple example of how to encode an image:

file, err := os.Create(name)
if err != nil {
  log.Fatalf("Error creating file %s: %v", name, err)
}
defer file.Close()

err = nativewebp.Encode(file, img, nil)
if err != nil {
  log.Fatalf("Error encoding image to WebP: %v", err)
}

Here’s a simple example of how to encode an animation:

file, err := os.Create(name)
if err != nil {
  log.Fatalf("Error creating file %s: %v", name, err)
}
defer file.Close()

ani := nativewebp.Animation{
  Images: []image.Image{
    frame1,
    frame2,
  },
  Durations: []uint {
    100,
    100,
  },
  Disposals: []uint {
    0,
    0,
  },
  LoopCount: 0,
  BackgroundColor: 0xffffffff,
}

err = nativewebp.EncodeAll(file, &ani, nil)
if err != nil {
  log.Fatalf("Error encoding WebP animation: %v", err)
}

About

Native webp encoder for Go

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages