blind

suckless command-line video editing utility
git clone git://git.suckless.org/blind
Log | Files | Refs | README | LICENSE

blind-gauss-blur.1 (2161B)


      1 .TH BLIND-GAUSS-BLUR 1 blind
      2 .SH NAME
      3 blind-gauss-blur - Apply Gaussian blur to a video
      4 .SH SYNOPSIS
      5 .B blind-gauss-blur
      6 [-j
      7 .IR jobs ]
      8 [-s
      9 .I spread
     10 |
     11 -s
     12 .RB ' auto ']
     13 [-acghvy]
     14 .I sd-stream
     15 .SH DESCRIPTION
     16 .B blind-gauss-blur
     17 reads a video from stdin and a mask video from
     18 .IR sd-stream .
     19 The video is printed to stdout, with all pixels are
     20 blurred using Gaussian blur with a standard
     21 deviation calculated for each pixel individually.
     22 The standard deviation is calculated by multiplying
     23 the X, Y, or Z value with the alpha value of the
     24 corresponding pixel and frame in
     25 .IR sd-stream .
     26 The X value is used when blurring the X channel,
     27 and analogously for Y and Z. If the standard
     28 deviation is 0, the pixel is not blurred.
     29 .P
     30 If stdin is longer than
     31 .IR sd-stream ,
     32 the remainder of stdin is printed without any changes.
     33 If stdin is shorter than
     34 .IR sd-stream ,
     35 the remainder of
     36 .I sd-stream
     37 is ignored but may be partially read.
     38 .SH OPTIONS
     39 .TP
     40 .B -a
     41 Used to optimise performance if it is known that
     42 the video is opaque, and to ensure that the output
     43 video is opaque.
     44 .TP
     45 .B -c
     46 Blur the chroma only, not the luma.
     47 .TP
     48 .B -g
     49 Add glow effect.
     50 .TP
     51 .B -h
     52 Blur horizontally only. Has no affect if -v is also
     53 specified.
     54 .TP
     55 .BR -j " "\fIjobs\fP
     56 Process the video in parallel, using
     57 .I jobs
     58 processes.
     59 .TP
     60 .BR -s " "\fIspread\fP
     61 Pixels with Manhattan distances exceeding
     62 .I spread
     63 shall not affect each other. If
     64 .RB ' auto '
     65 is specified, this value is calculated from
     66 the standard deviation used to blir a pixel.
     67 If -s is not used, there will not be
     68 distance limit.
     69 .TP
     70 .B -v
     71 Blur vertically only. Has no affect if -h is also
     72 specified.
     73 .TP
     74 .B -y
     75 Use the Y value (multiplied by the alpha value) from
     76 .I sd-stream
     77 as the standard deviation all channels.
     78 .SH REQUIREMENTS
     79 .B blind-gauss-blur
     80 requires enough free memory to load three full frames into
     81 memory. A frame requires 32 bytes per pixel it contains. If
     82 .B -g
     83 is used, four full frames are required.
     84 .SH SEE ALSO
     85 .BR blind (7),
     86 .BR blind-single-colour (1),
     87 .BR blind-time-blur (1),
     88 .BR blind-make-kernel (1),
     89 .BR blind-kernel (1),
     90 .BR blind-apply-kernel (1)
     91 .SH AUTHORS
     92 Mattias Andrée
     93 .RI < maandree@kth.se >