createImageSurface

fun createImageSurface(width: Int, height: Int): RiveSurface

Create an off-screen image surface for rendering to a buffer.

⚠️ The returned surface must be closed when no longer needed.

Uses the concrete render context to create an appropriate surface for the backend.

Return

A RiveSurface that can be used for off-screen rendering.

Parameters

width

The width of the image surface in pixels.

height

The height of the image surface in pixels.

Throws

If width or height is not positive.

If the backend cannot create an off-screen surface.

If this command queue has been released.