Skip to content

Home

Jump to bottom Edit New page
nachifur edited this page Aug 17, 2021 · 74 revisions

multiple images viewer

GitHub stars All releases

MulimgViewer

1. Introduction

MulimgViewer is an image viewer, which is capable of displaying multiple images in one window. It is very useful for image comparison, selection and stitching.

Features:

  • Loading images from multiple folders and displaying them side by side
  • Simultaneous magnification of multiple selected areas
  • Image rotation
  • Remote directory support
  • Bulk image resizing

image

Download link: Windows 10 binary package (amd64)

Test images pack download link: https://github.com/nachifur/MulimgViewer/blob/master/img/test_img.zip

Your star is my biggest support in developing and improving this project!

2. Python source code usage

After v3.9.1 only Windows 10 binary package (amd64) will be provided. But you can still use the source code to run the tool on other platforms. It is recommended to use Python 3.6 or newer.

pip installation:

pip install wxpython pillow pytest-shutil

run:

python3 MulimgViewer.py

3. Windows 10

Execute the provided binary file directly. Or download the source code and run MulimgViewer.py.

4. Application Scenarios

Example 1: Parallel image browsing

How long does it take to browse a dataset - CelebA of 202,599 images? Display 1000 images at once using MulimgViewer — you will be all set in 200 clicks! See details.

image

Example 2: Parallel image selection and saving

Previously, you had to open each image separately, compare them one by one, then find the specific images in a folder and copy them to another place.

Now you can use MulimgViewer to load and display all the images from multiple directories at once, then export the image pairs with one click!

image

In Select output mode images will be copied by default, and moved if Move file option is selected. Use Select output mode with Parallel Auto or Parallel Manual input modes and disabled Parallel+Sequential option.

Example 3: Parallel zoom

MulimgViewer supports automatic image stitching, saving and magnification in parallel!

image

You can select any part of the image to magnify that area. Click Zoom 🔍, then click the left mouse button and draw a rectangle. Also you can duplicate the selection (click the right mouse button) and view all magnified areas simultaneously. See details.

image

Example 4: Dataset browsing, paired images

MulimgViewer makes it easy to view and compare paired images.

image

Example 5: Browse images in a remote directory

After mounting a remote directory you can open that directory in MulimgViewer to view the images.

  1. Ubuntu: In the example below we connected to server stfp://10.8.0.4 using Ubuntu's file manager nautilus.
  1. win10: After installing WinFsp and SSHFS-Win, fill in the remote server ip in the file explorer, for example: \\sshfs\user@ip!port

Example 6: Click to rotate

Click Rotate ↷, then click the left mouse button to rotate an image.

image

Example 7: Batch image resizing

It is possible to batch resize images using the auto-save function. Step-by-step instructions:

  1. Input mode: Sequential. Choose the input directory;
  2. Choose the output directory;
  3. Check Auto save all;
  4. Set Truth resolution to a fixed size, for example 256,256;
  5. Click Save 💾️.

5. Usage Instructions

5.1 Shortcut bar

image

5.2 Process Flow

  1. Fill in the layout parameters in the Settings panel: row (number of images in a row), num per img (number of sub-images that will be combined into a single image), col (number of images in a column).

  2. File->Open, select input mode:

    2.1. Sequential: Multiple images in one folder.

    2.2. Parallel Auto: One folder with several subfolders, each subfolder contains multiple images.

    2.3. Parallel Manual: Manually select multiple folders.

    2.4. Image File List: Import images according to a given list of filenames (TXT, CSV).

  3. After loading the images you can use the Next and Previous buttons to switch between them.

  4. File->Output path, Select the output path.

5.3 Keyboard shortcuts

Input path:

  • Sequential: Ctrl+E
  • Parallel Auto: Ctrl+A
  • Parallel Manual: Ctrl+M
  • Image File List: Ctrl+F

Output path: Ctrl+O

Next: Ctrl+N

Previous Ctrl+L

Save: Ctrl+S

Refresh: Ctrl+R

Use the keyboard arrow keys (up, down, left, right) to move the image in the image panel.

5.4 Functionality description

5.4.1 Input mode

Sequential is a serial browsing mode. It is used to display and stitch multiple images with different filenames contained in a single folder.

Parallel Auto and Parallel Manual are parallel browsing modes (subfolders with different names). In order to compare the images, each folder or subfolder must contain the images with the same filenames.

Image File List is a custom mode. You can import a list of images from TXT or CSV file. CSV supports multi-line and multi-column mode.

For automatic image arrangement set Num per img to -1.

5.4.2 Output mode

Stitch: Save the stitched image to the stitch_images directory.

Select: Save the currently displaying images to a different folder. By default the images will be copied to a new location, you can select Move file to move them instead.

Magnifer: Save all the magnified areas separately.

Other modes are just the different combinations of the three modes listed above.

5.4.3 Automatic image arrangement

By default Num per img = -1 and this is an automatic layout mode. Num per img means that several images are combined into a single image.

5.4.4 Disable automatic image arrangement

If Num per img = 1 or >1, then the image layout is in manual mode. In this mode row and col numbers can be adjusted.

5.4.5. Sequential browsing in a parallel mode

By selecting Parallel+Sequential option, you can simultaneously view the first n images in folders 1-12, n can be set by Num per img.

For example: row=5, Num per img=4, col=1 means that MulimgViewer will show 4 images from 5 parallel directories at once, 20 images in total. Check Vertical to change the image layout direction.

Modify row and col to control the two-dimensional arrangement of parallel folders.

image

5.4.6 Auto save

Select Auto save all, then click Save 💾️.

