https://github.com/abcaeffchen/generativeart
Just a generator for images
https://github.com/abcaeffchen/generativeart
generative-art image-generator
Last synced: 11 months ago
JSON representation
Just a generator for images
- Host: GitHub
- URL: https://github.com/abcaeffchen/generativeart
- Owner: AbcAeffchen
- License: gpl-3.0
- Created: 2017-05-26T02:01:28.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-04-25T11:49:47.000Z (about 8 years ago)
- Last Synced: 2025-03-13T06:14:05.836Z (over 1 year ago)
- Topics: generative-art, image-generator
- Language: C++
- Size: 754 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GenerativeArt
This is a just for fun project aiming to generate some nice images.
## Compiling
```bash
mkdir build && cd build && mkdir images
cmake ..
cmake --build . --target GenerativeArt -j
```
## How to use it
## Options
```text
Usage: GenerativeArt [OPTIONS]
Options:
-h,--help Print this help message and exit
Program Options:
-s,--num-samples UINT=100 The number of samples generated.
--color-permutations Stores six color permutations of each image.
--no-scale Scaling adjusts the resolution, such that the resulting image's shortest edge has at leastthe number of pixels set as resolution.
-v,--verbose Shows details about what the program is doing.
-w,--write-ini TEXT Writes the current settings into the given ini file.
--config TEXT Read an ini file
-o,--out TEXT=images/ The directory where the images are stored.
Randomness Options:
-f,--file-name TEXT Excludes: --function-depth --function-params --color-poly-deg --color-poly-params --function-seed --color-seed --num_unary_functions --num_binary_functions
The file name of a sample image. This can be used to regenerate the image on a higher resolution. If used you cannot use any of the randomness options.
-D,--function-depth UINT UINT=4 7 Excludes: --file-name
The domain the depth of the random function is drawn from.
-P,--function-params FLOAT FLOAT=1 1.9 Excludes: --file-name
The domain the parameters of the random function is drawn from.
-d,--color-poly-deg UINT UINT=2 3 Excludes: --file-name
The domain the degree of the random color polynomials is drawn from.
-p,--color-poly-params FLOAT FLOAT=-96 96 Excludes: --file-name
The domain the parameters of the random color polynomials is drawn from.
-F,--function-seed UINT Excludes: --file-name
The seed for the random function. If provided only one image is generated.
-C,--color-seed UINT Excludes: --file-name
The seed for the color functions. If provided only one image is generated.
--num_unary_functions UINT=13 Excludes: --file-name
Number of unary functions available. This is just to support more functions without breaking generation of old images.
--num_binary_functions UINT=4 Excludes: --file-name
Number of binary functions available. This is just to support more functions without breaking generation of old images.
Image Options:
-r,--resolution UINT=200 The resolution the image(s) are generated in.
-x,--x-domain FLOAT FLOAT=0 1
Min and max values of the domain of the x dimension.
-y,--y-domain FLOAT FLOAT=0 1
Min and max values of the domain of the y dimension.
-n,--no-normalization Stops normalizing the color transitions, that reduces the flickering.
--projection-type {Cap=0, Periodic=1, Smooth Periodic=2}=0
The way the values of the color polynomials get projected into the [0,255] range.
- Cap: x -> 255 for x > 255, x -> 0 for x < 0, x -> x else.
- Periodic: x -> x mod 256
- Smooth Periodic: x -> x mod 2 -> 255 * x^2 * (x-2)^2
```
## Development Notices
New functions can be added to the function pool without
risking that the old results cannot be reproduced.
But the order an number of `rand()` calls must not
be changed to ensure this! If the order or number of the
`rand()` calls changes the whole random function changes.
## How it works
1. A random function is drawn as a call tree of functions from
a function pool.
2. For each color (red, green, blue) is a random polynomial drawn.
3. Generate for each pixel a value using the random function.
4. Generate a color value for each pixel using the random color functions
and the value from the first function as input.
5. The color values for each pixel get normalized to smooth
color changes. (can be turned off)
6. Write the image to disk using a file name that contains all settings
so you can easily reproduce the image.
## TODO
- Improve the seed handling. Color map seeds turned out mostly useless.
- try other ways to project the result of the random function into [0,255].
- Maybe the performance can be improved by using SIMD.
- check for all while / all black images and don't store them.
## Dependencies
- Commandline Parser [cxxopts](https://github.com/jarro2783/cxxopts) is
used as a submodule.
- [png++ 0.2.9](http://savannah.nongnu.org/projects/pngpp/) is used to generate
png files.
Therefore libpng and libzip needs to be installed.
- OpenMP is used to generate an image in parallel.
## You Like the Project?
Have a look a my [printed art](https://www.redbubble.com/people/abcaeffchen)
or my [amazon list](https://www.amazon.de/gp/registry/wishlist/3HVLST6MM4MNH/).
## Licence
GPL v3.0