blind

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

blind-make-kernel.1 (1715B)


      1 .TH BLIND-MAKE-KERNEL 1 blind
      2 .SH NAME
      3 blind-make-kernel - Create a custom convolution matrix
      4 .SH SYNOPSIS
      5 .B blind-make-kernel
      6 [-d
      7 .IR denominator ]\ ...
      8 [-nxyza]
      9 --
     10 .IR value \ ...]\ ...
     11 .SH DESCRIPTION
     12 .B blind-make-kernel
     13 creates a convolution matrix that can be applied to
     14 a video using
     15 .BR blind-apply-kernel (1).
     16 .P
     17 The matrix is construct from each
     18 .I value
     19 with
     20 .B --
     21 delimiting the rows. For example
     22 .P
     23 .nf
     24 	blind-make-kernel 1 2 3 -- 4 5 6
     25 .fi
     26 .P
     27 creates the matrix
     28 .P
     29 .nf
     30 	1 2 3
     31 	4 5 6
     32 .fi
     33 .P
     34 If no
     35 .I value
     36 is specified (and at most one
     37 .B --
     38 is used)
     39 the matrix is read from stdin, <newline>
     40 is used to delimit rows and other whitespace
     41 is used to delimit cells.
     42 .SH OPTIONS
     43 .TP
     44 .B -a
     45 Apply the values to the alpha channel, apply an
     46 identity kernel to all unselected channels.
     47 .TP
     48 .BR -d \ \fIdenominator\fP
     49 Divide the matrix by
     50 .IR denominator .
     51 This option is applied after
     52 .B -n
     53 and can be used multiple times. The product of
     54 all specified values are used as the denominator.
     55 .TP
     56 .B -n
     57 Normalise the matrix, that is, divide it by the
     58 sum of all its elements. This option is applied
     59 before
     60 .BR -d .
     61 .TP
     62 .B -x
     63 Apply the values to the X channel, apply an
     64 identity kernel to all unselected channels.
     65 .TP
     66 .B -y
     67 Apply the values to the Y channel, apply an
     68 identity kernel to all unselected channels.
     69 .TP
     70 .B -z
     71 Apply the values to the Z channel, apply an
     72 identity kernel to all unselected channels.
     73 .SH NOTES
     74 .B blind-make-kernel
     75 Create a single frame, to that it can be stored to
     76 disc. When applying it to a video, you want to use
     77 .BR blind-repeat (1).
     78 .SH SEE ALSO
     79 .BR blind (7),
     80 .BR blind-apply-kernel (1),
     81 .BR blind-kernel (1),
     82 .BR blind-repeat (1)
     83 .SH AUTHORS
     84 Mattias Andrée
     85 .RI < maandree@kth.se >