blind-apply-kernel.1 - blind - suckless command-line video editing utility | |
git clone git://git.suckless.org/blind | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
blind-apply-kernel.1 (1792B) | |
--- | |
1 .TH BLIND-APPLY-KERNEL 1 blind | |
2 .SH NAME | |
3 blind-apply-kernel - Apply a convolution matrix to a video | |
4 .SH SYNOPSIS | |
5 .B blind-apply-kernel | |
6 [-apPxy] | |
7 .I kernel-stream | |
8 .SH DESCRIPTION | |
9 .B blind-apply-kernel | |
10 reads a video from stdin and a convolution matrix video | |
11 from | |
12 .I kernel-stream | |
13 and apply the convolution matrix in each frame the | |
14 same frame in stdin, and prints the resulting video | |
15 to stdout. | |
16 .SH OPTIONS | |
17 .TP | |
18 .B -a | |
19 Used to optimise performance if it is known that | |
20 the video is opaque, and to ensure that the output | |
21 video is opaque. | |
22 .TP | |
23 .B -p | |
24 Each frame in | |
25 .I kernel-stream | |
26 shall contain one matrix per pixel in a frame in | |
27 stdin. The width of | |
28 .I kernel-stream | |
29 shall be a multiple of the width of stdin, the width | |
30 shall be the width of stdin multiplied by the width | |
31 of the convolution matrix. The height of | |
32 .I kernel-stream | |
33 shall be a multiple of the height of stdin, the | |
34 height shall be the height of stdin multiplied by the | |
35 height of the convolution matrix. | |
36 .TP | |
37 .B -P | |
38 Apply the convolution with first premultiplying | |
39 the alpha channel. | |
40 .TP | |
41 .B -x | |
42 When encountering the left or right edge of the video, | |
43 wrap around to the opposite edge. | |
44 .TP | |
45 .B -y | |
46 When encountering the upper or lower edge of the video, | |
47 wrap around to the opposite edge. | |
48 .SH REQUIREMENTS | |
49 .B blind-apply-kernel | |
50 requires enough free memory to load two full frames | |
51 from stdin and one full frame from | |
52 .I kernel-stream | |
53 into memory. However, if | |
54 .I -p | |
55 is used, the height of | |
56 .I kernel-stream | |
57 divide by the height of stdin number of rows from | |
58 .I kernel-stream | |
59 rather than a full frame from | |
60 .I kernel-stream | |
61 is loaded into memory. | |
62 A frame or row requires 32 bytes per pixel it contains. | |
63 .SH SEE ALSO | |
64 .BR blind (7), | |
65 .BR blind-make-kernel (1), | |
66 .BR blind-kernel (1), | |
67 .BR blind-gauss-blur (1) | |
68 .SH AUTHORS | |
69 Mattias Andrée | |
70 .RI < [email protected] > |