DrawableOverlay

Kotlin |Java

@UnstableApi
public abstract class DrawableOverlay extends BitmapOverlay

java.lang.Object
↳	androidx.media3.effect.TextureOverlay
	↳	androidx.media3.effect.BitmapOverlay
		↳	androidx.media3.effect.DrawableOverlay

Uses a canvas to draw DrawableOverlay onto BitmapOverlay, which is then displayed on each frame.

Summary

Public constructors
`DrawableOverlay()`

Public methods
`static DrawableOverlay`	`createStaticDrawableOverlay( Drawable drawable, StaticOverlaySettings overlaySettings )` Creates a `DrawableOverlay` that shows the `Drawable` with the same `StaticOverlaySettings` throughout the whole video.
`Bitmap`	`getBitmap(long presentationTimeUs)` Returns the overlay bitmap displayed at the specified timestamp.
`abstract Drawable`	`getDrawable(long presentationTimeUs)` Returns the overlay `Drawable` displayed at the specified timestamp.

`static BitmapOverlay`	`createStaticBitmapOverlay(Bitmap overlayBitmap)` Creates a `BitmapOverlay` that shows the `overlayBitmap` in the same position and size throughout the whole video.
`static BitmapOverlay`	`createStaticBitmapOverlay( Bitmap overlayBitmap, StaticOverlaySettings overlaySettings )` Creates a `BitmapOverlay` that shows the `overlayBitmap` in the same `OverlaySettings` throughout the whole video.
`static BitmapOverlay`	`createStaticBitmapOverlay( Context context, Uri overlayBitmapUri, StaticOverlaySettings overlaySettings )` Creates a `BitmapOverlay` that shows the input at `overlayBitmapUri` with the same `StaticOverlaySettings` throughout the whole video.
`int`	`getTextureId(long presentationTimeUs)` Returns the overlay texture identifier displayed at the specified timestamp.
`Size`	`getTextureSize(long presentationTimeUs)` Returns the pixel width and height of the overlay texture displayed at the specified timestamp.
`float[]`	`getVertexTransformation(long presentationTimeUs)` Returns a 4x4 OpenGL matrix, controlling how the vertices of the overlay are displayed at the specified timestamp.
`void`	`release()` Releases all resources.

`void`	`configure(Size videoSize)` Set up resources for the overlay given the input video’s dimensions.
`OverlaySettings`	`getOverlaySettings(long presentationTimeUs)` Returns the `OverlaySettings` controlling how the overlay is displayed at the specified timestamp.

public DrawableOverlay()

public static DrawableOverlay createStaticDrawableOverlay(
    Drawable drawable,
    StaticOverlaySettings overlaySettings
)

Creates a DrawableOverlay that shows the Drawable with the same StaticOverlaySettings throughout the whole video.

Parameters
`Drawable drawable`	The `Drawable` to be displayed.
`StaticOverlaySettings overlaySettings`	The `StaticOverlaySettings` configuring how the overlay is displayed on the frames.

public Bitmap getBitmap(long presentationTimeUs)

Returns the overlay bitmap displayed at the specified timestamp.

Parameters
`long presentationTimeUs`	The presentation timestamp of the current frame, in microseconds.

Throws
`androidx.media3.common.VideoFrameProcessingException`	If an error occurs while processing or drawing the frame.

public abstract Drawable getDrawable(long presentationTimeUs)

Returns the overlay Drawable displayed at the specified timestamp.

The drawable must have its bounds set via setBounds for drawable to be displayed on the frame.

Parameters
`long presentationTimeUs`	The presentation timestamp of the current frame, in microseconds.