Skip to content

Onion Skin

Turn on onion skin for a GIF or video when you need to compare nearby frames against the current frame. ArtDeck shows those frames as transparent ghosts over the media item.

Onion skin settings panel open beside a video on the canvas, showing frame-count steppers, opacity controls, and color swatches.

Select a GIF or video, then toggle Onion Skin from the control bar.

Open the onion skin settings panel for full control:

SettingDescription
Difference ModeShow only pixel differences between frames
Before FramesNumber of previous frames to show (0–5)
After FramesNumber of upcoming frames to show (0–5)
Frame StepGap between ghost frames (1–10)
ColorsColor tint per direction (8 swatches + no-tint)
OpacityLinked or independent per direction (5–100%)
FalloffSharpness of ghost fade-out

For videos, onion skin applies adaptive caps during playback to maintain smooth frame delivery. The settings panel shows the applied values separately from your requested values when a cap is active.

  • Applied vs. requested: When playback caps are active, the panel displays both the values you requested and the lower values actually used (shown in orange).
  • Decode resolution: The panel shows the effective decode resolution used for onion frames during playback (for example, “Effective decode: 960×540”).
  • Loading progress: A “Playback ghosts ready: N/M” line tracks how many frames are prepared for smooth playback.
  • Force Requested During Playback: Bypasses adaptive caps and uses your exact requested values. This toggle appears only when a cap is active or already overridden. Higher settings can reduce playback stability.
  • Orange-dot cap indicator: When playback is capped, the gear button in the control bar shows a small orange dot. The gear icon also spins while frames are loading.

Note: Adaptive cap diagnostics and the Force Requested toggle are only relevant for videos. GIF onion skin is not capped.

With many ghost frames at high resolution, memory usage increases. A warning appears when the configuration approaches device limits.

If playback stutters or the warning appears:

  1. Reduce Before Frames and After Frames.
  2. Increase Frame Step so fewer ghosts are decoded.
  3. Lower Opacity or turn off Difference Mode if you only need a quick comparison.
  4. Leave Force Requested During Playback off unless you need exact requested values for a still frame check.