Categorygithub.com/aaronland/go-image
modulepackage
1.3.1
Repository: https://github.com/aaronland/go-image.git
Documentation: pkg.go.dev
Overview
Versions
1
Dependencies
0
Dependents
0
Files
0

# README

go-image

There are many "wrapper" packages for working with images in Go. This one is mine.

Important

These are image tools that I wrote by and for myself tailored to the needs of personal projects. It's possible they are not the image tools you need or want.

Documentation

Go Reference

Tools

resize

$> ./bin/resize -h
  -max int
    	The maximum dimension of the resized image
  -profile string
    	An optional colour profile to apply to the resized image. Valid options are: adobergb, displayp3.
  -source-uri string
    	A valid gocloud.dev/blob URI where images are read from. (default "file:///")
  -target-uri string
    	A valid gocloud.dev/blob URI where images are written to. (default "file:///")
  -transformation-uri transform.Transformation
    	Zero or more additional transform.Transformation URIs used to further modify an image after resizing (and before any additional colour profile transformations are performed).

transform

$> ./bin/transform -h
  -apply-suffix string
    	An optional suffix to apply to the final image filename.
  -format string
    	An optional image format used to encode the final image.
  -source-uri string
    	A valid gocloud.dev/blob.Bucket URI where images are read from. (default "file:///")
  -target-uri string
    	A valid gocloud.dev/blob.Bucket URI where images are written to. (default "file:///")
  -transformation-uri transform.Transformation
    	One or more additional transform.Transformation URIs used to further modify an image after resizing (and before any additional colour profile transformations are performed).

For example:

$> go run cmd/transform/main.go \
	-transformation-uri 'resize://?max=1280' \
	-transformation-uri displayp3:// \
	-apply-suffix -1280 \
	-format png \
	/usr/local/big-fish/big-fish-014.jpg

Create a new PNG image with the Apple DisplayP3 colour profile and a maximum dimension of 1280 pixels at /usr/local/big-fish/big-fish-014-1280.png.

See also

# Packages

Package app for running a base image applications that can be imported alongside custom `transform.Transformation` and `gocloud.dev/blob` packages.
Package background provides methods for manipulating an image's background.
No description provided by the author
Package colour provides methods for working with colour profiles.
Package common automatically imports commonly used packages.
Package decode provides methods for decoding images.
Package encode provides methods for encoding images.
Package exif provides methods for manipulating EXIF data in images.
Package imaging provides just the necessary bits of github.com/disintegration/imaging to do image rotation.
Package pixels provides methods for altering images at a per-pixel level.
Package resize provides methods for resizing images.
Package rotate provides methods for rotating images.
Package transform provides interfaces for applying transformations to images.