photobot.Canvas.flatten()

Syntax

canvas.flatten(layers=[])

Description

Flattens the canvas, merging all layers according to their blend modes and opacities. Once flattened, the stack of layers except for a single flattened layer - canvas.layer(1). Optionally, layers specifies exactly which layers to merge, but you should use the Canvas.merge() command instead. Flattened layers retain any transparency when saved as a .png file with the Canvas.export() command, since the canvas has a transparent background by default. Other options are .jpg and .gif.

Syntax

Flattens a set of layers so it can be exported to a .png image file.

photobot = ximport("photobot")
canvas = photobot.canvas(200,200)
canvas.layer("robot.jpg")
canvas.fill((255,128,0)).hue()
canvas.flatten()
canvas.export("orange-robot.png")