diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..00a1235 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# AutoDistortion + + +Distortion of images using randomly-generated functions. + +![A world map distorted using AutoDistortion](worldmap_distorted.jpg) + +This was generated using AutoDistortion from the following image ([Sourced from here](https://upload.wikimedia.org/wikipedia/commons/thumb/e/e2/OrteliusWorldMap1570.jpg/1280px-OrteliusWorldMap1570.jpg)) + +![A world map](worldmap.jpg) + +To run AutoDistortion on an image, download one of the [releases](https://github.com/pommicket/autodistortion/releases), and run the executable. You will be prompted for the name of the image file. + +Only PNG and JPG images are supported so far. + +## Building AutoDistortion from source + +To build AutoDistortion, simply run + +```bash +go get github.com/pommicket/autodistortion +cd $GOPATH/github.com/pommicket/autodistortion +mkdir -p bin +go build -o bin/autodistortion +``` + +## Arguments + +You can see a list of command line arguments using +```bash +autodistortion -help +``` + +These include: + +- `-in`, `-out` - Set the input and output files respectively +- `-seed` - Sets the seed for the random number generator (default to the time in nanoseconds). This is useful for distorting multiple images with the same distortion. +- `-threads` - Sets the number of threads to use (defaults to 64) + +## License + +AutoDistortion is licensed under the [GNU General Public License, Version 3](https://www.gnu.org/licenses/gpl-3.0.html).
\ No newline at end of file |