probe

Read data's header and report what it says: dimensions, bit depth, declared alpha, animation frame count, EXIF orientation, and whether this build can decode it. No pixels are decoded and no image-sized buffer is allocated, so this stays cheap on a 50 MP file.

Use it to size a layout before the decode, to reject hostile uploads by dimension, or to decide whether to claim a file at all.

Throws