TextOverlay

Kotlin |Java

@UnstableApi
public abstract class TextOverlay extends BitmapOverlay

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

Creates a TextureOverlay from text.

Uses a SpannableString to store the text and support advanced per-character text styling.

Summary

Constants
`static final int`	`TEXT_SIZE_PIXELS = 100`

Public constructors
`TextOverlay()`

Public methods
`static TextOverlay`	`createStaticTextOverlay(SpannableString overlayText)` Creates a `TextOverlay` that shows the `overlayText` with the same default settings in `StaticOverlaySettings` throughout the whole video.
`static TextOverlay`	`createStaticTextOverlay( SpannableString overlayText, StaticOverlaySettings overlaySettings )` Creates a `TextOverlay` that shows the `overlayText` with the same `StaticOverlaySettings` throughout the whole video.
`Bitmap`	`getBitmap(long presentationTimeUs)` Returns the overlay bitmap displayed at the specified timestamp.
`abstract SpannableString`	`getText(long presentationTimeUs)` Returns the overlay text 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 static final int TEXT_SIZE_PIXELS = 100

public TextOverlay()

public static TextOverlay createStaticTextOverlay(SpannableString overlayText)

Creates a TextOverlay that shows the overlayText with the same default settings in StaticOverlaySettings throughout the whole video.

public static TextOverlay createStaticTextOverlay(
    SpannableString overlayText,
    StaticOverlaySettings overlaySettings
)

Creates a TextOverlay that shows the overlayText with the same StaticOverlaySettings throughout the whole video.

Parameters
`SpannableString overlayText`	The text to overlay on the video.
`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 SpannableString getText(long presentationTimeUs)

Returns the overlay text displayed at the specified timestamp.

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