blind-gauss-blur.1 - blind - suckless command-line video editing utility
 (HTM) git clone git://git.suckless.org/blind
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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 >