mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-24 15:51:10 +01:00
2.7 KiB
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
- Directional Motion
The video image is translated across the frame at a fixed rate and direction. - Wraparound Behavior
Pixels exiting one side of the frame re-enter from the opposite side, producing an infinite-scroll illusion. - Fixed Parameters
Since the module has no program-specific arguments, its scroll speed and direction are predetermined. - 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_feedbackfor evolving drifting effects. - Combine with
overexposed_stutterornostalgic_stutterfor stylized motion disruption. - Use
convert_dimsbeforehand if preparing platform-specific scrolling backgrounds.