README
¶
Plates 
Package for dealing with RGB, HSV and HSL colors, mixing colors and for reading and writing images.
Plates comes with the cmd/puppyart utility.
Puppyart
Quick installation
go install github.com/xyproto/plates/cmd/puppyart@latest
Original image
The above image is by Andrea Schaffer and is licensed under cc-by-2.0.
Transformed image
Example code
The transformed image was generated with the following program:
package main
import (
"image"
"image/color"
"image/draw"
"log"
"github.com/xyproto/plates"
)
// convert takes an image file and modifies it based on a specified threshold and two given colors.
// It returns a processed image.
func convert(infilename string, thresh uint8, color1, color2 color.RGBA) image.Image {
// Combine the two colors to create a mixed color
mixcolor := plates.PaintMix(color1, color2)
// Load the input image
img, err := plates.Read(infilename)
if err != nil {
log.Fatalln(err)
}
// Separate the image into three based on the specified threshold and intensity: color1, mixcolor, and color2.
color1image, mixcolorimage, color2image := plates.Separate3(img, color1, mixcolor, color2, thresh)
// Combine the color1 image and mixcolor image to create a new image plate with color1
color1plate := plates.AddToAs(color1image, mixcolorimage, color1)
// Combine the color1plate and color2image to create an allplate image with color2 color
// And then combine the resulting image with the mixcolorimage to get the final output image.
allplate := plates.AddToAs(color1plate, color2image, color2)
allplate = plates.AddToAs(allplate, mixcolorimage, mixcolor)
return allplate
}
func main() {
// Define input colors and process the image using convert function.
// Repeat this process for different color combinations.
image1 := convert("puppy.png", 255, color.RGBA{0, 0, 255, 255}, color.RGBA{255, 255, 255, 255})
image2 := convert("puppy.png", 255, color.RGBA{16, 63, 255, 255}, color.RGBA{0, 0, 0, 255})
image3 := convert("puppy.png", 255, color.RGBA{255, 0, 0, 255}, color.RGBA{255, 255, 0, 255})
image4 := convert("puppy.png", 255, color.RGBA{16, 255, 255, 255}, color.RGBA{255, 0, 255, 255})
// Create a new image to contain the 4 processed images.
width := image1.Bounds().Dx() * 2
height := image2.Bounds().Dy() * 2
newimage := image.NewRGBA(image.Rect(0, 0, width, height))
// Arrange the 4 processed images on the new image.
draw.Draw(newimage, image1.Bounds(), image1, newimage.Bounds().Min, draw.Src)
draw.Draw(newimage, image.Rect(image1.Bounds().Dx(), 0, width, image1.Bounds().Dy()), image2, newimage.Bounds().Min, draw.Src)
draw.Draw(newimage, image.Rect(0, image1.Bounds().Dy(), image1.Bounds().Dx(), height), image3, newimage.Bounds().Min, draw.Src)
draw.Draw(newimage, image.Rect(image1.Bounds().Dx(), image1.Bounds().Dy(), width, height), image4, newimage.Bounds().Min, draw.Src)
// Write the final image to file.
if err := plates.Write("generated.png", newimage); err != nil {
log.Fatalln(err)
}
}
General information
- License: BSD-3
- Author: Alexander F. Rødseth <xyproto@archlinux.org>
- Version: 1.0.6
Documentation
¶
Overview ¶
Package plates provides utilities for manipulating colors and images.
Index ¶
- func AddToAs(orig image.Image, addimage image.Image, addcolor color.RGBA) image.Image
- func Blue(m image.Image) image.Image
- func CloseTo1(m image.Image, target color.RGBA, threshold uint8) image.Image
- func CloseTo2(m image.Image, target color.RGBA, threshold uint8) image.Image
- func Green(m image.Image) image.Image
- func HLS(r, g, b float64) (float64, float64, float64)
- func HLStoRGB(h, l, s float64) (float64, float64, float64)
- func HSV(cr color.RGBA) (uint8, uint8, uint8)
- func Hue(cr color.RGBA) float64
- func PaintMix(c1, c2 color.RGBA) color.RGBA
- func Read(filename string) (image.Image, error)
- func Red(m image.Image) image.Image
- func Separate3(inImage image.Image, color1, color2, color3 color.RGBA, threshold uint8) (image.Image, image.Image, image.Image)
- func Write(filename string, img image.Image) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AddToAs ¶
AddToAs will take an image, add the nontransparent colors from addimage, use addcolor and return an image.
func Blue ¶
Blue function isolates and returns the blue channel from an image. It returns a new image where only the blue component of each pixel's color is retained.
func CloseTo1 ¶
CloseTo1 function isolates pixels in an image that are similar to a target color within a given threshold. It returns a new image where only the pixels close to the target color are retained. Pixels that do not meet the threshold will be set to black (RGB{0,0,0}).
func CloseTo2 ¶
CloseTo2 will pick out only the colors close to the given color, within a given threshold. Make it uniform. Zero alpha to unused pixels in returned image.
func Green ¶
Green function isolates and returns the green channel from an image. It returns a new image where only the green component of each pixel's color is retained.
func PaintMix ¶
PaintMix will attempt to mix two RGB colors, a bit like how paint mixes (but not exactly like it)
func Read ¶
Read tries to read the given image filename and return an image.Image The supported extensions are: .png, .jpg, .jpeg, .gif, .ico, .bmp and .webp
func Red ¶
Red function isolates and returns the red channel from an image. It returns a new image where only the red component of each pixel's color is retained.
Types ¶
This section is empty.
Source Files
Directories