Files
videobeaux/docs/programs/effects/scrolling.md
2025-12-07 22:04:44 -05:00

2.7 KiB

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.
  • 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.