67 lines
3.2 KiB
Markdown
67 lines
3.2 KiB
Markdown
# HANDOFF.md
|
||
|
||
Current state of the comic compression toolchain as of 2026-06-28.
|
||
|
||
## Repositories
|
||
|
||
| Repo | Branch | Latest commit |
|
||
|------|--------|---------------|
|
||
| `comic-compress-new` (CLI) | main | `94f3fab` |
|
||
| `iMGcompress-core` (library) | master | `a03d0e5` |
|
||
| `iMGcompress` (GUI) | master | `7b7021a` |
|
||
|
||
## What was done in this session (v3.1.0 / v2.0.0)
|
||
|
||
### NuGet package updates (all three projects)
|
||
- SharpCompress `0.42` → `0.49.1` (CVE GHSA-6c8g-7p36-r338 fixed)
|
||
- Magick.NET-Q8-x64 → `14.14.0` (multiple CVEs fixed)
|
||
- Imazen.WebP → `11.0.0`
|
||
- Imageflow.AllPlatforms + Imageflow.Net → `0.15.1`
|
||
- iTextSharp → `5.5.13.5`, itext → `9.6.0`
|
||
- McMaster.Extensions.CommandLineUtils → `5.1.0`
|
||
- System.Drawing.Common → `10.0.9`
|
||
|
||
### SharpCompress 0.49 breaking API migration (`iMGcompress-core`)
|
||
- `ReaderFactory.Open` → `OpenReader(stream, new ReaderOptions())`
|
||
- `RarArchive/ZipArchive.Open` → `OpenArchive(filename, new ReaderOptions())`
|
||
- `ZipArchive.Create()` → `CreateArchive()`
|
||
- `SaveTo(path, CompressionType)` → `SaveTo(path, new ZipWriterOptions(CompressionType))`
|
||
- Return type `ZipArchive` → `IWritableArchive<ZipWriterOptions>`
|
||
- Removed `using ZstdSharp` (internalized in 0.49)
|
||
|
||
### Parallel within-archive compression (`iMGcompress-core`, `-P` flag)
|
||
- New `ProcessArchivePAR2` + `CompressEntrySync` in `Compressor.cs`
|
||
- Batched 3-phase design: sequential read → `Parallel.For` (`ProcessorCount/2` threads) → sequential write
|
||
- Ordering guaranteed by indexed pre-allocated result slots
|
||
- Measured speedup: **~3.4–5×** vs serial on i7-12700KF (10 batch size)
|
||
- Memory bounded per batch; logs strictly in original entry order from write phase
|
||
|
||
### MemoryStream pre-sizing (`iMGcompress-core`)
|
||
- All `new MemoryStream()` → `new MemoryStream(entry.Size > 0 ? (int)entry.Size : 4096)`
|
||
- Eliminates buffer-doubling reallocations on all 9 allocation sites in `Compressor.cs`
|
||
|
||
### CLI fixes and new flags (`ComicCompress`)
|
||
- Fixed missing `OnExecuteAsync` — app was throwing `InvalidOperationException` on launch
|
||
- Added `-w|--new-webp`: use Imageflow encoder (experimental; benchmarked 8–15% slower than Imazen.WebP)
|
||
- Added `-P|--par-archive`: enable parallel within-archive compression
|
||
|
||
### GUI (`iMGcompress`)
|
||
- Added `checkBox_parArchive` (flat-button, location `382,231`, TabIndex 14)
|
||
- Default ON for COMIX and COMIX+PDF modes; OFF for IMAGE and ZEBRA
|
||
- Wired into `FileProcessor.ProcessorFlags` constructor
|
||
- Version bumped to `2.0.0 (28/06/2026)`
|
||
|
||
### Other
|
||
- Added `CLAUDE.md` to `comic-compress-new` with build commands and architecture notes
|
||
|
||
## Current versions
|
||
|
||
- CLI (`ComicCompress`): `3.1.0 (28/06/2026)` — see `Program.cs`
|
||
- GUI (`iMGcompress`): `2.0.0 (28/06/2026)` — see `MGCompress.cs`
|
||
|
||
## Known state / open items
|
||
|
||
- **Imageflow encoder** (`-w` flag) is wired and working but consistently slower than Imazen.WebP across all tested archive sizes. Kept as an experimental path only.
|
||
- **`libwebp.dll`** must be present alongside the executable — it is checked into the repo root of both `comic-compress-new` and `iMGcompress-core`.
|
||
- The GUI runs single-threaded on the UI thread (`button_start_Click` is synchronous). Long jobs block the window. Not addressed in this session.
|