maxhalford / pointu

:pencil2: Pointillisme tool based on Weighted Voronoi Stippling

pointu

pointu is a tool to render images with points of varying sizes and colors in an artistic way. The implementation is based on Adrian Secord's 2002 paper entitled Weighted Voronoi Stippling. The name pointu is derived from pointillism, a painting technique in which points are used to form an image.

Installation

1. Install Go
2. Make sure that $GOPATH is set and that $GOPATH/bin has been added to the global path
3. Run go get -u github.com/MaxHalford/pointu
4. Run pointu -help to check that the installation was successful

Examples

pointu -in examples/originals/plant4h.png -out examples/processed/plant4h.png -points 5000

Original	Processed

pointu -in examples/originals/plant2_400x400.png -out examples/processed/plant2_400x400.png -points 10000 -rmin 0.5 -rmax 0.5

Original	Processed

pointu -in examples/originals/figure5_525x525.png -out examples/processed/figure5_525x525.png -points 3000 -rmax 2

Original	Processed

pointu -in examples/originals/shoe_1300x1300_org.png -out examples/processed/shoe_1300x1300_org.png -points 5000 -iterations 100 -rmin 2 -rmax 3

Original	Processed

pointu -in examples/originals/bird.jpg -out examples/processed/bird.png -points 60000 -iterations 15 -rmin 2 -rmax 3 -color

Original	Processed

pointu -in examples/originals/pasta.jpg -out examples/processed/pasta.png -points 80000 -iterations 15 -rmin 2 -rmax 3 -resolution 4 -color

Original	Processed

Usage

Run pointu -h to get a list of available parameters.

Implementation details

Please check out this blog post for some details on the implementation.

License

The MIT License (MIT). Please see the license file for more information.

pointu's Issues

panic: invalid argument to Intn

$ convert -size 100x100 xc:black black.png
$ pointu -in black.png -out black_p.png
panic: invalid argument to Intn

goroutine 1 [running]:
math/rand.(*Rand).Intn(0xc4200182d0, 0x0, 0xc42003fbbc)
        /home/user/go/src/math/rand/rand.go:141 +0xc7
github.com/MaxHalford/pointu/pointu.ImportanceSample(0x1f4, 0xc4200143c0, 0xc4200143c8, 0xc4200182d0, 0x64, 0x0, 0xc420014140)
        /home/user/gocode/src/github.com/MaxHalford/pointu/pointu/importance_sampling.go:35 +0x336
main.main()
        /home/user/gocode/src/github.com/MaxHalford/pointu/cli.go:55 +0x13a