Documentation for this section has not yet been entered.
Type Reason Java.Lang.IllegalStateException if maxImages images are currently acquired
Acquire the next Image from the ImageReader's queue. Returns null if no new image is available.
Warning: Consider using ImageReader.AcquireLatestImage instead, as it will automatically release older images, and allow slower-running processing routines to catch up to the newest frame. Usage of ImageReader.AcquireNextImage is recommended for batch/background processing. Incorrectly using this function can cause images to appear with an ever-increasing delay, followed by a complete stall where no new images seem to appear.
This operation will fail by throwing an Java.Lang.IllegalStateException if maxImages have been acquired with ImageReader.AcquireNextImage or ImageReader.AcquireLatestImage. In particular a sequence of ImageReader.AcquireNextImage or ImageReader.AcquireLatestImage calls greater than ImageReader.MaxImages without calling Image.Close in-between will exhaust the underlying queue. At such a time, Java.Lang.IllegalStateException will be thrown until more images are released with Image.Close.