Skip to content

Most visited

Recently visited

navigation

Image.Plane

public static abstract class Image.Plane
extends Object

java.lang.Object
   ↳ android.media.Image.Plane


A single color plane of image data.

The number and meaning of the planes in an Image are determined by the format of the Image.

Once the Image has been closed, any access to the the plane's ByteBuffer will fail.

See also:

Summary

Public methods

abstract ByteBuffer getBuffer()

Get a direct ByteBuffer containing the frame data.

abstract int getPixelStride()

The distance between adjacent pixel samples, in bytes.

abstract int getRowStride()

The row stride for this color plane, in bytes.

Inherited methods

From class java.lang.Object

Public methods

getBuffer

Added in API level 19
ByteBuffer getBuffer ()

Get a direct ByteBuffer containing the frame data.

In particular, the buffer returned will always have isDirect return true, so the underlying data could be mapped as a pointer in JNI without doing any copies with GetDirectBufferAddress.

For raw formats, each plane is only guaranteed to contain data up to the last pixel in the last row. In other words, the stride after the last row may not be mapped into the buffer. This is a necessary requirement for any interleaved format.

Returns
ByteBuffer the byte buffer containing the image data for this plane.

getPixelStride

Added in API level 19
int getPixelStride ()

The distance between adjacent pixel samples, in bytes.

This is the distance between two consecutive pixel values in a row of pixels. It may be larger than the size of a single pixel to account for interleaved image data or padded formats. Note that pixel stride is undefined for some formats such as RAW_PRIVATE, and calling getPixelStride on images of these formats will cause an UnsupportedOperationException being thrown. For formats where pixel stride is well defined, the pixel stride is always greater than 0.

Returns
int

getRowStride

Added in API level 19
int getRowStride ()

The row stride for this color plane, in bytes.

This is the distance between the start of two consecutive rows of pixels in the image. Note that row stried is undefined for some formats such as RAW_PRIVATE, and calling getRowStride on images of these formats will cause an UnsupportedOperationException being thrown. For formats where row stride is well defined, the row stride is always greater than 0.

Returns
int
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.