Add blind-affine-colour and blind-split-chans

Signed-off-by: Mattias Andrée <maandree@kth.se>

7 files changed, 132 insertions, 4 deletions

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