You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

github.com/mazznoer/colorgrad

Package Overview
Dependencies
2
Alerts
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies

Install

github.com/mazznoer/colorgrad


Version published

Readme

Source

colorgrad 🎨

Release PkgGoDev Build Status Build Status go report codecov

Go (Golang) color scales library for data visualization, charts, games, maps, generative art and others.

Support This Project

Donate

Index

import "github.com/mazznoer/colorgrad"

Custom Gradient

Basic

grad, err := colorgrad.NewGradient().Build()

img

Custom Colors

Colors() method accept anything that implement color.Color interface.

import "image/color"
import "github.com/lucasb-eyer/go-colorful"

grad, err := colorgrad.NewGradient().
    Colors(
        color.RGBA{0, 206, 209, 255},
        color.RGBA{255, 105, 180, 255},
        colorful.Color{R: 0.274, G: 0.5, B: 0.7},
        colorful.Hsv(50, 1, 1),
        colorful.Hsv(348, 0.9, 0.8),
    ).
    Build()

img

Using Web Color Format

HtmlColors() method accepts named colors, hexadecimal (#rgb, #rgba, #rrggbb, #rrggbbaa), rgb(), rgba(), hsl(), hsla(), hwb(), and hsv().

grad, err := colorgrad.NewGradient().
    HtmlColors("#C41189", "#00BFFF", "#FFD700").
    Build()

img

grad, err := colorgrad.NewGradient().
    HtmlColors("gold", "hotpink", "darkturquoise").
    Build()

img

grad, err := colorgrad.NewGradient().
    HtmlColors(
        "rgb(125,110,221)",
        "rgb(90%,45%,97%)",
        "hsl(229,79%,85%)",
    ).
    Build()

img

Domain & Color Position

Default domain is [0..1].

grad, err := colorgrad.NewGradient().
    HtmlColors("deeppink", "gold", "seagreen").
    Build()

img

Set the domain to [0..100].

grad, err := colorgrad.NewGradient().
    HtmlColors("deeppink", "gold", "seagreen").
    Domain(0, 100).
    Build()

img

Set the domain to [-1..1].

grad, err := colorgrad.NewGradient().
    HtmlColors("deeppink", "gold", "seagreen").
    Domain(-1, 1).
    Build()

img

Set exact position for each color. The domain is [0..1].

grad, err := colorgrad.NewGradient().
    HtmlColors("deeppink", "gold", "seagreen").
    Domain(0, 0.7, 1).
    Build()

img

Set exact position for each color. The domain is [15..80].

grad, err := colorgrad.NewGradient().
    HtmlColors("deeppink", "gold", "seagreen").
    Domain(15, 30, 80).
    Build()

img

Blending Mode

grad, err := colorgrad.NewGradient().
    HtmlColors("#FFF", "#00F").
    Mode(colorgrad.BlendRgb).
    Build()

blend-modes

Interpolation Mode

grad, err := colorgrad.NewGradient().
    HtmlColors("#C41189", "#00BFFF", "#FFD700").
    Interpolation(colorgrad.InterpolationLinear).
    Build()

InterpolationLinear interpolation-linear

InterpolationCatmullRom interpolation-catmull-rom

InterpolationBasis interpolation-basis

Preset Gradients

All preset gradients are in the domain [0..1].

Diverging

colorgrad.BrBG() img

colorgrad.PRGn() img

colorgrad.PiYG() img

colorgrad.PuOr() img

colorgrad.RdBu() img

colorgrad.RdGy() img

colorgrad.RdYlBu() img

colorgrad.RdYlGn() img

colorgrad.Spectral() img

Sequential (Single Hue)

colorgrad.Blues() img

colorgrad.Greens() img

colorgrad.Greys() img

colorgrad.Oranges() img

colorgrad.Purples() img

colorgrad.Reds() img

Sequential (Multi-Hue)

colorgrad.Turbo() img

colorgrad.Viridis() img

colorgrad.Inferno() img

colorgrad.Magma() img

colorgrad.Plasma() img

colorgrad.Cividis() img

colorgrad.Warm() img

colorgrad.Cool() img

colorgrad.CubehelixDefault() img

colorgrad.BuGn() img

colorgrad.BuPu() img

colorgrad.GnBu() img

colorgrad.OrRd() img

colorgrad.PuBuGn() img

colorgrad.PuBu() img

colorgrad.PuRd() img

colorgrad.RdPu() img

colorgrad.YlGnBu() img

colorgrad.YlGn() img

colorgrad.YlOrBr() img

colorgrad.YlOrRd() img

Cyclical

colorgrad.Rainbow() img

colorgrad.Sinebow() img

Parsing GIMP Gradient

import "os"
import "github.com/lucasb-eyer/go-colorful"

foreground := colorful.Color{R: 0, G: 0, B: 0}
background := colorful.Color{R: 1, G: 1, B: 1}
file, err := os.Open("Abstract_1.ggr")

if err != nil {
	panic(err)
}

defer file.Close()
grad, name, err2 := colorgrad.ParseGgr(file, foreground, background)
fmt.Println(name) // Abstract 1

gimp-gradient

Using the Gradient

Get the domain

grad := colorgrad.Rainbow()

fmt.Println(grad.Domain()) // 0 1

Get single color at certain position

grad := colorgrad.Rainbow()

fmt.Println(grad.At(0.0).Hex()) // #6e40aa
fmt.Println(grad.At(0.5).Hex()) // #aff05b
fmt.Println(grad.At(1.0).Hex()) // #6e40aa

Get n colors evenly spaced across gradient

.Colors() will return []color.Color.

grad := colorgrad.Rainbow()

for _, c := range grad.Colors(7) {
    fmt.Println(c)
}

Output:

{0.43021004989867906 0.25023866753368473 0.6663314402976028}
{0.9324699655386229 0.2641323667713124 0.5856493589115485}
{1 0.5479694546462268 0.220207078599215}
{0.68717707266999 0.9403236324800919 0.355050281779196}
{0.36562500000000014 0.9182994327976323 0.5525738542381139}
{0.25 0.589697182728592 0.877839930901789}
{0.4302100498986791 0.2502386675336847 0.6663314402976028}

.ColorfulColors() will return []colorful.Color.

grad := colorgrad.Rainbow()

for _, c := range grad.ColorfulColors(10) {
    fmt.Println(c.Hex())
}

Output:

#6e40aa
#c83dac
#ff5375
#ff8c38
#c9d33a
#7cf659
#5dea8d
#48b8d0
#4775de
#6e40aa

Hard-Edged Gradient

Convert gradient to hard-edged gradient with 11 segments and 0 smoothness.

grad := colorgrad.Rainbow().Sharp(11, 0)

img

This is the effect of different smoothness.

img

Color Schemes

import "github.com/mazznoer/colorgrad/scheme"

scheme.Category10

img

scheme.Accent

img

scheme.Dark2

img

scheme.Paired

img

scheme.Pastel1

img

scheme.Pastel2

img

scheme.Set1

img

scheme.Set2

img

scheme.Set3

img

scheme.Tableau10

img

Examples

Gradient Image

package main

import (
    "image"
    "image/png"
    "os"

    "github.com/mazznoer/colorgrad"
)

func main() {
    grad, _ := colorgrad.NewGradient().
        HtmlColors("#C41189", "#00BFFF", "#FFD700").
        Build()

    w := 1500
    h := 70
    fw := float64(w)

    img := image.NewRGBA(image.Rect(0, 0, w, h))

    for x := 0; x < w; x++ {
        col := grad.At(float64(x) / fw)
        for y := 0; y < h; y++ {
            img.Set(x, y, col)
        }
    }

    file, err := os.Create("gradient.png")
    if err != nil {
        panic(err.Error())
    }
    defer file.Close()
    png.Encode(file, img)
}

Example output:

img

Colored Noise

package main

import (
    "image"
    "image/png"
    "os"

    "github.com/mazznoer/colorgrad"
    "github.com/ojrac/opensimplex-go"
)

func main() {
    w := 600
    h := 350
    scale := 0.02

    grad := colorgrad.Rainbow().Sharp(7, 0.2)
    noise := opensimplex.NewNormalized(996)
    img := image.NewRGBA(image.Rect(0, 0, w, h))

    for y := 0; y < h; y++ {
        for x := 0; x < w; x++ {
            t := noise.Eval2(float64(x)*scale, float64(y)*scale)
            img.Set(x, y, grad.At(t))
        }
    }

    file, err := os.Create("noise.png")
    if err != nil {
        panic(err.Error())
    }
    defer file.Close()
    png.Encode(file, img)
}

Example output:

noise

Playground

Dependencies

Inspirations

FAQs

Package last updated on 07 Sep 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc