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

66 lines
2.8 KiB
Markdown

# repainting
## Description
Applies an artistic “repainted” effect that makes each frame appear as if it has been smeared, redrawn, or blurred by an alcohol-washed brush.
The result resembles wet ink, soft smudging, streaked pigment, or repeated overpainting — giving the footage a tactile, analog, hand-altered feel.
## Purpose
`repainting` is designed for creators who want:
- a painterly, reworked, or smeared aesthetic,
- a hand-drawn or alcohol-wet look without using frame-by-frame animation,
- soft organic distortion that feels handmade rather than digital,
- degraded yet artistic texture for music videos or collage,
- a simple effect that produces expressive motion smearing.
## How It Works
1. **Frame Reinterpretation**
Each frame is processed as if it were being redrawn or wiped over with semi-wet pigment.
2. **Smudge + Alcohol-Wash Simulation**
Highlights bloom, shadows soften, and edges blur as if dissolved by solvent.
3. **Temporal Softening**
Minor streaks or trailing may appear due to repeated repainting across frames.
4. **Encoding**
Output is encoded using global Videobeaux settings (codec, CRF, pixel format).
## Program Template
```bash
videobeaux -P repainting -i input.mp4 -o output.mp4
```
## Arguments
- *(No additional program-specific arguments; uses global videobeaux options only.)*
## Real World Example
```bash
videobeaux -P repainting \
-i myvideo.mp4 \
-o repainting_styled.mp4
```
## Program Output
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;">
<source src="https://github.com/user-attachments/assets/1770144d-4448-4719-8ef3-e44b720ec857" type="video/mp4">
Your browser does not support the video tag.
</video>
## Technical Notes
- Works especially well on footage with bold shapes, faces, or brush-like motion paths.
- High-contrast imagery yields more pronounced smearing.
- Compression may increase the “wet paint” feel by interacting with soft, blended regions.
- Repainting is non-destructive in timing — cadence stays intact even while textures distort.
## Recommended Usage
- Abstract or painterly music videos.
- Alcohol-ink inspired motion design.
- Narrative moments needing dreamlike or smeared transitions.
- Experimental cinema and visual collage.
- Live VJ loops that benefit from organic, evolving texture.
## Quality Tips
- Lower CRF values maintain smooth, fluid repainted strokes.
- Higher CRF adds grit, giving the effect a rougher, stained appearance.
- Combine with `double_cup` for a liquified wash; combine with `blur_pix` for soft surface blending.
- Apply before LUTs if you want the grade to unify the smear colors; apply after LUTs if you want the smear to distort the grade itself.
- Up-scaling beforehand using `convert_dims` can produce smoother brush-like textures.