image-debug-utils 0.1.0

# image-debug-utils

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bioinformatist/image-debug-utils)
[![Rust CI](https://github.com/bioinformatist/image-debug-utils/actions/workflows/ci.yml/badge.svg)](https://github.com/bioinformatist/image-debug-utils/actions/workflows/ci.yml)
[![Build and Deploy to Pages](https://github.com/bioinformatist/image-debug-utils/actions/workflows/pages.yml/badge.svg)](https://github.com/bioinformatist/image-debug-utils/actions/workflows/pages.yml)
[![codecov](https://codecov.io/gh/bioinformatist/image-debug-utils/graph/badge.svg?token=23U4M79DJH)](https://codecov.io/gh/bioinformatist/image-debug-utils)

Some niche but useful utilities for [`imageproc`](https://github.com/image-rs/imageproc).

## Usage

## Examples

### Visual Comparison

Demonstration of `remove_hypotenuse_in_place` filtering out high-aspect-ratio artifacts (thin lines) from a synthetic shape.

| Before Processing | After `remove_hypotenuse_in_place` |
| :---: | :---: |
| ![Before](assets/readme_before.png) | ![After](assets/readme_after.png) |
| *Original contours (Red) showing noisy thin lines* | *Processed contours (Green) with noise removed* |

### Feature Gallery

| Intelligent Bounding Boxes | Connected Components Labeling |
| :---: | :---: |
| ![Rects](assets/readme_rects.png) | ![Components](assets/readme_components.png) |
| *Converting Rotated Rects (Green) to AABB (Red)* | *Visualizing Top-5 connected regions with distinct colors* |

### Interactive Demo (WASM)

Try the interactive visualizer to experiment with parameters in real-time.

**Run Locally:**
```bash
cd examples/visualizer
trunk serve
```

**Features:**
- **Mode Selection**: Switch between 5 different demonstration modes.
- **Filter Contours**: Real-time `remove_hypotenuse_in_place` handling (Aspect Ratio).
- **Sort Contours**: Visualize `sort_by_perimeters_owned` and `sort_by_direct_children_count_owned` via heatmaps.
- **Bounding Boxes**: Compare Rotated Rects (Blue) vs Axis-Aligned Bounding Boxes (Red) using `to_axis_aligned_bounding_box`.
- **Connected Components**: Visualize `draw_principal_connected_components` with adjustable Top-N ranking.
- **Random Images**: Instantly fetch fresh content from `picsum.photos` to test robustness.