ListenableCanvasRenderer

Artifact: androidx.wear.watchface:watchface-guava

Added in 1.0.0

Deprecated in 1.1.0

Kotlin |Java

public abstract class ListenableCanvasRenderer extends Renderer.CanvasRenderer

java.lang.Object
↳	androidx.wear.watchface.Renderer
	↳	androidx.wear.watchface.Renderer.CanvasRenderer
		↳	androidx.wear.watchface.ListenableCanvasRenderer

ListenableFuture-based compatibility wrapper around Renderer.CanvasRenderer's suspending methods.

Summary

Public constructors
`ListenableCanvasRenderer( @NonNull SurfaceHolder surfaceHolder, @NonNull CurrentUserStyleRepository currentUserStyleRepository, @NonNull WatchState watchState, int canvasType, @IntRange(from = 0, to = 60000) long interactiveDrawModeUpdateDelayMillis, boolean clearWithBackgroundTintBeforeRenderingHighlightLayer )` This method is deprecated. Use ListenableCanvasRenderer2 instead

Public methods
`void`	`init()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`@NonNull ListenableFuture<Unit>`	`@UiThread initFuture()` This method is deprecated. Use ListenableCanvasRenderer2 instead

Inherited methods

From androidx.wear.watchface.Renderer

`final @NonNull Collection<@NonNull Pair<@NonNull Integer, @NonNull ContentDescriptionLabel>>`	`getAdditionalContentDescriptionLabels()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final float`	`getCenterX()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final float`	`getCenterY()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final long`	`getInteractiveDrawModeUpdateDelayMillis()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`@NonNull Rect`	`@UiThread getMainClockElementBounds()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final @NonNull RenderParameters`	`getRenderParameters()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final @NonNull Rect`	`getScreenBounds()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final @NonNull SurfaceHolder`	`getSurfaceHolder()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final WatchFaceColors`	`@WatchFaceExperimental getWatchfaceColors()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`@UiThread invalidate()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`void`	`@UiThread onDestroy()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`void`	`@UiThread onRenderParametersChanged(@NonNull RenderParameters renderParameters)` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`postInvalidate()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`sendPreviewImageNeedsUpdateRequest()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`setAdditionalContentDescriptionLabels( @NonNull Collection<@NonNull Pair<@NonNull Integer, @NonNull ContentDescriptionLabel>> additionalContentDescriptionLabels )` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`setInteractiveDrawModeUpdateDelayMillis( long interactiveDrawModeUpdateDelayMillis )` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`setSurfaceHolder(@NonNull SurfaceHolder surfaceHolder)` This method is deprecated. Use ListenableCanvasRenderer2 instead
`final void`	`@WatchFaceExperimental setWatchfaceColors( @WatchFaceExperimental WatchFaceColors watchfaceColors )` This method is deprecated. Use ListenableCanvasRenderer2 instead
`boolean`	`@UiThread shouldAnimate()` This method is deprecated. Use ListenableCanvasRenderer2 instead

From androidx.wear.watchface.Renderer.CanvasRenderer

`final boolean`	`getClearWithBackgroundTintBeforeRenderingHighlightLayer()` This method is deprecated. Use ListenableCanvasRenderer2 instead
`void`	`onDump(@NonNull PrintWriter writer)` This method is deprecated. Use ListenableCanvasRenderer2 instead
`abstract void`	`@UiThread render( @NonNull Canvas canvas, @NonNull Rect bounds, @NonNull ZonedDateTime zonedDateTime )` This method is deprecated. Use ListenableCanvasRenderer2 instead
`abstract void`	`@UiThread renderHighlightLayer( @NonNull Canvas canvas, @NonNull Rect bounds, @NonNull ZonedDateTime zonedDateTime )` This method is deprecated. Use ListenableCanvasRenderer2 instead

Public constructors

ListenableCanvasRenderer

Added in 1.1.0

Deprecated in 1.1.0

public ListenableCanvasRenderer(
    @NonNull SurfaceHolder surfaceHolder,
    @NonNull CurrentUserStyleRepository currentUserStyleRepository,
    @NonNull WatchState watchState,
    int canvasType,
    @IntRange(from = 0, to = 60000) long interactiveDrawModeUpdateDelayMillis,
    boolean clearWithBackgroundTintBeforeRenderingHighlightLayer
)

Public methods

init

Added in 1.0.0

Deprecated in 1.1.0

public void init()

Perform UiThread specific initialization. Will be called once during initialization before any subsequent calls to render. If you need to override this method in java, consider using androidx.wear.watchface.ListenableCanvasRenderer instead.

initFuture

Added in 1.0.0

Deprecated in 1.1.0

@UiThread
public @NonNull ListenableFuture<Unit> initFuture()

Perform UiThread specific initialization. Will be called once during initialization before any subsequent calls to render. Note cancellation of the returned future is not supported.

Returns
`@NonNull ListenableFuture<Unit>`	A ListenableFuture which is resolved when UiThread has completed. Rendering will be blocked until this has resolved.