sharpy 0.1.2

High-performance image sharpening library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- Memory bounds checking to prevent processing extremely large images (max 100MP, max dimension 65k)
- Comprehensive integration tests for image processing algorithms
- Test coverage for edge strength measurement and visual regression
- Shared `Operation` enum between library and CLI

### Changed
- `Image::from_rgb()` and `Image::from_dynamic()` now return `Result<Image>` for safety
- Optimized parallel processing to eliminate intermediate vector allocations
- Improved memory efficiency by processing image rows in-place
- Consolidated duplicate Operation enums between CLI and library

### Fixed
- Memory inefficiency in `unsharp_mask`, `enhance_edges`, and `clarity` functions
- Unnecessary cloning when using `Arc` in `into_arc_dynamic()`
- README.md overly promotional language and incorrect "zero dependencies" claim

### Performance
- Reduced memory usage by ~50% for large images through streaming pixel processing
- Eliminated collection of all pixels into vectors before applying changes
- Improved cache locality with row-based parallel processing

## [0.1.0] - 2025-08-03

### Added
- Initial release of sharpy image sharpening library
- Four sharpening algorithms:
  - Unsharp mask - Classic sharpening method
  - High-pass sharpening - Convolution-based enhancement
  - Edge enhancement - Using Sobel and Prewitt operators
  - Clarity - Local contrast enhancement
- Builder pattern API for chaining operations
- Six built-in presets:
  - Subtle - Light sharpening for general use
  - Moderate - Balanced sharpening with clarity
  - Strong - Heavy sharpening for soft images
  - Edge-aware - Emphasizes edges while preserving smooth areas
  - Portrait - Optimized for portraits (avoids over-sharpening skin)
  - Landscape - Maximum detail extraction for landscapes
- CLI tool with commands:
  - `sharpy unsharp` - Apply unsharp mask
  - `sharpy highpass` - Apply high-pass sharpening
  - `sharpy edges` - Enhance edges
  - `sharpy clarity` - Apply clarity enhancement
  - `sharpy preset` - Use built-in presets
  - `sharpy batch` - Process multiple files
- Parallel processing using Rayon for optimal performance
- Copy-on-write semantics for efficient memory usage
- Comprehensive documentation and examples
- Benchmarks using Criterion

### Performance
- Separable convolution for Gaussian blur operations
- Chunk-based parallel processing for better cache locality
- Zero-copy operations where possible

### Dependencies
- image 0.25
- rayon 1.10
- thiserror 2.0
- clap 4.5 (CLI only)
- indicatif 0.18 (CLI only)
- glob 0.3 (CLI only)
- anyhow 1.0 (CLI only)

[Unreleased]: https://github.com/maxenko/sharpy/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/maxenko/sharpy/releases/tag/v0.1.0