aboutsummaryrefslogtreecommitdiffstats
path: root/man/blind-make-kernel.1
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2017-05-13 20:35:26 +0200
committerMattias Andrée <maandree@kth.se>2017-05-13 20:35:26 +0200
commitf69ec5134ffc1fc27764ca70d10be92517ec4498 (patch)
treece6aa54fd5d43dc32e88ba3afaa204ea8a7f24cb /man/blind-make-kernel.1
parentAdd man pages for blind-{to,from}-portable and make -s the default (and invert it's meaning) (diff)
downloadblind-f69ec5134ffc1fc27764ca70d10be92517ec4498.tar.gz
blind-f69ec5134ffc1fc27764ca70d10be92517ec4498.tar.bz2
blind-f69ec5134ffc1fc27764ca70d10be92517ec4498.tar.xz
Add blind-make-kernel
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man/blind-make-kernel.1')
-rw-r--r--man/blind-make-kernel.184
1 files changed, 84 insertions, 0 deletions
diff --git a/man/blind-make-kernel.1 b/man/blind-make-kernel.1
new file mode 100644
index 0000000..903f489
--- /dev/null
+++ b/man/blind-make-kernel.1
@@ -0,0 +1,84 @@
+.TH BLIND-MAKE-KERNEL 1 blind
+.SH NAME
+blind-make-kernel - Create a custom convolution matrix
+.SH SYNOPSIS
+.B blind-make-kernel
+[-d
+.IR denominator ]\ ...
+[-nxyza]
+--
+.IR value \ ...]\ ...
+.SH DESCRIPTION
+.B blind-make-kernel
+creates a convolution matrix that can be applied to
+a video using
+.BR blind-apply-kernel (1).
+.P
+The matrix is construct from each
+.I value
+with
+.B --
+delimiting the rows. For example
+.P
+.nf
+ blind-make-kernel 1 2 3 -- 4 5 6
+.fi
+.P
+creates the matrix
+.P
+.nf
+ 1 2 3
+ 4 5 6
+.fi
+.P
+If no
+.I value
+is specified (and at most one
+.B --
+is used)
+the matrix is read from stdin, <newline>
+is used to delimit rows and other whitespace
+is used to delimit cells.
+.SH OPTIONS
+.TP
+.B -a
+Apply the values to the alpha channel, set the
+values for all unselected channels to zero.
+.TP
+.BR -d \ \fIdenominator\fP
+Divide the matrix by
+.IR denominator .
+This option is applied after
+.B -n
+and can be used multiple times. The product of
+all specified values are used as the denominator.
+.TP
+.B -n
+Normalise the matrix, that is, divide it by the
+sum of all its elements. This option is applied
+before
+.BR -d .
+.TP
+.B -x
+Apply the values to the X channel, set the values
+for all unselected channels to zero.
+.TP
+.B -y
+Apply the values to the Y channel, set the values
+for all unselected channels to zero.
+.TP
+.B -z
+Apply the values to the Z channel, set the values
+for all unselected channels to zero.
+.SH NOTES
+.B blind-make-kernel
+Create a single frame, to that it can be stored to
+disk. When applying it to a video, you want to use
+.BR blind-repeat (1).
+.SH SEE ALSO
+.BR blind (7),
+.BR blind-apply-kernel (1),
+.BR blind-repeat (1)
+.SH AUTHORS
+Mattias Andrée
+.RI < maandree@kth.se >