5.4.7 Image size normalization

Fill: Image size is the largest image in a group, filling mode (keep the original pixel resolution).

Crop: Image size is the smallest image in a group, cropping mode (keep the original pixel resolution).

Resize: Image size is an average size of all the images in a group, scaling mode (don't keep the original pixel resolution).

5.4.8 Gap between images

image

5.4.9 Color fill

You can use custom background and foreground colors and transparency.

5.4.10 Parallel Manual mode supports file list import and export

5.4.11 Independent display and output sizes

This feature provides independent view and output scales.

Application scenario:

  1. When you need to display a lot of images at the same time and the screen can’t fit them all, just set Show scale to shrink the images.
  2. Stitched images at 100% scale can be very large, but you can control the dimensions of the individual images by setting Output scale.

5.4.12 Parallel zoom

Process Flow:

  1. Click Zoom;
  1. Mouse pointer will be turned into a crosshair cursor. Now you can make a selection;
  2. To make a selection press and hold the left mouse button, drag mouse to draw a rectangle and then release the button — a magnified area will be displayed;
  3. Click the right mouse button to duplicate the selection.

Tips:

  1. 🔍️Keep size — keep the image and the magnified area aspect ratios the same.
  2. 🔍️Scale by default is set to -1,1, which means the scaling factor will be chosen automatically.
  3. Select Vertical, then press Crtl+R to place the magnified area on the right side of the original image.
  4. Use 🔍️Scale to change the magnification factor, but keep in mind that the maximum size will not exceed the original image size. For example, 3,3 means enlargement by a scale factor of 3.
  5. Set Draw line width to 0 to hide the selection border.
  6. Draw line width is set in pixels and remains the same in all zoom levels. If the selection border width is suitable when Show scale is set to 0.1,0.1 and Output scale is set to 1,1, then it will probably be much thinner in the output image.

Adjust the position of the selection:

  1. Check Select box;
  2. Position the mouse pointer inside the selection border and click the left mouse button to select it;
  3. Use the keyboard arrow keys to adjust the position of the selection;
  4. Uncheck Select box.

Note: After selecting Select box option you cannot make a new selection by pressing the left mouse button, but you can still duplicate an exsisting selection by pressing the right mouse button.

Clear a selection:

Method 1:

  1. Check Select box, click the left mouse button on a selection, press Del to clear the chosen selection;
  2. Unheck Select box, press Del to clear all selections.

Method 2:

  1. Uncheck Select box;
  2. Double-click the left mouse button on the image;
  3. Press Ctrl+R to clear all the selections and refresh the view.

5.4.13 Automatic window size adjustment

Enable Auto layout for automatic window resizing.

5.4.14 Browse images, precise positioning

Move the slider for coarse positioning.

  1. Help->Index Table;
  2. Find the serial number of the image;
  3. Enter the serial number and press Enter.

6. Important information and useful tips

6.1 Parallel mode

  1. Make sure that image filenames in all folders/subfolders are the same when using the multi-image modes (Parallel Manual and Parallel Auto).
  2. Subfolder naming is also important. If the names are 0,1,2...10,11, then you should change them to 00,01,02...10,11. Otherwise MulimgViewer will sort them as 0,1,10,11,2...

Recommended file renaming tool:

win10: uTools

Ubuntu:

  1. purrr. sudo apt install purrr
  2. Thunar-Bulk Rename Files. sudo apt install thunar

6.2 Multi-image stitching, high resolution images, window size issues

  1. Disable Auto layout and maximize the window.
  2. Adjust Show scale as needed. For example, 0.2,0.2 to shrink, 2,2 to enlarge images.
  3. Set Truth resolution to resize all the images to the same size for your viewing convenience.

7. Future enhancements

Thanks for your comments! Leave your suggestions, ideas and feedback in the issues, and I will try to implement the most useful ones! If you want to cooperate with me in development, please contact me!

  • Add precise positioning (currently there is a slider)
  • Add image index view to facilitate precise positioning
  • Parallel partial zoom function (used for contrast experiment pictures in the paper needed urgently!)
  • Input method, new: import and storage of path files (@nothingeasy provides suggestions for improvement)
  • Add delete function (perfect filter function)
  • Save the original framed image (@JuZiSYJ provides suggestions for improvement)
  • Each image can be rotated after clicking
  • Add multi-box zoom function (@JuZiSYJ provides suggestions for improvement)
  • Remove the box of cropped images (@stefanklut provides suggestions for improvement)
  • Comparison of high-definition images, and 1:1 output of enlarged images (@Faberman provides suggestions for improvement)
  • Add title for each image (@Faberman provides suggestions for improvement)

8. Acknowledgements

  • nothingeasy: improvement opinions-(input method, new addition: import and storage of path files)
  • JuZiSYJ: Suggestions for improvement-(Save original image with frame + parallel zoom)
  • Faberman: Suggestions for improvement-(add titile for each image + magnified image 1:1 output)

9. Cite This Project

If you use this project in your research please use the following BibTeX entry.

@misc{MulimgViewer2020,
  author =       {Liu, Jiawei},
  title =        {{MulimgViewer: A multi-image viewer for image comparison and image stitching}},
  howpublished = {\url{https://github.com/nachifur/MulimgViewer}},
  year =         {2020}
}

10. Terms of use

License

GPL-3.0 License：https://www.gnu.org/licenses/gpl-3.0.en.html

Additiona terms of use

Add a custom footer

Getting Started

Install and download

Usage Instructions

Communication

Issue

Discussions

MISC

Acknowledgements

Future enhancements

Ongoing Projects

Clone this wiki locally