# NodeBox

Create visual output with Python programming code
Home Download Reference Tutorial Library Gallery About

# 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")