A binding library of stb_image for Go.

import (
	"github.com/nitrix/stbi-go"
)

func example() error {
	img, err := stbi.Load("example.jpg")
	if err != nil {
		return err
	}

	// Do what you want with `img` here.
	// It's an `*image.NRGBA` (non-premultiplied alpha) with the pixel data in `.Pix` as usual.

	return nil
}

Every loader has a Raw variant that skips copying the pixels into Go memory. The returned slice is backed by C memory, so it must be released with stbi.Free and not used afterwards. This is useful when the pixels are handed off right away, for example uploaded to the GPU.

pix, width, height, err := stbi.LoadRaw("example.jpg")
if err != nil {
	return err
}
defer stbi.Free(pix)

Pixels are always decoded to 4 channels (RGBA).

See this repo for the original C library.

This is free and unencumbered software released into the public domain. See the UNLICENSE file for more details.