videobeaux

Logo

The friendly multilateral video toolkit built for artists by artists.

View the Project on GitHub schwwaaa/videobeaux

ball_point_pen

Description

Applies a ball-point-pen illustration effect to the input video, simulating hand-drawn line textures, monochrome ink shading, and stylized pen-stroke contrast.
The result evokes sketchbook drawings, technical notebook diagrams, or lo-fi comic-style renderings.

Purpose

ball_point_pen is intended for artists who want to:

How It Works

  1. Edge Extraction
    The effect identifies major contours and turns them into pen-like strokes.
  2. Ink Shading Simulation
    Midtones and shadows are reinterpreted as sparse or dense ink hatching.
  3. Monochrome / Limited Palette Rendering
    The image is reduced to a pen-like tonal range, often high-contrast and desaturated.
  4. Encoding
    The processed frames are written using global Videobeaux output settings (codec, CRF, pixel format).

Program Template

videobeaux -P ball_point_pen \
  -i input.mp4 \
  -o output.mp4

Arguments

Real World Example

videobeaux -P ball_point_pen \
  -i myvideo.mp4 \
  -o ball_point_pen_styled.mp4

Program Output

Technical Notes

Quality Tips