Skip to content

CieloStitch v0.5.00

Latest
Latest

Choose a tag to compare

View all tags
@dc-saha dc-saha released this 28 May 07:28
· 2 commits to main since this release
v0.5.00
77600aa

CieloStitch v0.5.00 is a major release focused on geometry, projection, blending, and engine flexibility.

This release brings a substantial step forward in stitch quality and workflow coverage:

  • A modular transform pipeline now supports translation, affine, homography, and apap modes.
  • New projection and parallax-handling paths expand support for difficult panorama layouts.
  • A new Simple Engine provides a fast alternate stitching path alongside the main engine.
  • Seam-aware ghost-guard fallback and bundle adjustment improve results in challenging overlaps.
  • The app UI, session handling, and help system were reviewed and refined across multiple revisions leading up to v0.5.00.

Highlights

Geometry and projection upgrades

  • Added a modular transform branch with explicit transform_mode support for translation, affine, homography, and apap.
  • Removed the old lock_rotation parameter in favor of transform-mode-driven behavior.
  • Added a modular cylindrical projection path with safe defaults so existing behavior remains unchanged unless explicitly enabled.
  • Implemented APAP-based parallax handling for harder real-world alignment cases.
  • Reorganized projection-related code, including dedicated projection modules for cylindrical projection and APAP warping.
  • Added bundle adjustment to further refine alignment quality.

Blending and overlap quality

  • Implemented a seam-aware ghost-guard fallback in the blender.
  • High-risk overlaps now route through a content-aware seam path instead of the older generic narrowed-feather fallback.
  • The new seam path builds an overlap cost map from luminance and gradient disagreement, finds a minimum-cost seam with a dynamic-programming pass, blends through a narrow seam band, and records a localized seam trace in seam diagnostics.
  • Hardened and reviewed matcher.py.
  • Fixed natural-sort behavior for filenames that begin with mixed integer and character prefixes.

New engine and workflow options

  • Added a new Simple Engine based on cv2.Stitcher_create.
  • Introduced engine as a selectable option in the basic and advanced panes.
  • Added a CLI engine parameter so command-line runs can select the stitching engine.
  • Implemented a timeout for the Simple Engine.
  • When the Simple Engine runs, the status bar now shows elapsed time instead of placed-image counts.

App behavior and UX improvements

  • Fixed an auto-mode reset issue so user-triggered mode changes now restore the canonical baseline before applying auto mode.
  • Added an output-panel context menu action to copy the current image to the clipboard, respecting zoom and tone presentation.
  • Added an input-panel context menu action to exclude an image.
  • Double-clicking input or output images now opens them in the external viewer.
  • Double-clicking the input/output header row now toggles between panel-only view and the default layout.
  • Output image dimensions are now displayed in context menu.
  • Log panel rendering now shows the first and last parts of long filenames for better readability.

Session Resolver

  • Reviewed and comprehensively updated session_resolver.py.
  • Session resolving now calculates additional parameters.
  • Reviewed and updated the settings-file manager.
  • Settings JSON file version is now 1.1.

Developer and advanced controls

  • Introduced a developer_mode context parameter to show or hide expert controls.
  • The following controls are now hidden unless developer_mode is enabled, even if advanced mode is on:
    • photometric_min_overlap_px
    • photometric_full_confidence_px
    • staged_matching_mode
    • refs_per_stage
    • adaptive_mb_risk_boost_threshold
    • adaptive_mb_low_risk_threshold
    • adaptive_mb_max_boost
    • ghost_guard_risk_threshold
    • ghost_guard_feather_px
    • local_gain_tile_size
    • enable_grid_nominal_fallback

Help and Fixes

  • Updated in-app help and site help content.
  • Updated help files for the newly hidden parameters and related advanced controls.
  • Included several bug fixes and internal refactors.

Version path to v0.5.00

This release consolidates work delivered incrementally across the internal v0.4.51 through v0.4.99 cycle, including:

  • v0.4.51: transform branch expansion, matcher hardening, projection groundwork, session resolver improvements.
  • v0.4.52-v0.4.53: ghost-guard rollout, help updates, settings manager review, and developer-mode gating for expert controls.
  • v0.4.90-v0.4.96: APAP, app workflow improvements, panel interactions, external viewer support, and Simple Engine integration.
  • v0.4.97-v0.4.99: bundle adjustment, broader test coverage, session resolver review, output/logging polish, and structural refactoring.

Included in this release

  • App version: 0.5.00
  • Core version: 0.5.00
  • Release type: stable
Assets 4
Loading