pix

README

Pix

Turn photos into abstract art.

Install the command-line tool with go get:

go get -u github.com/yurivish/pix/cmd/pix

Run it like so:

pix -in picture.jpg

Generate multiple outputs by sweeping the parameter space:

pix -in picture.jpg -sweep

Pix is capable of generating 8,000×8,000 outputs in around a minute.

The pixel-placement process is inherently serial and performs one nearest-neighbor search per output pixel, so the time taken depends significantly on the placement order and color distribution since those affect the size of the dynamic search tree and the shape of the frontier.

When the -sweep or -variations flags are used, variations are generated in parallel.

Documentation

Index

• func Generate(input string, width int, height int, whitePercent int, color int, random int, ...)
• func NewNeighbors(w, h int) neighbors
• func Place(colors []SampledColor, opts Options) error
• func SortBySimilarity(colors []SampledColor, opts SortOptions)
• type Canvas
  • func NewCanvas(w, h int, seed int64) *Canvas
  • func (c *Canvas) ImageData() []uint8
  • func (c *Canvas) Place(x SampledColor)
  • func (c *Canvas) PlaceAt(code MortonCode, pos Pos)
  • func (c *Canvas) PlaceSeed(color SampledColor, x, y int)
  • func (c *Canvas) PlaceSeeds(colors []SampledColor, xys ...int) ([]SampledColor, error)
  • func (c *Canvas) Reset()
  • func (c *Canvas) SaveImage(path string, compressionLevel png.CompressionLevel) error
• type Color
• type Handle
• type ImageColor
  • func LoadImage(path string) ([]ImageColor, error)
• type MortonCode
• type Options
• type Pos
• type SampledColor
  • func SampleColors(src []ImageColor, nPixels int) []SampledColor
• type SortOptions
• type Work

Functions

func Generate

func Generate(input string, width int, height int, whitePercent int, color int, random int, reverse bool, sweep bool, seed int64, compress int, seedsString string, generateVideo bool)

func NewNeighbors

func NewNeighbors(w, h int) neighbors

func Place

func Place(colors []SampledColor, opts Options) error

func SortBySimilarity

func SortBySimilarity(colors []SampledColor, opts SortOptions)

Types

type Canvas

type Canvas struct {
	// contains filtered or unexported fields
}

A canvas represents a specific pixel-placed drawing

func NewCanvas

func NewCanvas(w, h int, seed int64) *Canvas

func (*Canvas) ImageData

func (c *Canvas) ImageData() []uint8

func (*Canvas) Place

func (c *Canvas) Place(x SampledColor)

func (*Canvas) PlaceAt

func (c *Canvas) PlaceAt(code MortonCode, pos Pos)

func (*Canvas) PlaceSeed

func (c *Canvas) PlaceSeed(color SampledColor, x, y int)

func (*Canvas) PlaceSeeds

func (c *Canvas) PlaceSeeds(colors []SampledColor, xys ...int) ([]SampledColor, error)

func (*Canvas) Reset

func (c *Canvas) Reset()

func (*Canvas) SaveImage

func (c *Canvas) SaveImage(path string, compressionLevel png.CompressionLevel) error

type Color

type Color struct {
	// contains filtered or unexported fields
}

Color represents a color in linear RGB or OkLab

type Handle

type Handle uint32

type ImageColor

type ImageColor struct {
	X, Y    int
	R, G, B uint8
}

func LoadImage

func LoadImage(path string) ([]ImageColor, error)

Returns `ImageColor`s from the source in row major order.

type MortonCode

type MortonCode uint32

type Options

type Options struct {
	Width, Height    int
	RandomSeed       int64
	Sort             SortOptions
	Seeds            []int
	Output           string
	CompressionLevel png.CompressionLevel
	Video            bool
}

type Pos

type Pos int32

Pos represents an (x, y index) pair as a single uint32 index into a (padded) array.

type SampledColor

type SampledColor struct {
	// contains filtered or unexported fields
}

Represents a color sample in the RGB and OkLab color spaces, along with its Morton and Hilbert codes.

func SampleColors

func SampleColors(src []ImageColor, nPixels int) []SampledColor

type SortOptions

type SortOptions struct {
	Image, Color, Random float64
	Reverse              bool
}

type Work

type Work struct {
	// contains filtered or unexported fields
}