videobeaux/docs/programs/effects/scrolling_pro.md

scrolling_pro

:contentReference[oaicite:1]{index=1}

Description

Applies a continuous scrolling effect to the video, allowing the image to move horizontally, vertically, or in both directions simultaneously.
This module is ideal for generating drifting motion, conveyor-like movement, kinetic wallpaper loops, and directional flow effects.

Purpose

scrolling_pro is designed for creators who want:

• seamless directional movement for loops or backgrounds,
• kinetic motion overlays in collage or compositing workflows,
• horizontal, vertical, or diagonal drifting of footage,
• a simple way to generate infinite-scroll–style visuals,
• controllable speed for gentle drift or aggressive motion.

How It Works

1. Coordinate Translation
   Each frame is shifted on the X and/or Y axis according to the defined scroll speeds.
2. Continuous Wraparound
   As the image scrolls, pixels exiting one side re-enter from the opposite side, creating an infinite looping illusion.
3. Directional Combination
   Horizontal and vertical speeds can be combined, creating diagonal or complex drift patterns.
4. Encoding
   Output is then encoded using Videobeaux global settings (codec, CRF, pixel format).

Program Template

videobeaux -P scrolling_pro \
  -i input.mp4 \
  -o output.mp4 \
  --horiz_speed VALUE \
  --vert_speed VALUE

Arguments

• horiz_speed — Horizontal scrolling speed. Positive = scroll right; negative = scroll left.
• vert_speed — Vertical scrolling speed. Positive = scroll down; negative = scroll up.

Real World Example

videobeaux -P scrolling_pro \
  -i myvideo.mp4 \
  -o scrolling_pro_styled.mp4 \
  --horiz_speed EXAMPLE \
  --vert_speed EXAMPLE

Program Output

Technical Notes

• Large scroll speeds may produce rapid motion suitable for glitch or kinetic graphics.
• Small scroll speeds create subtle drifting backgrounds or ambient wallpaper loops.
• Because wraparound is seamless, the effect is ideal for loops when combined with looper_pro.
• Diagonal motion is achieved when both speeds are non-zero.
• Higher-resolution footage yields smoother scroll texture, especially for slow motion.

Recommended Usage

• VJ loops and projection mapping backgrounds.
• Infinite-scroll ambience for installations or screensavers.
• Graphic overlays behind text or UI elements.
• Creating drifting collage components inside Lagkage layouts.
• Building kinetic transitions between scenes.

Quality Tips

• Use lower CRF for cleaner scroll edges, especially with detailed textures.
• Slight blur (e.g., via blur_pix) before scrolling can remove hard seams in loop textures.
• Combine with double_cup or lsd_feedback for trippy drifting effects.
• Slow speeds often look more cinematic; fast speeds suit glitch or techno edits.
• Apply convert_dims first if you need scroll-safe aspect ratios for looping platforms.