Skip to content
GUI for ESRGAN with additional features
Branch: crop-upscale-m…
Clone or download
Latest commit 60dc855 Jun 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
GitHubUpdate Update UpdateNotifyDialog.Designer.cs Jun 3, 2019
crop-upscale-merge Close #13 Jun 4, 2019
.gitattributes Add files via upload Apr 24, 2019
.gitignore Add *.bat to ignore Jun 1, 2019
LICENSE Initial commit Apr 24, 2019
README.md Update README.md Jun 25, 2019
crop-upscale-merge.sln Add x64 project configuration Jun 1, 2019

README.md

crop-upscale-merge

GUI for ESRGAN with additional features

downloads_latest downloads_total

Uses net-vips library to split input images into tiles and then merge them after processing with ESRGAN. Also supports alpha channels (transparency) and various image formats (.dds, .tga etc).

If you want to use all features of this tool (filtering, logs and more) - don't use imagemagick tiling. Also imagemagick merging might leave visible seams.

Although app can detect model upscale size by running python script, for better perfomance it is highly recommended to rename all your models so that filenames contain upscale size as in screenshot below.

YOU DON'T PUT YOUR IMAGES IN LR FOLDER, PUT THEM IN "IMAGES" FOLDER AND CROP THEM, TILES WILL BE CREATED IN LR IN PNG FORMAT

Please, before using this tool ensure that you installed all python dependencies correctly and ESRGAN is working.

Requirements

  • .NET Framework 4.5
  • ESRGAN (old version)
  • ImageMagick 7 (optional, for using ImageMagick instead of vips)

screen

Usage

On first launch specify ESRGAN main directory path in Settings tab. You can also specify folders for input and output images. By default it will be "esrgan-path/img" and "esrgan-path/results/merged".

Check one or more models from the tree view, select corresponding upscale size, output mode.

When ready click [CROP] button. Tiles will be created from input images in "esrgan-path/LR" directory. Tile resolution will be calculated from MaxTileResolution value (biggest possible). Each time old tiles will be deleted from folder. You need to always run [CROP] before ESRGAN, even when you don't really need to crop images.

Click [RUN ESRGAN] button to start ESRGAN script in console window.

When ESRGAN is finished, results will be in "results-path" folder, "results-path/models" or "results-path/images" folders, depending on which output mode you selected earlier.

To merge resulted tiles back click [MERGE] button.

Notice: Don't delete images from input directory before you finished working with them.

Troubleshooting

  • ModuleNotFoundError: No module named 'architecture' - you are using new version of ESRGAN, it's not compatible with old models and this tool. Download older version from the link above.

Settings

screen-settings

Maximum tile resolution

MaxTileResolution = TileWidth x TileHeight Currently, to find out how big MaxTileResolution you VGRAM can handle you need to experiment. Default value is for 2Gb VRAM (GTX 750 Ti).

Tiles overlap

When creating tiles, they will be overlaping between themselves by size in pixels specified by this value. Value must be at least 16 pixels. The bigger value - more time to process tiles with ESRGAN.

Ignore alpha

If checked, while creating tiles and merging them, alpha channels from input images will be ignored.

Preserve image format

When merging writes image in original format. If unchecked all images will be merged as PNG.

Create image image in input folder

Creates blank black image with max TileWith and TileHeight. It's might be needed because if ESRGAN starts with small image and then tries to process bigger image, it can run in out of memory error.

Delete results after merging

After succesfullyu merging image deletes all of it merged tiles in result folder.

screen-adv

Use suffix

Usefull when you are using tool other than ESRGAN and your processed image have suffix. Just check this option and write it in textbox befote merging tiles.

Filters

Use various filter if you want to work only with particular images from input folder. For example you might upscale only images with "(wood)" in filename. Or you want to merge images without alpha as .png and the rest - as .tga etc.
Filters work only when cropping and merging! ESRGAN still process all files from it's LR directory.

Output modes

Default

  • Results: esrgan-path/results
  • Merged results: merged-results-path/

Folder for each image

  • Results: results-path/images/image-name/
  • Merged results: merged-results-path/images/image-name/merged

Folder for each model

  • Results: results-path/models/model-name/
  • Merged results: merged-results-path/models/model-name/merged
You can’t perform that action at this time.