From fa20f84e2d12bf9998591ce4e464180586d957ff Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 20 Jul 2017 20:03:52 +0200 Subject: Add blind-affine-colour and blind-split-chans MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/blind-affine-colour.1 | 71 +++++++++++++++++++++++++++++++++++++++++++ man/blind-arithm.1 | 3 +- man/blind-invert-matrix.1 | 3 +- man/blind-multiply-matrices.1 | 3 +- man/blind-rewrite-head.1 | 3 +- man/blind-split-chans.1 | 47 ++++++++++++++++++++++++++++ man/blind.7 | 6 ++++ 7 files changed, 132 insertions(+), 4 deletions(-) create mode 100644 man/blind-affine-colour.1 create mode 100644 man/blind-split-chans.1 (limited to 'man') diff --git a/man/blind-affine-colour.1 b/man/blind-affine-colour.1 new file mode 100644 index 0000000..54891f0 --- /dev/null +++ b/man/blind-affine-colour.1 @@ -0,0 +1,71 @@ +.TH BLIND-AFFINE-COLOUR 1 blind +.SH NAME +blind-affine-colour - Apply an affine transformation to the colours in a video +.SH SYNOPSIS +.B blind-affine-colour +[-alp] +.I matrix-stream +.SH DESCRIPTION +.B blind-affine-colour +reads a video from stdin and a matrix video from +.I matrix-stream +and multiplies colours from stdin with matrices from +.I matrix-stream +and prints the resulting video to stdout. +.P +Each frame in +.I matrix-stream +is a matrix and shall have the width and height 5. +Each pixel in a frame is a cell in the matrix, +the pixels luma is multiples by its alpha value +to determine the value of the matrix cell. +.SH OPTIONS +.TP +.B -a +The width and height of the matrix shall be 4 +instead of 5 (reduced by 1) and the alpha values +of the pixels shall not be modified. +.TP +.B -l +The width and height of the matrix shall be 4 +instead of 5 (reduced by 1) making the transformation +linear instead of affine. +.TP +.B -p +Each frame in +.I matrix-stream +shall contain one matrix per pixel in a frame in +stdin. The video in +.I matrix-stream +shall be 5, 4, or 3, depending on whether +.B -a +and +.B -l +are specified, times are wide and tall as the +video in stdin. +.SH NOTES +If both +.B -a +and +.B -l +are specified, the matrices shall have the +width and height 3 instead of 5. +.SH REQUIREMENTS +.B blind-affine-colour +requires enough free memory to load 5, 4, or 3, +depending on whether +.B -a +and +.B -l +are specified, full rows from +.I matrix-stream +into memory. A frame requires 32 bytes per pixel +it contains. +.SH SEE ALSO +.BR blind (7), +.BR blind-arithm (1), +.BR blind-invert-matrix (1), +.BR blind-multiply-matrice (1) +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > diff --git a/man/blind-arithm.1 b/man/blind-arithm.1 index 22c1188..6df053a 100644 --- a/man/blind-arithm.1 +++ b/man/blind-arithm.1 @@ -90,7 +90,8 @@ Do not modify the Z channel (the third channel). .BR blind-set-alpha (1), .BR blind-set-luma (1), .BR blind-invert-luma (1), -.BR blind-set-saturation (1) +.BR blind-set-saturation (1), +.BR blind-affine-colour (1) .SH AUTHORS Mattias Andrée .RI < maandree@kth.se > diff --git a/man/blind-invert-matrix.1 b/man/blind-invert-matrix.1 index d1f2dbc..c5a94e6 100644 --- a/man/blind-invert-matrix.1 +++ b/man/blind-invert-matrix.1 @@ -29,7 +29,8 @@ are identical. .BR blind-flop (1), .BR blind-rotate-90 (1), .BR blind-rotate-180 (1), -.BR blind-rotate-270 (1) +.BR blind-rotate-270 (1), +.BR blind-rewrite-head (1) .SH AUTHORS Mattias Andrée .RI < maandree@kth.se > diff --git a/man/blind-multiply-matrices.1 b/man/blind-multiply-matrices.1 index cb6a2c8..3d8c9ab 100644 --- a/man/blind-multiply-matrices.1 +++ b/man/blind-multiply-matrices.1 @@ -44,7 +44,8 @@ in reverse order. .BR blind-flop (1), .BR blind-rotate-90 (1), .BR blind-rotate-180 (1), -.BR blind-rotate-270 (1) +.BR blind-rotate-270 (1), +.BR blind-rewrite-head (1) .SH AUTHORS Mattias Andrée .RI < maandree@kth.se > diff --git a/man/blind-rewrite-head.1 b/man/blind-rewrite-head.1 index 2429649..7b6f21a 100644 --- a/man/blind-rewrite-head.1 +++ b/man/blind-rewrite-head.1 @@ -72,7 +72,8 @@ two copies of on disc. .BR blind-from-video (1), .BR blind-split (1), .BR blind-read-head (1), -.BR blind-write-head (1) +.BR blind-write-head (1), +.BR blind-transpose (1) .SH AUTHORS Mattias Andrée .RI < maandree@kth.se > diff --git a/man/blind-split-chans.1 b/man/blind-split-chans.1 new file mode 100644 index 0000000..fd350ce --- /dev/null +++ b/man/blind-split-chans.1 @@ -0,0 +1,47 @@ +.TH BLIND-SPLIT-CHANS 1 blind +.SH NAME +blind-split-chans - Split colour channels into separate videos +.SH SYNOPSIS +.B blind-split-chans +.I X-file +.I Y-file +.I Z-file +.RI [ alpha-file ] +.SH DESCRIPTION +.B blind-split-chans +reads a video from stdin and prints +it to +.I X-file +with the values of the first channel +(the X channel) in written to all +channels, to +.I Y-file +with the values of the second channel +(the Y channel) in written to all +channels, to +.I Z-file +with the values of the third channel +(the Z channel) in written to all +channels, and to +.I alpha-file +with the values of the fourth channel +(the alpha channel) in written to all +channels. +.P +If +.I alpha-file +is omitted, values of the alpha channel +are instead written to the alpha channels +in +.IR X-file , +.IR Y-file , +and +.IR Z-file . +.SH SEE ALSO +.BR blind (7), +.BR blind-arithm (1), +.BR blind-cat-cols (1), +.BR blind-cat-rows (1) +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > diff --git a/man/blind.7 b/man/blind.7 index e0ec8c5..1e61ee3 100644 --- a/man/blind.7 +++ b/man/blind.7 @@ -19,6 +19,9 @@ first convert it with .BR blind-to-video (1). .SH UTILITIES .TP +.BR blind-affine-colour (1) +Apply an affine transformation to the colours in a video +.TP .BR blind-arithm (1) Perform simple arithmetic on a video .TP @@ -247,6 +250,9 @@ Generate a video with a spiral gradient .BR blind-split (1) Split a video, by frame, into multiple videos .TP +.BR blind-split-chans (1) +Split colour channels into separate videos +.TP .BR blind-split-cols (1) Split a video vertically into multiple videos .TP -- cgit v1.2.3-70-g09d2