blind

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

blind-kernel.1 (3099B)


      1 .TH BLIND-KERNEL 1 blind
      2 .SH NAME
      3 blind-kernel - Create a convolution matrix
      4 .SH SYNOPSIS
      5 .B blind-kernel
      6 [-xyza]
      7 .I kernel
      8 .RI [ parameter ]\ ...
      9 .SH DESCRIPTION
     10 .B blind-kernel
     11 creates a convolution matrix that can be applied to
     12 a video using
     13 .BR blind-apply-kernel (1).
     14 The convolution matrix is created from a set
     15 of standard formulae. The formula is selected
     16 using the
     17 .I kernel
     18 argument and is tuned with
     19 .IR kernel -specific
     20 .IR parameter s.
     21 .SH KERNELS
     22 .TP
     23 .RI ' \fBbox\ blur\fP '\ [-w\  weight ]\ [ spread \ |\  x-spread \  y-spread ]
     24 Creates a box blur kernel. Unless
     25 .B -w
     26 is used, the kernel is unweighted, otherwise it has the specified
     27 .IR weight .
     28 The kernel will have the spread 1, the specified
     29 .IR spread ,
     30 or
     31 .I x-spread
     32 as the horizontal spread and
     33 .I y-spread
     34 as the vertical spread.
     35 .TP
     36 .BR emboss \ [\fIdirection\fP]
     37 Create an emboss kernel with the specified
     38 .IR direction .
     39 The
     40 .I direction
     41 must be
     42 .BR N ;
     43 .BR NW
     44 or
     45 .BR WN ;
     46 .BR W ;
     47 .BR SW
     48 or
     49 .BR WS ;
     50 .BR S ;
     51 .BR SE
     52 or
     53 .BR ES ;
     54 .BR E ;
     55 .BR NE
     56 or
     57 .BR EN .
     58 If no
     59 .I direction
     60 is specified,
     61 .B SE
     62 is used.
     63 .TP
     64 .RI \fBgaussian\fP\ [-s\  spread ]\ [-g\ |\ -u]\  standard-deviation
     65 Creates a Gaussian blur kernel with the standard deviation
     66 .IR standard-deviation .
     67 If
     68 .B -u
     69 is used, the a Gaussian unsharpen kernel is created.
     70 If
     71 .B -g
     72 is used, the a Gaussian blur kernel with glow effect is created.
     73 If
     74 .B -s
     75 is specified, the specified
     76 .I spread
     77 will be used, otherwise the spread will be selected automatically.
     78 .TP
     79 .BI gradient\  direction
     80 Create a gradient detection kernel with the specified
     81 .IR direction .
     82 The
     83 .I direction
     84 must be
     85 .BR N ;
     86 .BR NW
     87 or
     88 .BR WN ;
     89 .BR W ;
     90 .BR SW
     91 or
     92 .BR WS ;
     93 .BR S
     94 or
     95 .BR H ;
     96 .BR SE
     97 or
     98 .BR ES ;
     99 .BR E
    100 or
    101 .BR V ;
    102 .BR NE
    103 or
    104 .BR EN .
    105 .TP
    106 .BI kirsch\  direction
    107 Create a Kirsch kernel with the specified
    108 .IR direction .
    109 The
    110 .I direction
    111 must be
    112 .B 1
    113 or
    114 .BR N ;
    115 .BR 2 ,
    116 .BR NW ,
    117 or
    118 .BR WN ;
    119 .BR 3
    120 or
    121 .BR W ;
    122 .BR 4 ,
    123 .BR SW ,
    124 or
    125 .BR WS ;
    126 .BR 5
    127 or
    128 .BR S ;
    129 .BR 6 ,
    130 .BR SE ,
    131 or
    132 .BR ES ;
    133 .BR 7
    134 or
    135 .BR E ;
    136 or
    137 .BR 8 ,
    138 .BR NE ,
    139 or
    140 .BR EN .
    141 .TP
    142 .BR sharpen \ [-i]
    143 Creates a sharpen kernel. If
    144 .B -i
    145 is used, an intensified sharpen kernel is created.
    146 .TP
    147 .BI sobel\  direction
    148 Create a Sobel operator kernel with the specified
    149 .IR direction .
    150 The
    151 .I direction
    152 must be
    153 .BR N
    154 or
    155 .BR H ;
    156 .BR NW
    157 or
    158 .BR WN ;
    159 .BR W
    160 or
    161 .BR V ;
    162 .BR SW
    163 or
    164 .BR WS ;
    165 .BR S ;
    166 .BR SE
    167 or
    168 .BR ES ;
    169 .BR E ;
    170 .BR NE
    171 or
    172 .BR EN .
    173 .SH OPTIONS
    174 .TP
    175 .B -a
    176 Apply the values to the alpha channel, apply an
    177 identity kernel to all unselected channels.
    178 .TP
    179 .B -x
    180 Apply the values to the X channel, apply an
    181 identity kernel to all unselected channels.
    182 .TP
    183 .B -y
    184 Apply the values to the Y channel, apply an
    185 identity kernel to all unselected channels.
    186 .TP
    187 .B -z
    188 Apply the values to the Z channel, apply an
    189 identity kernel to all unselected channels.
    190 .SH NOTES
    191 .B blind-make-kernel
    192 Create a single frame, to that it can be stored to
    193 disc. When applying it to a video, you want to use
    194 .BR blind-repeat (1).
    195 .SH SEE ALSO
    196 .BR blind (7),
    197 .BR blind-apply-kernel (1),
    198 .BR blind-kernel (1),
    199 .BR blind-repeat (1)
    200 .SH AUTHORS
    201 Mattias Andrée
    202 .RI < maandree@kth.se >