Add support for skipping conversion to CIEXYZ (not complete)

Some tools are colour space agnostic or even encoding
agnostic, by skipping conversion to CIEXYZ when these
tools are used, the rendering time can be significantly
reduced. The video can also be split horizontally and
vertically, and latted merged back, so it is not necessary
to convert the entire video if only parts of it actually
need it.

Because some tools are less agnostic than other tools,
partial conversion to CIEXYZ is also added.

blind-convert must be updated, and all tools most be test

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

8 files changed, 148 insertions, 8 deletions

diff --git a/man/blind-colour-matrix.1 b/man/blind-colour-matrix.1
index a976260..05ed44a 100644
--- a/man/blind-colour-matrix.1
+++ b/man/blind-colour-matrix.1
@@ -55,7 +55,9 @@ CIE Standard Illuminant D65 is used.
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw
+are not supported.
 .TP
 .B -z
 Parse arguments as CIE XYY instead of CIE XYZ.
diff --git a/man/blind-convert.1 b/man/blind-convert.1
index dd87b78..500ebaa 100644
--- a/man/blind-convert.1
+++ b/man/blind-convert.1
@@ -40,6 +40,108 @@ The same colour space as the input stream, but with
 each subpixel value is stored as a double-precision
 floating-point number using the local machines
 endianness.
+.TP
+.B raw0
+Use output from
+.BR ffmpeg (1)
+as-is, that is little-endian, 16-bit integer AY'UV.
+.TP
+.B raw1
+Little-endian, 16-bit integer Y'UVA.
+.TP
+.B raw2
+Host-endian, 16-bit integer Y'UV.
+.TP
+.B raw2a
+Host-endian, 16-bit integer Y'UVA.
+.TP
+.B raw3 f
+Host-endian, single-precision float-point Y'UV.
+.TP
+.B raw3 !f
+Host-endian, double-precision float-point Y'UV.
+.TP
+.B raw3
+Host-endian, double-precision float-point Y'UV,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw3a f
+Host-endian, single-precision float-point Y'UVA.
+.TP
+.B raw3a !f
+Host-endian, double-precision float-point Y'UVA.
+.TP
+.B raw3a
+Host-endian, double-precision float-point Y'UVA,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw4 f
+Host-endian, single-precision float-point XY'Z.
+.TP
+.B raw4 !f
+Host-endian, double-precision float-point XY'Z.
+.TP
+.B raw4
+Host-endian, double-precision float-point XY'Z,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw4a f
+Host-endian, single-precision float-point XY'ZA.
+.TP
+.B raw4a !f
+Host-endian, double-precision float-point XY'ZA.
+.TP
+.B raw4a 
+Host-endian, double-precision float-point XY'ZA,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw5 f
+Host-endian, single-precision float-point sR'G'B'.
+.TP
+.B raw5 !f
+Host-endian, double-precision float-point sR'G'B'.
+.TP
+.B raw5
+Host-endian, double-precision float-point sR'G'B',
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw5a f
+Host-endian, single-precision float-point sR'G'B'A.
+.TP
+.B raw5a !f
+Host-endian, double-precision float-point sR'G'B'A.
+.TP
+.B raw5a
+Host-endian, double-precision float-point sR'G'B'A,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw6 f
+Host-endian, single-precision float-point sRGB.
+.TP
+.B raw6 !f
+Host-endian, double-precision float-point sRGB.
+.TP
+.B raw6
+Host-endian, double-precision float-point sRGB,
+but single-precision float-point if input is
+single-precision float-point.
+.TP
+.B raw6a f
+Host-endian, single-precision float-point sRGBA.
+.TP
+.B raw6a !f
+Host-endian, double-precision float-point sRGBA.
+.TP
+.B raw6a
+Host-endian, double-precision float-point sRGBA,
+but single-precision float-point if input is
+single-precision float-point.
 .SH SEE ALSO
 .BR blind (7)
 .SH AUTHORS
diff --git a/man/blind-coordinate-field.1 b/man/blind-coordinate-field.1
index 371cfec..fe5e0fb 100644
--- a/man/blind-coordinate-field.1
+++ b/man/blind-coordinate-field.1
@@ -36,7 +36,9 @@ no processes with an open read end to this process's stdout.
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw
+are not supported.
 .TP
 .BR -w " "\fIwidth\fP
 The width of the video, in pixels.
