setRegion

Update the target draw region for rendering. This should be called at least once to initialize the session, and whenever the region changes.

If the region's width or height changed, the underlying hardware render buffer is recreated. This is an expensive operation and should only be done when necessary.

A region with width or height of 0 is treated as a "not renderable" state: the current render buffer is released and subsequent frames are skipped until a non-zero region is set.

For Fit.Layout, size changes also update artboard sizing immediately. To observe the new sizing in rendered output, either beginPlaying must be actively running, or the caller must advance the supplied stateMachine manually (e.g. StateMachine.advance with 0 delta) before drawing.

If only the region position changed, drawing and pointer mapping update without recreation.

Throws