ImageReader
원문(레퍼런스)The ImageReader class allows direct application access to image data rendered into a Surface
ImageReader 클래스는 Surface에 렌더링된 이미지 데이터에 직접 어플리케이션 레벨에서 접근 가능하게 합니다.
Several Android media API classes accept Surface objects as targets to render to, including MediaPlayer, MediaCodec, CameraDevice, ImageWriter and RenderScript Allocations. The image sizes and formats that can be used with each source vary, and should be checked in the documentation for the specific API.
몇몇 안드로이드 미디어 API 클래스 (MediaPlayer, MediaCodec, CameraDevice, ImageWriter, RenderScript)는 Surface 객체를 렌더링 대상으로 사용합니다. 이미지의 크기와 포맷은 각각의 소스 마다 다르게 사용되기 때문에, 각각 API의 문서를 체크해주세요.
The image data is encapsulated in Image objects, and multiple such objects can be accessed at the same time, up to the number specified by the maxImages constructor parameter. New images sent to an ImageReader through its Surface are queued until accessed through the acquireLatestImage() or acquireNextImage() call. Due to memory limits, an image source will eventually stall or drop Images in trying to render to the Surface if the ImageReader does not obtain and release Images at a rate equal to the production rate.
이미지 데이터는 Image 객체에 캡슐화 되어있으며, 동시에 다수의 이미지 객체에 접근할 수 있습니다. 접근할 이미지의 수는 생성자의 maxImages 매개변수에 지정합니다. ImageReader 에 보낸 새로운 Image 는 acquireLatestImage()나 acquireNextImage()로 호출될 때까지 ImageReader의 Surface 큐에 들어가게 됩니다. 메모리의 제한이 있기 때문에, ImageReader가 생성 속도와 동일한 비율로 이미지를 가져 오거나 해제하지 않으면 이미지 소스가 Surface에 렌더링하려고 시도하는 Image 객체를 중지시키거나 버리게 됩니다.
newInstance
지정된 크기와 포맷의 이미지를 읽는 ImageReader를 만든다.public static ImageReader newInstance (int width, int height, int format, int maxImages)
maxImages : ImageReader가 동시에 가져올 수 있는 Image 객체의 최대 개수.
버퍼를 더 많이 요청하면 더 많은 메모리가 소모되므로 필요한 만큼 사용하는 것이 중요합니다.
유효한 크기와 포맷은 원본 이미지 데이터에 따라 다릅니다.
만약 포맷이 ImageFormat#PRIVATE 라면, 만들어진 ImageReader는 어플리케이션에서 직접 접근할 수 없는 이미지를 만들어냅니다. 어플리케이션에서 이 ImageReader를 통해서 이미지를 얻을 수 있고, ImageWriter 인터페이스를 통해서 재처리하도록 카메라로 전송할 수 있습니다. 하지만 Image#getPlanes() 는 ImageFormat#PRIVATE 포맷에 대해서는 빈 배열을 리턴합니다. 어플리케이션에서 getImageFormat을 호출해서 ImageReader의 포맷을 확인할 수 있습니다.
이미지 데이터에 접근하는 것이 불필요할 때에는 ImageFormat#PRIVATE 포맷의 ImageReader는 더욱 효율적입니다.