blind-kernel.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-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 >