47 lines
3.2 KiB
Markdown
47 lines
3.2 KiB
Markdown
# Image Tools
|
||
|
||
Image Tools is a standalone, local-first raster editor for the [add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal). It checks and processes selected files in the browser; image contents are not uploaded.
|
||
|
||
## Version 0.1 scope
|
||
|
||
- Open static JPEG, PNG and WebP images.
|
||
- Inspect signatures, dimensions, animation, alpha, EXIF orientation and common metadata/profile markers before decode.
|
||
- Refuse recognized animated or multi-picture input instead of silently discarding frames.
|
||
- Crop with numeric controls, centered aspect presets and a pointer/keyboard-adjustable overlay; zoom source and result together from 25–400% without changing export pixels.
|
||
- Rotate in quarter turns and flip horizontally or vertically.
|
||
- Resize by fit, center-cropped fill or exact dimensions.
|
||
- Preview source and result side by side while keeping the last completed preview visible during updates.
|
||
- Export PNG, JPEG or WebP with an explicit quality/background policy.
|
||
- Save/load a strictly validated, versioned JSON recipe containing transform, output and metadata/colour policy.
|
||
- Apply one recipe to a bounded queue; download results individually or build one collision-free ZIP containing images, per-image JSON reports and a batch manifest. ZIP assembly has its own 128 MiB input / 160 MiB output budget and is cancellable while reading or compressing.
|
||
|
||
Inputs are bounded before browser decoding: 20 files, 256 MiB per source, 512 MiB per queue, 32,768 pixels per edge, 40 megapixels, and a 512 MiB estimated working-memory budget. Image processing runs through the shared cancellable disposable-worker protocol when OffscreenCanvas is available, with typed progress, a main-thread capability fallback and a 120-second hard deadline.
|
||
|
||
## Honest format and colour policy
|
||
|
||
Version 0.1 is intentionally static-only. GIF, AVIF, HEIC, JPEG XL, TIFF, BMP, animated PNG/WebP and recognized multi-picture JPEG are not flattened or partially exported. The UI probes the exact native encoder MIME response and disables formats that the current browser cannot produce; header support is never presented as proof that decoding will succeed.
|
||
|
||
Exports are browser-native pixel re-encodes. Source EXIF, XMP, ICC, comments, thumbnails and trailing data are not intentionally copied, but Image Tools is not a privacy verifier. Browser canvas uses an 8-bit working representation and does not preserve arbitrary ICC profiles, HDR precision, original compression, or byte identity. JPEG is lossy; PNG is lossless only relative to the canvas pixels. Browser encoder output can vary.
|
||
|
||
See [Architecture](docs/ARCHITECTURE.md), [Privacy and security](docs/PRIVACY-SECURITY.md), and [Accessibility](docs/ACCESSIBILITY.md).
|
||
|
||
## Development
|
||
|
||
Requires Node.js 22 and npm 11.
|
||
|
||
```sh
|
||
npm ci
|
||
npm run check
|
||
npm run test:browser
|
||
```
|
||
|
||
The tests include generated JPEG/PNG/WebP header fixtures, malformed/over-limit cases, geometry/report unit tests, and full local upload/worker/export flows in Chromium and Firefox.
|
||
|
||
## Release
|
||
|
||
`npm run release:artifact` creates `release/image-tools-0.2.0.zip` and its checksum sidecar after all checks pass.
|
||
|
||
## Licence
|
||
|
||
GPL-3.0-or-later. Runtime dependencies retain their licences; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|