HardwareBufferJni


@ExperimentalApi
class HardwareBufferJni : HardwareBufferJniWrapper


JNI methods for HardwareBuffer interaction and native ByteBuffer queries in libmedia3EffectJNI.

Summary

Constants

const HardwareBufferJni!

Public functions

native Boolean
@RequiresApi(value = 26)
nativeBindEGLImage(target: Int, eglImageHandle: Long)

Binds an EGLImage to the specified texture target.

native Boolean

Copies a Bitmap to a HardwareBuffer.

native Boolean

Copies the contents of a source HardwareBuffer to a destination HardwareBuffer.

native Long
@RequiresApi(value = 26)
nativeCreateEglImageFromHardwareBuffer(
    displayHandle: Long,
    hardwareBuffer: HardwareBuffer!
)

Creates an EGLImage from a HardwareBuffer.

native Boolean
@RequiresApi(value = 26)
nativeDestroyEGLImage(displayHandle: Long, imageHandle: Long)

Destroys an EGLImage.

native Boolean
nativeIsNv21(uBuffer: ByteBuffer!, vBuffer: ByteBuffer!)

Returns whether a semi-planar YUV frame's chroma planes are in NV21 order.

Inherited functions

From androidx.media3.common.video.HardwareBufferNativeHelpers
abstract Boolean

Copies the contents of a source HardwareBuffer to a destination HardwareBuffer.

Constants

INSTANCE

const val INSTANCE: HardwareBufferJni!

Public functions

nativeBindEGLImage

@RequiresApi(value = 26)
native fun nativeBindEGLImage(target: Int, eglImageHandle: Long): Boolean

Binds an EGLImage to the specified texture target. Returns whether the binding is successful.

nativeCopyBitmapToHardwareBuffer

@RequiresApi(value = 26)
native fun nativeCopyBitmapToHardwareBuffer(bitmap: Bitmap!, hb: HardwareBuffer!): Boolean

Copies a Bitmap to a HardwareBuffer. Returns whether the copy is successful.

The destination HardwareBuffer must have USAGE_CPU_WRITE_OFTEN usage.

The source Bitmap.Config must match the destination getFormat, and be either ARGB_8888 and RGBA_8888 or RGBA_1010102 and RGBA_1010102.

nativeCopyHardwareBufferToHardwareBuffer

@RequiresApi(value = 26)
native fun nativeCopyHardwareBufferToHardwareBuffer(
    srcHb: HardwareBuffer!,
    dstHb: HardwareBuffer!
): Boolean

Copies the contents of a source HardwareBuffer to a destination HardwareBuffer. Returns whether the copy is successful.

The source HardwareBuffer must have USAGE_CPU_READ_OFTEN usage, and the destination HardwareBuffer must have USAGE_CPU_WRITE_OFTEN usage.

The formats of the source and destination buffers must match, and be either RGBA_8888 or RGBA_1010102.

nativeCreateEglImageFromHardwareBuffer

@RequiresApi(value = 26)
native fun nativeCreateEglImageFromHardwareBuffer(
    displayHandle: Long,
    hardwareBuffer: HardwareBuffer!
): Long

Creates an EGLImage from a HardwareBuffer.

nativeDestroyEGLImage

@RequiresApi(value = 26)
native fun nativeDestroyEGLImage(displayHandle: Long, imageHandle: Long): Boolean

Destroys an EGLImage. Returns whether the deletion is successful.

nativeIsNv21

native fun nativeIsNv21(uBuffer: ByteBuffer!, vBuffer: ByteBuffer!): Boolean

Returns whether a semi-planar YUV frame's chroma planes are in NV21 order.

uBuffer and vBuffer must be directByteBuffer views of the same interleaved chroma memory, starting 1 byte apart (with uBuffer first for NV12 and vBuffer first for NV21). If either buffer is not a direct ByteBuffer or the buffers are not views of the same interleaved chroma memory, the return value is undefined.