MultiCanvas

A MultiCanvas allows you to have multiple canvases one on top of the other. This is very useful when you need multiple layers that don't have the same update frequency (e.g. if you make a Tetris game you might only want to render the background image once, and never draw it again).

In [1]:
from ipycanvas import MultiCanvas
In [2]:
m = MultiCanvas(n_canvases=3, width=200, height=200, sync_image_data=True)
In [3]:
m
In [4]:
def draw_square(canvas, pos, width, color):
    canvas.fill_style = color
    canvas.fill_rect(pos, pos, width, width)

Drawing on each canvas layer successively

In [7]:
draw_square(m[0], 0, 200, 'orange')
draw_square(m[1], 50, 100, 'blue')
draw_square(m[2], 75, 50, 'green')

Drawing on the entire background canvas won't clear the upper layers

In [6]:
draw_square(m[0], 0, 200, 'red')

Clearing the middle canvas won't clear the upper layer

In [ ]:
m[1].clear()
In [ ]:
draw_square(m[0], 0, 200, 'orange')
In [ ]: