Background layers (bgLayers)

#What they are

bgLayers is an array painted after the primary background (colorBg / gradientBg / customBg / videoBg or transparent base), before patternBg and noiseBg.

Order: index 0 = bottom, last index = top.

#Allowed type values

Every layer may include opacity and blendMode (GlobalCompositeOperation).

#Example — tint + grain

1await painter.createCanvas({2  width: 1080,3  height: 1080,4  colorBg: '#1e1b4b',5  bgLayers: [6    { type: 'noise', intensity: 0.05, blendMode: 'overlay' },7    {8      type: 'presetPattern',9      pattern: {10        type: 'dots',11        color: '#c7d2fe',12        opacity: 0.15,13        size: 8,14        spacing: 24,15      },16      blendMode: 'soft-light',17    },18  ],19});

#Validation errors

createCanvas validates each layer:

• type must be one of the allowed strings.
• color layers need string value.
• gradient layers need value.type.
• image / pattern need non-empty source string.
• presetPattern needs pattern object with type string.
• noise intensity must be 0–1 if set.