mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-25 08:11:11 +01:00
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
# 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
|
|
```bash
|
|
videobeaux -P scrolling -i input.mp4 -o output.mp4
|
|
```
|
|
|
|
## Arguments
|
|
- *(No additional program-specific arguments; uses global videobeaux options only.)*
|
|
|
|
## Real World Example
|
|
```bash
|
|
videobeaux -P scrolling \
|
|
-i myvideo.mp4 \
|
|
-o scrolling_styled.mp4
|
|
```
|
|
|
|
## Program Output
|
|
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;">
|
|
<source src="https://github.com/schwwaaa/videobeaux/assets/7625379/4cdebccc-8519-45c6-aded-089db73d20d2" type="video/mp4">
|
|
Your browser does not support the video tag.
|
|
</video>
|
|
|
|
## 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.
|
|
|