scrolling

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

Description

Applies a continuous scrolling motion to the video by shifting the image over time in a single direction.
Unlike scrolling_pro, which allows multi-axis control, this module provides a simple, fixed-direction scroll effect — ideal for lightweight motion or ambient looping.

Purpose

scrolling is designed for creators who want:

• a minimal, no-parameter scroll effect,
• subtle ambient motion for backgrounds or textures,
• lightweight directional drift without configuration,
• simple kinetic movement for loops or collage layers,
• predictable, consistent scroll behavior.

How It Works

1. Directional Motion
   The video image is translated across the frame at a fixed rate and direction.
2. Wraparound Behavior
   Pixels exiting one side of the frame re-enter from the opposite side, producing an infinite-scroll illusion.
3. Fixed Parameters
   Since the module has no program-specific arguments, its scroll speed and direction are predetermined.
4. Encoding
   Output is encoded using global Videobeaux CRF, codec, and pixel-format settings.

Program Template

videobeaux -P scrolling -i input.mp4 -o output.mp4

Arguments

• (No additional program-specific arguments; uses global videobeaux options only.)

Real World Example

videobeaux -P scrolling \
  -i myvideo.mp4 \
  -o scrolling_styled.mp4

Program Output

Technical Notes

• Because scroll speed is fixed, this module is ideal for simple kinetic backgrounds.
• Looping behavior depends on footage content; pattern-like textures loop more seamlessly.
• Best used when a uniform directional drift is desired without fine-tuning.
• Works cleanly at any resolution or aspect ratio.

Recommended Usage

• Ambient looping textures for projection or VJ systems.
• Background drift behind titles, overlays, or motion graphics.
• Simple motion injection for collage edits.
• Use in batch workflows where consistent, automated scroll is needed.

Quality Tips

• Lower CRF produces smoother scrolling with fewer compression artifacts.
• Slight pre-blur (e.g., via blur_pix) can reduce visible seams in detailed footage.
• Pair with lsd_feedback for evolving drifting effects.
• Combine with overexposed_stutter or nostalgic_stutter for stylized motion disruption.
• Use convert_dims beforehand if preparing platform-specific scrolling backgrounds.