mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-27 01:01:13 +01:00
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# splitting_pro
|
|
|
|
## Description
|
|
A precise segmentation tool that slices a source video into reusable chunks based on positional slicing rules.
|
|
`splitting_pro` allows creators to extract vertical or horizontal bands of the frame, enabling compositing, collage workflows, displacement patterns, and region-based editing.
|
|
|
|
Unlike timeline slicing tools, `splitting_pro` manipulates **spatial** slices of a single frame, carving out portions of the video image for recombination or further processing.
|
|
|
|
## Purpose
|
|
`splitting_pro` is designed for creators who want:
|
|
- spatial slicing rather than temporal cutting,
|
|
- vertical or horizontal extraction of visual regions,
|
|
- inputs for collage, displacement, glitch layering, or geometric composition,
|
|
- deterministic cropping that can be repeated across clips,
|
|
- simple region control with only two parameters.
|
|
|
|
## How It Works
|
|
1. **Define Slice Width**
|
|
The `width` parameter determines how large the slice is (in pixels or proportional units depending on implementation).
|
|
2. **Define Slice Position**
|
|
The `position` parameter determines where the slice begins — allowing sliding-window or fixed-region extraction.
|
|
3. **Spatial Cropping**
|
|
The module extracts that region from every frame, maintaining spatial consistency across the entire clip.
|
|
4. **Output Encoding**
|
|
The slice is encoded using global Videobeaux settings (codec, CRF, pixel format).
|
|
|
|
## Program Template
|
|
```bash
|
|
videobeaux -P splitting_pro \
|
|
-i input.mp4 \
|
|
-o output.mp4 \
|
|
--width VALUE \
|
|
--position VALUE
|
|
```
|
|
|
|
## Arguments
|
|
|
|
- **width** — The thickness of the slice extracted from the frame.
|
|
- **position** — Where the slice begins relative to the frame's coordinate system.
|
|
|
|
## Real World Example
|
|
```bash
|
|
videobeaux -P splitting_pro \
|
|
-i myvideo.mp4 \
|
|
-o splitting_pro_styled.mp4 \
|
|
--width EXAMPLE \
|
|
--position EXAMPLE
|
|
```
|
|
|
|
## Program Output
|
|
_Program output video not yet linked._
|
|
|
|
## Technical Notes
|
|
- Useful for creating moving-window effects when paired with scrolling modules.
|
|
- To extract a centered region, calculate `position` based on `(frame_size - width) / 2`.
|
|
- Thin slices work well for displacement maps and glitch-strip compositions.
|
|
- Slicing can be directional; depending on implementation, `width` may represent horizontal or vertical dimension.
|
|
|
|
## Recommended Usage
|
|
- Split-screen collage layouts.
|
|
- Creating stripe-based glitch effects.
|
|
- Feeding sliced layers into Lagkage for recombination.
|
|
- Region extraction for stylized cropping, masks, or compositing.
|
|
- Generating displacement textures from narrow video bands.
|
|
|
|
## Quality Tips
|
|
- Lower CRF for sharp edges on the sliced boundary.
|
|
- Higher CRF for grittier, more distorted slices.
|
|
- Pair with `blur_pix` for soft-edge slicing.
|
|
- Combine with `scrolling_pro` to animate the sliced region across time.
|
|
- Apply before LUTs for unified grading of sliced material.
|
|
|