videobeaux/docs/programs/effects/splitting_pro.md

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

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

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.