131 lines
4.1 KiB
Markdown
131 lines
4.1 KiB
Markdown
# resynth
|
|
|
|
resynthesis is the process of taking a source texture and
|
|
creating similar (oft tiling) textures based on it.
|
|
|
|
resynth is a C rewrite of the original resynthesizer by [Paul Harrison.][pfh]
|
|
it does not require GIMP to function; just feed it image paths and it will save copies.
|
|
however, this program lacks the patching (masking) and texture transfer abilities of the original plugin.
|
|
|
|
resynth produces [tiling images like those seen here.][examples]
|
|
|
|
[pfh]: http://logarithmic.net/pfh/
|
|
[examples]: http://logarithmic.net/pfh/resynthesizer/more
|
|
|
|
## related projects
|
|
|
|
* [the original resynthesizer GIMP plugin in C++][orig] and [the associated paper][paper]
|
|
* [an updated resynthesizer GIMP plugin in C and C++][gimp]
|
|
* [syntex: similar algorithms based on resynthesizer in C#][syntex]
|
|
|
|
[orig]: http://logarithmic.net/pfh/resynthesizer
|
|
[paper]: http://www.logarithmic.net/pfh-files/thesis/dissertation.pdf
|
|
[gimp]: https://github.com/bootchk/resynthesizer/
|
|
[syntex]: https://github.com/mxgmn/SynTex/
|
|
|
|
## help
|
|
|
|
```
|
|
usage:
|
|
-a --autism
|
|
sensitivity to outliers
|
|
range: [0,256]; default: 32
|
|
-N --neighbors
|
|
points to use when sampling
|
|
range: [0,1024]; default: 29
|
|
-R --circle-radius
|
|
circle neighborhood radius
|
|
range: [1,128]; default: [n/a]
|
|
-M --tries
|
|
random points added to candidates
|
|
range: [0,65536]; default: 192
|
|
-m --magic
|
|
magic constant, affects iterations
|
|
range: [0,255]; default: 192
|
|
-s --scale
|
|
output size multiplier; negative values set width and height
|
|
range: [-8192,32]; default: 1
|
|
-S --seed
|
|
initial RNG value
|
|
default: 0 [time(0)]
|
|
{files...}
|
|
image files to open, resynthesize, and save as {filename}.resynth.png
|
|
required default: [none]
|
|
```
|
|
|
|
### neighborhood
|
|
|
|
offsets are sorted in ascending distance from the center (the 0,0 point).
|
|
|
|
the order of equal distances is undefined.
|
|
this doesn't matter much in practice,
|
|
considering the algorithm handles non-circular
|
|
neighborhoods just fine.
|
|
|
|
consider the first 29 offsets,
|
|
which is the default number of neighbors:
|
|
|
|
* distance of 0:
|
|
`{ 0, 0}`
|
|
* distance of 1:
|
|
`{ 0,-1}, {+1, 0}, {-1, 0}, { 0,+1}`
|
|
* distance of sqrt(2):
|
|
`{-1,-1}, {-1,+1}, {+1,+1}, {+1,-1}`
|
|
* distance of 2:
|
|
`{+2, 0}, {-2, 0}, { 0,+2}, { 0,-2}`
|
|
* distance of sqrt(5):
|
|
`{-1,-2}, {-2,+1}, {-2,-1}, {+1,+2}, {-1,+2}, {+2,-1}, {+1,-2}, {+2,+1}`
|
|
* distance of sqrt(8):
|
|
`{+2,-2}, {-2,-2}, {-2,+2}, {+2,+2}`
|
|
* distance of 3:
|
|
`{+3, 0}, { 0,-3}, {-3, 0}, { 0,+3}`
|
|
|
|
the default neighborhood of 29 yields a (pixelated) circle,
|
|
as in this crude ascii art:
|
|
```
|
|
X
|
|
XXXXX
|
|
XXXXX
|
|
XXXXXXX
|
|
XXXXX
|
|
XXXXX
|
|
X
|
|
```
|
|
|
|
resynth provides a portion of [the associated integer sequence A057961,][A057961]
|
|
allowing the neighborhood to be specified as a radius-like size,
|
|
with guaranteed symmetry about the X and Y axes.
|
|
this is the `-R` flag, and the first few values are visualized here:
|
|
```
|
|
-R1 -R2 -R3 -R4 -R5 -R6 -R7 -R8
|
|
|
|
X XXX
|
|
X XXX XXXXX XXXXX XXXXX
|
|
X XXX XXX XXXXX XXXXX XXXXX XXXXXXX
|
|
X XXX XXX XXXXX XXXXX XXXXX XXXXXXX XXXXXXX
|
|
X XXX XXX XXXXX XXXXX XXXXX XXXXXXX
|
|
X XXX XXXXX XXXXX XXXXX
|
|
X XXX
|
|
equivalent to
|
|
-N1 -N5 -N9 -N13 -N21 -N25 -N29 -N37
|
|
```
|
|
[A057961]: http://oeis.org/A057961
|
|
|
|
## notes
|
|
|
|
resynth includes the following header libraries:
|
|
|
|
* [stb\_image.h by nothings et al.][stb] (public domain / MIT)
|
|
* [stb\_image\_write.h by nothings et al.][stb] (public domain / MIT)
|
|
* [kyaa.h by notwa][kyaa] (public domain)
|
|
* [rnd.h by Mattias Gustavsson][rnd] (public domain / MIT)
|
|
|
|
[stb]: https://github.com/nothings/stb
|
|
[kyaa]: https://github.com/notwa/kyaa
|
|
[rnd]: https://github.com/mattiasgustavsson/libs
|
|
|
|
compile like
|
|
```
|
|
clang -std=gnu11 -lm -Ofast -DNDEBUG resynth.c -o resynth
|
|
```
|