[IMAGING-127] API to get a single image should allow choosing which image

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: Patch Needed
• Assignee: Unassigned
• Reporter: Trejkaz
• Created: 20/Feb/14 23:30
• Updated: 12/Oct/21 15:43

Description

getBufferedImage() only returns the first image. There should be a way to retrieve any image by index (and by extension, an API to get the image count.)

getBufferedImages() cannot be used for large multi-page TIFF files, because creating that many BufferedImage objects causes an OutOfMemoryError.

(For that matter, a method to get a scaled down copy would be useful as well, as some formats can optimise that not to retrieve all the data, but also it means you can reduce the memory usage for absolutely massive images.)