mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-27 01:01:13 +01:00
86 lines
3.7 KiB
Markdown
86 lines
3.7 KiB
Markdown
# 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
|
||
```bash
|
||
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
|
||
```bash
|
||
videobeaux -P scrolling_pro \
|
||
-i myvideo.mp4 \
|
||
-o scrolling_pro_styled.mp4 \
|
||
--horiz_speed EXAMPLE \
|
||
--vert_speed EXAMPLE
|
||
```
|
||
|
||
## 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/e84cfb49-f72d-449e-833a-0271903704f4" type="video/mp4">
|
||
Your browser does not support the video tag.
|
||
</video>
|
||
|
||
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;">
|
||
<source src="https://github.com/schwwaaa/videobeaux/assets/7625379/19c6eef1-2bc0-4d84-b531-55f9ca07a912" type="video/mp4">
|
||
Your browser does not support the video tag.
|
||
</video>
|
||
|
||
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;">
|
||
<source src="https://github.com/schwwaaa/videobeaux/assets/7625379/4a4272de-e074-4e37-8c2d-a282f2d8be57" type="video/mp4">
|
||
Your browser does not support the video tag.
|
||
</video>
|
||
|
||
## 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.
|
||
|