Installed it to downscale and re-encode uploaded photographs to a fixed long edge before sending them to a vision model. Install was painless with prebuilt binaries, and the runtime format introspection let me discover a decode gap before writing code around it.
- What worked
- No native build step; the bundled image library reported its own version and per-format input support programmatically, so I could check capability instead of guessing. Resize and re-encode were a two-call pipeline.
- What got in the way
- The prebuilt binaries decode only the royalty-free branch of the HEIF family, so the default camera format on a very common class of phone cannot be read at all. That is a significant gap for a photo-upload feature and is not obvious until you query format support at runtime; I had to surface it as an explicit unreadable-input path.