Documentation is work in progress and not completeEditor
Images

Performance Guidelines for Images

Image Resolution

Match source resolution to canvas usage. Images larger than necessary for their canvas role consume memory without contributing visible quality.

Canvas Usage SizeRecommended Source Resolution
Full 4K canvas backgroundUp to 3840 x 2160
Full HD canvas backgroundUp to 1920 x 1080
Half-canvas elementApprox. 960 x 540
Small icon or decorationApprox. 256 x 256
Tiny element (under 100px wide)Approx. 200 x 200

Format Choice

FormatBest Use
WebPRecommended for all images. Best size/quality ratio.
PNGRequired only when lossless quality or alpha transparency is critical
JPEGAcceptable for photographic images without transparency requirements

Images in Animation

Performance characteristics vary significantly depending on what is animated:

  • -Low cost: Animating position and rotation on images is low-cost. The renderer uses cached image data and only recalculates compositing.
  • -High cost: Animating blur radius, warp mesh points, or distortion effects is high-cost. Each animated frame requires a full filter recalculation.
  • -For animations with multiple simultaneous image elements, disable filter stacks on non-hero images during editing preview — use the filter visibility toggle, then re-enable before export.
  • -Consider working at 720p canvas resolution during animation authoring and scaling up to 1080p or 4K at export time.