noita-mapcap/bin/stitch/README.md
David Vogel 52e23df1ee Several stitcher updates
- Use different progress bar
- Add bounds parameter to MedianBlendedImage
- Add progress to MedianBlendedImage
- Replace the `-lowram` flag with `-prerender`
- Update README.md
2019-11-05 02:31:19 +01:00

2.5 KiB

Stitch

A program to stitch (overlapping) image tiles of pixel-art to one big image.

The program will use median filtering for overlapping images. That means that all moving object will completely disappear, and only the static pixels will be outputted. But this has the disadvantage of being slower, and objects that move only a little bit may become blurred.

You can also use this program to remove moving objects from a series of photographs taken with a tripod. But as this tool is designed for pixel art, it only accepts png as input.

Source images

The source images need to contain their coordinates in the filename, as this program doesn't align the images:

%d,%d.png

example list of files:

0,0.png
512,0.png
-512,0.png
512,-512.png

Usage

  • Either run the program and follow the interactive prompt.
  • Or run the program with parameters:
    • divide int A downscaling factor. 2 will produce an image with half the side lengths. (default 1)
    • input stringThe source path of the image tiles to be stitched. (default "..\..\output")
    • output string The path and filename of the resulting stitched image. (default "output.png")
    • xmax int Right bound of the output rectangle. This coordinate is not included in the output.
    • xmin int Left bound of the output rectangle. This coordinate is included in the output.
    • ymax int Lower bound of the output rectangle. This coordinate is not included in the output.
    • ymin int Upper bound of the output rectangle. This coordinate is included in the output.
    • prerender Pre renders the image in RAM before saving. Can speed things up if you have enough RAM.

To output the 100x100 area that is centered at the origin use:

./stitch -divide 1 -xmin -50 -xmax 50 -ymin -50 -ymax 50

To enter the parameters inside of the program:

./stitch

Example output:

Enter downscaling factor:1
Enter input path:..\..\output
2019/11/04 23:53:20 Starting to read tile information at "..\..\output"
2019/11/04 23:53:32 Got 20933 tiles
2019/11/04 23:53:32 Total size of the possible output space is (-25620,-36540)-(25620,36540)
Enter output rectangle (xMin,yMin;xMax,yMax):-25620,-36540;25620,36540
Enter output filename and path:output.png
2019/11/04 23:53:35 Creating output file "output.png"
105 / 571 [--------------->____________________________________________________________________] 18.39% 1 p/s ETA 14m0s