diff --git a/man/blind-from-video.1 b/man/blind-from-video.1
index 9172af2..68e355b 100644
--- a/man/blind-from-video.1
+++ b/man/blind-from-video.1
@@ -13,7 +13,7 @@ blind-from-video - Converts a regular, cooked video to a blind video
 .IR height ]
 [-dL]
 .I input-file
-.I output-file
+.RI [ output-file ]
 .SH DESCRIPTION
 .B blind-from-video
 converts the video, in the file
@@ -34,6 +34,12 @@ It is unspecified what happens if
 .I input-file
 does not have exactly one video stream. All non-video streams,
 such as audio and subtitles are discarded.
+.P
+If
+.B output-file
+is omitted,
+.RB ' - '
+(stdout) is used.
 .SH OPTIONS
 .TP
 .B -d
@@ -44,11 +50,26 @@ drafting or if you will not modify the colours. If you use this
 flag, you should also use it in
 .BR blind-to-video (1),
 otherwise the colours will be modified.
+
+This is similar to
+.B -F raw
+and piping the output to
+.BR blind-convert (1)
+with
+.BR "-F raw4" ,
+however, the
+.B xyza
+is recorded instead of
+.BR raw4 .
 .TP
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw ,
+other than
+.BR raw0 ,
+are not supported.
 .TP
 .BR -h " "\fIheight\fP
 Change the height of the video to
@@ -84,6 +105,7 @@ Change the width of the video to
 .SH SEE ALSO
 .BR blind (7),
 .BR blind-to-video (1),
+.BR blind-convert (1),
 .BR blind-split (1),
 .BR blind-rewrite-head (1)
 .SH AUTHORS
diff --git a/man/blind-rectangle-tessellation.1 b/man/blind-rectangle-tessellation.1
index 6bcd4c0..75876dc 100644
--- a/man/blind-rectangle-tessellation.1
+++ b/man/blind-rectangle-tessellation.1
@@ -23,7 +23,9 @@ pixels tall.
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw
+are not supported.
 .SH SEE ALSO
 .BR blind (7),
 .BR blind-hexagon-tessellation (1),
diff --git a/man/blind-repeat.1 b/man/blind-repeat.1
index bbd54b6..f9005af 100644
--- a/man/blind-repeat.1
+++ b/man/blind-repeat.1
@@ -7,7 +7,7 @@ blind-repeat - Repeat a video
 .I count
 |
 .RB ' inf ')
-.I file
+.RI [ file ]
 .SH DESCRIPTION
 .B blind-repeat
 write the a video to stdout that is a loop of the
@@ -34,6 +34,12 @@ will read stdin into memory; you are highly discouraged
 from using this unless stdin is a single frame, or known
 to only be a very small number of frames, is it can
 potentially use all of the computer's memory.
+.P
+If
+.I file
+is omitted,
+.RB ' - '
+is used.
 .SH OPTIONS
 .TP
 .B -f
diff --git a/man/blind-single-colour.1 b/man/blind-single-colour.1
index 2e3d675..4fc72ac 100644
--- a/man/blind-single-colour.1
+++ b/man/blind-single-colour.1
@@ -55,7 +55,9 @@ no processes with an open read end to this process's stdout.
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw
+are not supported.
 .TP
 .BR -w " "\fIwidth\fP
 The width of the video, in pixels.
diff --git a/man/blind-triangle-tessellation.1 b/man/blind-triangle-tessellation.1
index ed0b9a9..6ba58bc 100644
--- a/man/blind-triangle-tessellation.1
+++ b/man/blind-triangle-tessellation.1
@@ -26,7 +26,9 @@ go from northwest to southeast.
 .BR -F " "\fIpixel-format\fP
 Select pixel format, see
 .BR blind-convert (1)
-for more information.
+for more information. Pixel formats starting with
+.BR raw
+are not supported.
 .SH SEE ALSO
 .BR blind (7),
 .BR blind-hexagon-tessellation (1),