Skip to content

Commit d41b18c

Browse files
committed
readme and windows package build
1 parent 1967b39 commit d41b18c

3 files changed

Lines changed: 58 additions & 58 deletions

File tree

Packaging/windows/PyImageFuser.spec

Lines changed: 0 additions & 49 deletions
This file was deleted.

Packaging/windows/make_package.cmd

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
@echo off
2+
3+
set VERSION=%1
4+
REM @echo VERSION %VERSION%
5+
6+
IF "%VERSION%" == "" (
7+
@echo.
8+
@echo You need to provide the version
9+
@echo.
10+
exit /b
11+
) ELSE (
12+
set VERSION=%1
13+
)
14+
set WWD=%cd%
15+
echo %WWD%
16+
17+
cd ..\..
18+
19+
set RWD=%cd%
20+
echo %RWD%
21+
22+
echo "Removing the previous build data"
23+
REM del /s /q dist/*
24+
REM del /s /q build/*
25+
del *.spec
26+
rmdir /s /q dist
27+
rmdir /s /s build
28+
29+
echo "Creating the pyinstaller exe"
30+
pyinstaller --onefile --noconsole PyImageFuser.py
31+
32+
@echo Copy docs images and enfuse_ais
33+
xcopy docs dist\docs\ /E
34+
xcopy images dist\images\ /E
35+
xcopy enfuse_ais dist\enfuse_ais\ /E
36+
37+
@echo Now create the zip file
38+
cd dist
39+
zip -r ..\PyImageFuser-%VERSION%-win-x86_64.zip *
40+
cd ..
41+
move PyImageFuser-%VERSION%-win-x86_64.zip %WWD%
42+
cd %WWD%
43+
44+
45+

README.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ PyImageFuser is a Python3 PySimpleGui program to exposure fuse bracketed images,
66

77
[More screenshots also for Windows and MacOS](screenshots/README.md)
88

9-
## In development, no releases yet.
109

1110
## Why doing Exposure Fusion?
1211

@@ -15,33 +14,38 @@ Compact cameras and phones even less.
1514

1615
The human eye has a dynamic range of 20-21 stops.
1716
Our eyes are able to pick up details in deep shadow, but simultaneously also from significantly brighter areas from any given scene.
18-
Actually our eyes are not that much better but our brains "image algorithms" are much better and also adapt automatically to our focus points of attention and correct these.
17+
Actually our eyes are not that much better but the "image algorithms" of our brains are much better and also adapt automatically to our focus points of attention and correct for these focus points.
1918

2019
We can try to achieve the same using a set of photos with different exposure. This is called exposure bracketing.
2120
Most modern camera's support "auto bracketing". You make a photo in "auto bracketing" mode and your camera will take (in general) three photos: a 0EV standard exposure image, a -1EV underexposed image and a +1EV overexposed image.
2221
Almost all camera's have a manual setting to compensate from -2EV (or -3EV) to +2EV (or +3EV) and sometimes more.
2322
These manual settings are preferred over the standard "auto" mode which is mostly limited to -1/+1 EV.
2423
More about this, what the parameters mean and tips & tricks to improve your results in the Help menu.
2524

25+
Nowadays a lot of cameras can also do "in camera" HDR and some can do "in camera" bracketing to a final exposure bracketed image. Due to limited CPU capacity this is often not as good as what can be achieved on a PC/laptop. Next to that: None of the current cameras has the ability to align the images before exposure processing as the CPU performance seriously falls short for this alignment.
26+
2627
## Choise of "tools"
2728
Why use the external enfuse and align_image_stack and not the internal OpenCV/numpy modules to align (alignMTB/ECC/ORB) and exposure fuse (mergeMertens)?
28-
I started with [OpenCV](https://github.com/hvdwolf/PyImageFuser/tree/opencv), but in all my tests especially align_image_stack outperforms the OpenCV alignmnent methods. The OpenCV methods are equal at best, but in 50% of the cases they perform worse. Sometimes clearly visible, sometimes visible when zooming in.
29+
I started with [OpenCV](https://github.com/hvdwolf/PyImageFuser/tree/opencv), but in all my tests especially align_image_stack outperforms the OpenCV alignmnent methods. The OpenCV methods are equal at best, but in 50% (my rough judgement) of the cases they really perform worse. Sometimes clearly visible, sometimes visible when zooming in.
2930
OpenCV mergeMertens is comparable with enfuse (which also uses Mertens), but enfuse is a little more tweakable although you will not use that in 95% of the cases. For "focus stacks" you really need enfuse.
3031

3132

3233

3334
## Installing
34-
**No releases yet**
35-
<!--- Either download one of the pyinstaller packages from the [Releases](https://github.com/hvdwolf/PyImageFuser/releases) page.
35+
Either download one of the binary packages from the [Releases](https://github.com/hvdwolf/PyImageFuser/releases) page.
3636
Unzip it so some place of your liking and start the binary with:
3737

38-
* "PyImageFuser &" (Linux)
39-
* "PyImageFuser.exe" (Windows)
40-
* "PyImageFuser &" (MacOS). *(There is no bundle yet. Maybe later.)*
41-
--->
38+
* "pyimagefuser &" (Linux deb package)
39+
* From the folder where downloaded/copied: "PyImageFuser-<version>-x86_64.AppImage &" (Linux x64 AppImage)
40+
* From the folder where unzipped: "PyImageFuser.exe" (Windows)
41+
<!-- * "PyImageFuser &" (MacOS). *(There is no bundle yet. Maybe later.)* -->
42+
*There is no MacOS bundle yet. I still have troubles with internal paths in the bundle.*
43+
44+
**Or:**
4245
Download this python code and run the following command to install the dependencies:
4346

4447
python3 -m pip install -r requirements.txt
48+
Install enfuse and align_image_stack for your system.
4549

4650
Then start PyImageFuser with:
4751

0 commit comments

Comments
 (0)