openfocus 1.28__tar.gz

openfocus-1.28/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenFocus Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

openfocus-1.28/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: openfocus
+Version: 1.28
+Summary: Multi-focus image fusion from the command line: registration (ECC / homography) plus five fusion algorithms in one pip-installable tool
+Author-email: Xinzhe Xie <xiexinzheyyy@163.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Xinzhe99/OpenFocus
+Project-URL: Documentation, https://github.com/Xinzhe99/OpenFocus#command-line-usage
+Project-URL: Changelog, https://github.com/Xinzhe99/OpenFocus/blob/main/CHANGELOG.md
+Keywords: image-fusion,focus-stacking,multifocus,microscopy,photography
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: opencv-python-headless
+Requires-Dist: scipy
+Requires-Dist: dtcwt
+Requires-Dist: imageio
+Provides-Extra: ai
+Requires-Dist: torch; extra == "ai"
+Requires-Dist: torchvision; extra == "ai"
+Provides-Extra: heic
+Requires-Dist: pillow-heif; extra == "heic"
+Dynamic: license-file
+
+# <img src="assets/OpenFocus.png" alt="OpenFocus Logo" width="120"> OpenFocus
+
+OpenFocus delivers focus stacking quality that rivals commercial-grade software, while staying fully open source and easy to extend.
+
+<p align="left">
+  <a href="https://www.python.org/downloads/release/python-3100/"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python 3.10+" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?logo=open-source-initiative&logoColor=white" alt="License: MIT" /></a>
+  <a href="https://github.com/Xinzhe99/OpenFocus"><img src="https://img.shields.io/badge/GitHub-Repository-181717?logo=github&logoColor=white" alt="GitHub Repository" /></a>
+  <a href="https://github.com/Xinzhe99/OpenFocus/releases"><img src="https://img.shields.io/badge/Windows%20%7C%20macOS-Download-0078D7?logo=github&logoColor=white" alt="Download" /></a>
+</p>
+
+## 📢 News
+
+> [!NOTE]
+> 🎉 **2026.09.29**: **v1.27** — **16-bit stacks no longer fuse to a black or blown-out image** (bit depth is now carried from loading through fusion to export), **Help → Check for Updates → "Update and Restart" works again** (it had been failing silently, and now also handles installs under Program Files), tall/wide stacks stop crashing tiled fusion, cancelling a large render takes effect immediately, and closing the window mid-job asks before discarding the result. Also fixed this round: quick-preview and ROI renders no longer poison the saved alignment, Compare All can be cancelled, deleting a frame keeps its filename, downsampling stops compounding below the percentage you chose, batch jobs check their output folder before they start, `.ofproj` projects reopen after the images move, and the sharpness curve is readable in the dark theme.
+
+> 🎉 **2026.09.29**: **v1.26** — fixed the **"I/O operation on closed file"** render crash in windowed builds and a stale embedded version number that kept offering updates users already had.
+
+> 🎉 **2026.09.28**: **v1.25 / v1.24 / v1.22** — portable mode (settings travel with the app), one-click in-app update with progress, EXIF preservation, HEIC/HEIF input, and render-failure tracebacks in the log folder.
+
+> 🎉 **2026.09.28**: **v1.21** — project files (.ofproj), built-in demo stack, per-frame sharpness curve, Japanese + Spanish interfaces.
+
+**Earlier milestones**: v1.9–v1.20 brought the Wipe compare view, dark/light themes, Compare-All-Methods rendering, quick preview, cancellable background renders, 16-bit pipeline, registration disk cache, batch CLI, WebP export, Windows installer + macOS DMG, and CI test automation. Full history in the [Changelog](./CHANGELOG.md).
+
+<a id="download"></a>
+## ⬇️ Download & Install
+
+No setup needed — grab a build from the [Releases](https://github.com/Xinzhe99/OpenFocus/releases) page:
+
+| Platform | File | Type |
+|----------|------|------|
+| Windows 10/11 (64-bit) | `OpenFocus-*-setup.exe` | **Installer** (recommended) |
+| Windows 10/11 (64-bit) | `OpenFocus-*-windows-x64.zip` | Portable (unzip and run) |
+| macOS Apple Silicon (M1–M4) | `OpenFocus-*-macos.dmg` | Disk image (drag to Applications) |
+| macOS Apple Silicon (M1–M4) | `OpenFocus-*-macos-arm64.zip` | Portable (unzip) |
+
+The app is unsigned, so the first launch may show a security prompt:
+- **Windows**: SmartScreen → "More info" → "Run anyway". The first start may take 30–60 s.
+- **macOS**: right-click → Open, or run `xattr -cr /Applications/OpenFocus.app` in Terminal.
+
+Full details, including the portable mode and the log folder, are in the [User Manual](./docs/USER_MANUAL_EN.md).
+
+<a id="command-line-usage"></a>
+## 💻 Command Line Usage
+Beyond the GUI, OpenFocus can run headless — handy for batch scripts and CI pipelines:
+```bash
+# Fuse a folder of images with guided filter, no registration
+python main.py --input ./stack_folder --output ./result/fused.png
+
+# DTCWT with ECC registration, 8 threads
+python main.py -i ./stack_folder -o ./result/fused.png -m dtcwt -a ecc -t 8
+
+# StackMFF-V4 forced to CPU with custom tile size
+python main.py -i ./stack_folder -o ./result/fused.png -m stackmffv4 --cpu --tile-size 512
+
+# Explicit file list instead of a folder; video files also work as input
+python main.py -i img1.jpg img2.jpg img3.jpg -o fused.png -m gfgfgf
+
+# Batch mode: fuse every folder into one output directory
+python main.py --input ./stackA ./stackB --output-dir ./results
+```
+Exit codes: `0` success, `1` processing error, `2` usage error. Run `python main.py --help` for all options.
+
+## 📖 Documentation
+- [**User Manual (English)**](./docs/USER_MANUAL_EN.md) — full feature guide: interface, workflows, wipe compare, settings, batch, CLI, troubleshooting
+- [**用户手册（中文）**](./docs/USER_MANUAL_ZH.md) — 完整中文功能手册
+- [**Changelog**](./CHANGELOG.md) — release history and notable changes
+- [**Build Commands**](./docs/BUILD_COMMANDS.md) — packaging from source with PyInstaller
+
+<a id="building-from-source"></a>
+## 🛠️ Building from Source
+
+For contributors and platforms without pre-built packages:
+```bash
+conda create -n openfocus python=3.10
+conda activate openfocus
+pip install -r requirements.txt
+python main.py
+```
+Packaging with PyInstaller: see [docs/BUILD_COMMANDS.md](./docs/BUILD_COMMANDS.md).
+
+## Table of Contents
+- [⬇️ Download & Install](#download)
+- [💻 Command Line Usage](#command-line-usage)
+- [📖 Documentation](#documentation)
+- [🛠️ Building from Source](#building-from-source)
+- [🔭 Overview](#overview)
+- [✨ Highlights](#highlights)
+- [🧪 Algorithms](#algorithms)
+- [📚 References](#references)
+- [🤝 Contribution](#contribution)
+- [📄 License](#license)
+- [⭐ Star History](#star-history)
+
+<a id="overview"></a>
+## 🔭 Overview
+OpenFocus is a PyQt6-based multi-focus registration and fusion workstation that delivers commercial-grade alignment and blending results. The project is fully open source (MIT License) and runs on CPU by default with optional GPU acceleration for the StackMFF V4 neural model.
+
+<p align="center">
+	<img src="assets/ui.jpg" alt="OpenFocus UI" width="720">
+</p>
+
+<a id="highlights"></a>
+## ✨ Highlights
+- **Beginner-Friendly**: Plug-and-play workflows with unapologetically simple, guided operations.
+- **Flexible Processing Flows**: Run fusion-only, registration-only, or combined registration + fusion pipelines depending on your workload.
+- **Wipe Compare View**: Overlay any source frame and any result in one frame with a draggable divider and shared zoom — spot alignment errors at a glance.
+- **Batch Automation**: Kick off batch jobs across multiple folders with live progress, cancellation, and automatic output organization.
+- **Headless CLI**: Full pipeline from the command line with script-friendly exit codes.
+- **Annotation & Export Toolkit**: Overlay labels, export GIF animations, drag results straight out of the app, and save stacks in JPG/PNG/BMP/TIFF.
+- **AI-Assisted Fusion**: Ship with StackMFF V4 to unlock deep-learning-quality fusion alongside classic signal-processing methods.
+- **Remembers You**: Settings, language, GPU preference and recently opened stacks persist across sessions; bilingual UI throughout.
+
+<a id="fusion--registration-methods"></a>
+## 🧪 Algorithms
+### Fusion Algorithms
+
+- **Guided Filter**: Fast edge-preserving fusion that enhances contrast while suppressing noise.
+- **DCT Multi-Focus Fusion**: Frequency-domain technique optimized for crisp detail recovery.
+- **Dual-Tree Complex Wavelet Transform (DTCWT)**: Multi-scale representation that preserves fine texture structures.
+- **GFG-FGF**: GFG-FGF is based on a generalized four-neighborhood Gaussian gradient (GFG) operator combined with a fast guided filter (FGF). 
+- **StackMFF V4**: Pretrained deep model delivering state-of-the-art focus stacking quality.
+
+### Registration Algorithms
+- **Homography**: Performs feature-based projective alignment using keypoint matching and RANSAC to handle global perspective transformations.
+- **ECC**: Performs intensity-based alignment by maximizing the enhanced correlation coefficient for precise, sub-pixel registration.
+  
+> **License Notice:** Every fusion/registration algorithm included comes from open-source research implementations. When using or redistributing them, please follow each algorithm’s original license terms in addition to the OpenFocus MIT license.
+
+<a id="references"></a>
+## 📚 References
+- M. B. A. Haghighat, A. Aghagolzadeh, and H. Seyedarabi, "Multi-focus image fusion for visual sensor networks in DCT domain," *Computers & Electrical Engineering*, vol. 37, no. 5, pp. 789-797, 2011.
+- J. J. Lewis, R. J. O'Callaghan, S. G. Nikolov, D. R. Bull, and N. Canagarajah, "Pixel- and region-based image fusion with complex wavelets," *Information Fusion*, vol. 8, no. 2, pp. 119-130, 2007.
+- S. Li, X. Kang, and J. Hu, "Image fusion with guided filtering," *IEEE Transactions on Image Processing*, vol. 22, no. 7, pp. 2864-2875, 2013.
+- 付宏语, 巩岩, 汪路涵, 等. 多聚焦显微图像融合算法[J]. Laser & Optoelectronics Progress, 2024, 61(6): 0618022-0618022-9.
+
+<a id="contribution"></a>
+## 🤝 Contribution
+We welcome community contributions of all kinds:
+1. **Issues**: Report bugs, request features, or propose UX enhancements.
+2. **Algorithm & Performance Work**: Share new fusion/registration ideas, optimizations.
+
+> Bug reports or suggestions? Please open an issue so we can follow up quickly.
+
+<a id="license"></a>
+
+## 📄 License
+This project is released under the [MIT License](./LICENSE). Feel free to use, modify, and distribute within the terms of the license.
+
+If you publish images created with OpenFocus, please consider adding a note such as:
+
+Created with OpenFocus – https://github.com/Xinzhe99/OpenFocus
+
+This is not mandatory, but highly appreciated.
+
+<p align="center" style="font-size:1.25rem; font-weight:600;">
+  If OpenFocus helps you, please consider leaving a ⭐ on the repository!
+</p>
+
+<a id="star-history"></a>
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Xinzhe99/OpenFocus&type=Date)](https://star-history.com/#Xinzhe99/OpenFocus&Date)
+
+
+
+
+
+
+
+
+
+
+
+
+
+

openfocus-1.28/README.md

@@ -0,0 +1,177 @@
+# <img src="assets/OpenFocus.png" alt="OpenFocus Logo" width="120"> OpenFocus
+
+OpenFocus delivers focus stacking quality that rivals commercial-grade software, while staying fully open source and easy to extend.
+
+<p align="left">
+  <a href="https://www.python.org/downloads/release/python-3100/"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python 3.10+" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?logo=open-source-initiative&logoColor=white" alt="License: MIT" /></a>
+  <a href="https://github.com/Xinzhe99/OpenFocus"><img src="https://img.shields.io/badge/GitHub-Repository-181717?logo=github&logoColor=white" alt="GitHub Repository" /></a>
+  <a href="https://github.com/Xinzhe99/OpenFocus/releases"><img src="https://img.shields.io/badge/Windows%20%7C%20macOS-Download-0078D7?logo=github&logoColor=white" alt="Download" /></a>
+</p>
+
+## 📢 News
+
+> [!NOTE]
+> 🎉 **2026.09.29**: **v1.27** — **16-bit stacks no longer fuse to a black or blown-out image** (bit depth is now carried from loading through fusion to export), **Help → Check for Updates → "Update and Restart" works again** (it had been failing silently, and now also handles installs under Program Files), tall/wide stacks stop crashing tiled fusion, cancelling a large render takes effect immediately, and closing the window mid-job asks before discarding the result. Also fixed this round: quick-preview and ROI renders no longer poison the saved alignment, Compare All can be cancelled, deleting a frame keeps its filename, downsampling stops compounding below the percentage you chose, batch jobs check their output folder before they start, `.ofproj` projects reopen after the images move, and the sharpness curve is readable in the dark theme.
+
+> 🎉 **2026.09.29**: **v1.26** — fixed the **"I/O operation on closed file"** render crash in windowed builds and a stale embedded version number that kept offering updates users already had.
+
+> 🎉 **2026.09.28**: **v1.25 / v1.24 / v1.22** — portable mode (settings travel with the app), one-click in-app update with progress, EXIF preservation, HEIC/HEIF input, and render-failure tracebacks in the log folder.
+
+> 🎉 **2026.09.28**: **v1.21** — project files (.ofproj), built-in demo stack, per-frame sharpness curve, Japanese + Spanish interfaces.
+
+**Earlier milestones**: v1.9–v1.20 brought the Wipe compare view, dark/light themes, Compare-All-Methods rendering, quick preview, cancellable background renders, 16-bit pipeline, registration disk cache, batch CLI, WebP export, Windows installer + macOS DMG, and CI test automation. Full history in the [Changelog](./CHANGELOG.md).
+
+<a id="download"></a>
+## ⬇️ Download & Install
+
+No setup needed — grab a build from the [Releases](https://github.com/Xinzhe99/OpenFocus/releases) page:
+
+| Platform | File | Type |
+|----------|------|------|
+| Windows 10/11 (64-bit) | `OpenFocus-*-setup.exe` | **Installer** (recommended) |
+| Windows 10/11 (64-bit) | `OpenFocus-*-windows-x64.zip` | Portable (unzip and run) |
+| macOS Apple Silicon (M1–M4) | `OpenFocus-*-macos.dmg` | Disk image (drag to Applications) |
+| macOS Apple Silicon (M1–M4) | `OpenFocus-*-macos-arm64.zip` | Portable (unzip) |
+
+The app is unsigned, so the first launch may show a security prompt:
+- **Windows**: SmartScreen → "More info" → "Run anyway". The first start may take 30–60 s.
+- **macOS**: right-click → Open, or run `xattr -cr /Applications/OpenFocus.app` in Terminal.
+
+Full details, including the portable mode and the log folder, are in the [User Manual](./docs/USER_MANUAL_EN.md).
+
+<a id="command-line-usage"></a>
+## 💻 Command Line Usage
+Beyond the GUI, OpenFocus can run headless — handy for batch scripts and CI pipelines:
+```bash
+# Fuse a folder of images with guided filter, no registration
+python main.py --input ./stack_folder --output ./result/fused.png
+
+# DTCWT with ECC registration, 8 threads
+python main.py -i ./stack_folder -o ./result/fused.png -m dtcwt -a ecc -t 8
+
+# StackMFF-V4 forced to CPU with custom tile size
+python main.py -i ./stack_folder -o ./result/fused.png -m stackmffv4 --cpu --tile-size 512
+
+# Explicit file list instead of a folder; video files also work as input
+python main.py -i img1.jpg img2.jpg img3.jpg -o fused.png -m gfgfgf
+
+# Batch mode: fuse every folder into one output directory
+python main.py --input ./stackA ./stackB --output-dir ./results
+```
+Exit codes: `0` success, `1` processing error, `2` usage error. Run `python main.py --help` for all options.
+
+## 📖 Documentation
+- [**User Manual (English)**](./docs/USER_MANUAL_EN.md) — full feature guide: interface, workflows, wipe compare, settings, batch, CLI, troubleshooting
+- [**用户手册（中文）**](./docs/USER_MANUAL_ZH.md) — 完整中文功能手册
+- [**Changelog**](./CHANGELOG.md) — release history and notable changes
+- [**Build Commands**](./docs/BUILD_COMMANDS.md) — packaging from source with PyInstaller
+
+<a id="building-from-source"></a>
+## 🛠️ Building from Source
+
+For contributors and platforms without pre-built packages:
+```bash
+conda create -n openfocus python=3.10
+conda activate openfocus
+pip install -r requirements.txt
+python main.py
+```
+Packaging with PyInstaller: see [docs/BUILD_COMMANDS.md](./docs/BUILD_COMMANDS.md).
+
+## Table of Contents
+- [⬇️ Download & Install](#download)
+- [💻 Command Line Usage](#command-line-usage)
+- [📖 Documentation](#documentation)
+- [🛠️ Building from Source](#building-from-source)
+- [🔭 Overview](#overview)
+- [✨ Highlights](#highlights)
+- [🧪 Algorithms](#algorithms)
+- [📚 References](#references)
+- [🤝 Contribution](#contribution)
+- [📄 License](#license)
+- [⭐ Star History](#star-history)
+
+<a id="overview"></a>
+## 🔭 Overview
+OpenFocus is a PyQt6-based multi-focus registration and fusion workstation that delivers commercial-grade alignment and blending results. The project is fully open source (MIT License) and runs on CPU by default with optional GPU acceleration for the StackMFF V4 neural model.
+
+<p align="center">
+	<img src="assets/ui.jpg" alt="OpenFocus UI" width="720">
+</p>
+
+<a id="highlights"></a>
+## ✨ Highlights
+- **Beginner-Friendly**: Plug-and-play workflows with unapologetically simple, guided operations.
+- **Flexible Processing Flows**: Run fusion-only, registration-only, or combined registration + fusion pipelines depending on your workload.
+- **Wipe Compare View**: Overlay any source frame and any result in one frame with a draggable divider and shared zoom — spot alignment errors at a glance.
+- **Batch Automation**: Kick off batch jobs across multiple folders with live progress, cancellation, and automatic output organization.
+- **Headless CLI**: Full pipeline from the command line with script-friendly exit codes.
+- **Annotation & Export Toolkit**: Overlay labels, export GIF animations, drag results straight out of the app, and save stacks in JPG/PNG/BMP/TIFF.
+- **AI-Assisted Fusion**: Ship with StackMFF V4 to unlock deep-learning-quality fusion alongside classic signal-processing methods.
+- **Remembers You**: Settings, language, GPU preference and recently opened stacks persist across sessions; bilingual UI throughout.
+
+<a id="fusion--registration-methods"></a>
+## 🧪 Algorithms
+### Fusion Algorithms
+
+- **Guided Filter**: Fast edge-preserving fusion that enhances contrast while suppressing noise.
+- **DCT Multi-Focus Fusion**: Frequency-domain technique optimized for crisp detail recovery.
+- **Dual-Tree Complex Wavelet Transform (DTCWT)**: Multi-scale representation that preserves fine texture structures.
+- **GFG-FGF**: GFG-FGF is based on a generalized four-neighborhood Gaussian gradient (GFG) operator combined with a fast guided filter (FGF). 
+- **StackMFF V4**: Pretrained deep model delivering state-of-the-art focus stacking quality.
+
+### Registration Algorithms
+- **Homography**: Performs feature-based projective alignment using keypoint matching and RANSAC to handle global perspective transformations.
+- **ECC**: Performs intensity-based alignment by maximizing the enhanced correlation coefficient for precise, sub-pixel registration.
+  
+> **License Notice:** Every fusion/registration algorithm included comes from open-source research implementations. When using or redistributing them, please follow each algorithm’s original license terms in addition to the OpenFocus MIT license.
+
+<a id="references"></a>
+## 📚 References
+- M. B. A. Haghighat, A. Aghagolzadeh, and H. Seyedarabi, "Multi-focus image fusion for visual sensor networks in DCT domain," *Computers & Electrical Engineering*, vol. 37, no. 5, pp. 789-797, 2011.
+- J. J. Lewis, R. J. O'Callaghan, S. G. Nikolov, D. R. Bull, and N. Canagarajah, "Pixel- and region-based image fusion with complex wavelets," *Information Fusion*, vol. 8, no. 2, pp. 119-130, 2007.
+- S. Li, X. Kang, and J. Hu, "Image fusion with guided filtering," *IEEE Transactions on Image Processing*, vol. 22, no. 7, pp. 2864-2875, 2013.
+- 付宏语, 巩岩, 汪路涵, 等. 多聚焦显微图像融合算法[J]. Laser & Optoelectronics Progress, 2024, 61(6): 0618022-0618022-9.
+
+<a id="contribution"></a>
+## 🤝 Contribution
+We welcome community contributions of all kinds:
+1. **Issues**: Report bugs, request features, or propose UX enhancements.
+2. **Algorithm & Performance Work**: Share new fusion/registration ideas, optimizations.
+
+> Bug reports or suggestions? Please open an issue so we can follow up quickly.
+
+<a id="license"></a>
+
+## 📄 License
+This project is released under the [MIT License](./LICENSE). Feel free to use, modify, and distribute within the terms of the license.
+
+If you publish images created with OpenFocus, please consider adding a note such as:
+
+Created with OpenFocus – https://github.com/Xinzhe99/OpenFocus
+
+This is not mandatory, but highly appreciated.
+
+<p align="center" style="font-size:1.25rem; font-weight:600;">
+  If OpenFocus helps you, please consider leaving a ⭐ on the repository!
+</p>
+
+<a id="star-history"></a>
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Xinzhe99/OpenFocus&type=Date)](https://star-history.com/#Xinzhe99/OpenFocus&Date)
+
+
+
+
+
+
+
+
+
+
+
+
+
+

openfocus-1.28/constants.py

@@ -0,0 +1,43 @@
+APP_VERSION = "1.28"
+
+WINDOW_WIDTH = 1600
+WINDOW_HEIGHT = 950
+
+TILE_BLOCK_SIZE = 1024
+TILE_OVERLAP = 256
+TILE_THRESHOLD = 2048
+TILE_BLOCK_MIN = 64
+TILE_BLOCK_MAX = 16384
+TILE_OVERLAP_MAX = 4096
+TILE_THRESHOLD_MIN = 256
+TILE_THRESHOLD_MAX = 131072
+
+REG_DOWNSCALE_WIDTH = 1024
+HOMOGRAPHY_DOWNSCALE_WIDTH = 1600
+ECC_DOWNSCALE_WIDTH = 1000
+
+STATUS_UPDATE_INTERVAL_MS = 2000
+
+BYTES_TO_GB = 1024 ** 3
+
+FEATURE_MAX_KEYPOINTS = 200
+FEATURE_MATCH_THRESHOLD = 0.01
+FEATURE_RANSAC_REJECTS = 30
+FEATURE_RANSAC_MAX_ITER = 3
+
+MAGNIFIER_SIZE = 320
+ANIMATION_DURATION_MS = 400
+
+DEFAULT_THREAD_COUNT = 4
+MIN_THREAD_COUNT = 1
+MAX_THREAD_COUNT = 16
+
+STACKMFFV4_BATCH_SIZE = 2
+STACKMFFV4_BATCH_SIZE_MIN = 1
+STACKMFFV4_BATCH_SIZE_MAX = 16
+
+KERNEL_SIZE_MIN = 3
+KERNEL_SIZE_MAX = 51
+KERNEL_SIZE_DEFAULT_DCT = 7
+KERNEL_SIZE_DEFAULT_GFF = 31
+KERNEL_SIZE_DEFAULT_GFG = 7

openfocus-1.28/core/__init__.py

@@ -0,0 +1,30 @@
+"""
+Core modules for OpenFocus.
+
+Modules:
+- image_loader: Image stack loading and processing
+- registration: Image registration algorithms
+- multi_focus_fusion: Multi-focus image fusion orchestrator
+- workers: Background thread workers for rendering
+- models: Neural network models (StackMFF-V4)
+"""
+
+from core.image_loader import ImageStackLoader
+from core.multi_focus_fusion import MultiFocusFusion, is_stackmffv4_available
+
+try:  # GUI stack; workers (and app below) need PyQt6, the headless CLI
+    # package installs without it.
+    from core.workers import RenderWorker, ROIAlignmentWorker
+    from core.app import OpenFocusApplication, process_command_line_args
+    _HAS_QT = True
+except ImportError:  # pragma: no cover - headless openfocus package
+    RenderWorker = ROIAlignmentWorker = None
+    OpenFocusApplication = process_command_line_args = None
+    _HAS_QT = False
+
+__all__ = [
+    'ImageStackLoader',
+    'MultiFocusFusion',
+    'is_stackmffv4_available',
+    'RenderWorker',
+]

openfocus-1.28/core/app.py

@@ -0,0 +1,162 @@
+"""
+Cross-platform file drag-and-drop support for OpenFocus.
+
+Supports:
+- macOS: Dock drag-and-drop via QFileOpenEvent
+- Linux: Desktop file drag-and-drop via command-line arguments
+- Windows: EXE/shortcut drag-and-drop via command-line arguments
+"""
+
+import sys
+import os
+from typing import List, Optional
+from urllib.parse import unquote
+
+from PyQt6.QtWidgets import QApplication
+from PyQt6.QtGui import QFileOpenEvent
+from PyQt6.QtCore import QTimer, QUrl
+
+
+class PlatformFileHandler:
+    """Normalizes and classifies file paths from different platform sources."""
+
+    @staticmethod
+    def normalize(path: str) -> str:
+        """Turn a file:// URI (or a mac-style /// path) into a local path.
+
+        QUrl.toLocalFile() does the platform-correct job: hand-stripping the
+        scheme leaves the URI's leading slash on Windows, so 'file:///C:/stack'
+        became '/C:/stack' and the file was never found. Percent-decoding also
+        belongs to URI syntax only — a plain command-line path may contain a
+        literal '%', so it must not be unquoted here.
+        """
+        if not path:
+            return ""
+
+        if path.startswith('file://'):
+            local = QUrl(path).toLocalFile()
+            if local:
+                return local
+            return '/' + unquote(path[7:]).lstrip('/')   # malformed URI fallback
+
+        if path.startswith('///'):
+            # Extra leading slashes in front of an absolute POSIX path
+            return '/' + unquote(path).lstrip('/')
+
+        return path
+
+    @staticmethod
+    def is_video(path: str) -> bool:
+        from core.image_loader import ImageStackLoader
+        return os.path.splitext(path)[1].lower() in ImageStackLoader.SUPPORTED_VIDEO_FORMATS
+
+    @staticmethod
+    def is_image(path: str) -> bool:
+        from core.image_loader import ImageStackLoader
+        return os.path.splitext(path)[1].lower() in ImageStackLoader.SUPPORTED_FORMATS
+
+    @staticmethod
+    def classify(paths: List[str]) -> dict:
+        result = {'dirs': [], 'videos': [], 'images': [], 'other': []}
+        for p in paths:
+            normalized = PlatformFileHandler.normalize(p)
+            if not os.path.exists(normalized):
+                continue
+            if os.path.isdir(normalized):
+                result['dirs'].append(normalized)
+            elif PlatformFileHandler.is_video(normalized):
+                result['videos'].append(normalized)
+            elif PlatformFileHandler.is_image(normalized):
+                result['images'].append(normalized)
+            else:
+                result['other'].append(normalized)
+        return result
+
+
+class OpenFocusApplication(QApplication):
+    """QApplication subclass handling file open events from platform sources."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.main_window = None
+        self._pending: List[str] = []
+        self._ready = False
+
+    def set_main_window(self, window):
+        self.main_window = window
+        self._ready = True
+        if self._pending:
+            pending = self._pending.copy()
+            self._pending.clear()
+            QTimer.singleShot(100, lambda: self._process(pending))
+
+    def event(self, event) -> bool:
+        if event.type() == QFileOpenEvent.Type:
+            path = QFileOpenEvent(event).file()
+            if path:
+                if self._ready and self.main_window:
+                    self._handle(path)
+                else:
+                    self._pending.append(path)
+            return True
+        return super().event(event)
+
+    def _handle(self, path: str):
+        normalized = PlatformFileHandler.normalize(path)
+        if normalized:
+            self._process([normalized])
+
+    def _process(self, paths: List[str]):
+        if not self._ready or not self.main_window:
+            return
+        if not hasattr(self.main_window, 'source_manager'):
+            return
+
+        src = self.main_window.source_manager
+        c = PlatformFileHandler.classify(paths)
+        files = c['videos'] + c['images'] + c['other']
+
+        if len(c['dirs']) == 1 and not files:
+            src.load_image_stack_from_icon(c['dirs'][0])
+        elif c['dirs']:
+            src.load_multiple_folders_from_icon(c['dirs'])
+        elif len(c['videos']) == 1 and not c['images']:
+            src.load_video_stack_from_icon(c['videos'][0])
+        elif c['images']:
+            src.load_image_files_from_icon(c['images'])
+        else:
+            from utils import show_warning_box
+            from locales import trans
+            show_warning_box(
+                self.main_window,
+                trans.t("msg_no_valid_files_title"),
+                trans.t("msg_no_valid_files_text"),
+            )
+
+
+def process_command_line_args(main_window, args: List[str]):
+    """Handle files passed via command-line (drag-to-EXE, desktop file %U, etc.)."""
+    if not args:
+        return
+
+    file_paths = [a for a in args if not a.startswith('-')]
+    if not file_paths:
+        return
+
+    def _delayed():
+        if not hasattr(main_window, 'source_manager'):
+            return
+        c = PlatformFileHandler.classify(file_paths)
+        src = main_window.source_manager
+        files = c['videos'] + c['images'] + c['other']
+
+        if len(c['dirs']) == 1 and not files:
+            src.load_image_stack_from_icon(c['dirs'][0])
+        elif c['dirs']:
+            src.load_multiple_folders_from_icon(c['dirs'])
+        elif len(c['videos']) == 1 and not c['images']:
+            src.load_video_stack_from_icon(c['videos'][0])
+        elif c['images']:
+            src.load_image_files_from_icon(c['images'])
+
+    QTimer.singleShot(100, _delayed)