Skip to content

STulling/ImageReconstructor

Repository files navigation

Image Reconstructor

This program turns an ordinary image and one or multiple stencils into an image created solely with those stencils.

Usage example

The project includes a sample image and some sample stencils, in the stencils folder.

If everything is configured correctly, you should see the following image:

Installation

Any OS I guess:

Install Julia

Make sure Julia is accessible in your system path. If you don't know how to, please follow this guide: Adding Julia to PATH

Launch the script from the command line.

julia --threads 1 CLI.jl -i shrek.jpg -s stencils -r result.png --iterations 10000
  • --threads gives the amount of threads the script can use. Usually this is the amount of cores your CPU has times 2. It's highly recommended to change this for your specific PC.
  • -i is for the image location (png, jpg, jpeg, and gif file formats accepted)
  • -s is for the stencils folder location
  • -r is for the result image location (optional, defaults to result.png)
  • --iterations if the amount of extra stencils to try and place after the initial fill
  • --improve can be also added if you want to improve the resulting image without starting from scratch.

Or use:

julia --threads 1 StaticInterface.jl

Where you need to edit the file to present all folders and options.

Contributing

There's a lot of work that can be put into this program, I will list some stuff that would be great if implemented. Any other stuff is also cool.

  • GUI
  • CLI
  • Support for stencils of differing sizes
  • Speed up are always great
  • Better video support
  • Live preview?

Release History

  • 0.1.1 "Fixed the breaking" Edition
    • It now doesn't use a module (Julia did not make this less painful)
  • 0.1.0 "Might have broken everything for the sake of speed" Edition
    • Optimized everything for speed
    • It now uses a module (Julia pls make this less painful)
  • 0.0.2 "Works on other machines" Edition
    • Actual project environment thanks to Vexatos
    • Automatic adjustment of max threads thanks to zachmatson
    • Opacity is now scaled instead of binary
  • 0.0.1 "Works on my machine" Edition
    • Initial shitty script

Contributors

Simon381#9384 - u\JanDoedelGaming

Don't hesitate to contact me or make an issue for any issues with the code.

About

Reconstructs an image using smaller images

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages