aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2017-06-14 22:15:34 +0200
committerMattias Andrée <maandree@kth.se>2017-06-14 22:15:34 +0200
commit3da92f1647526819021e5776cd3c488ba2474852 (patch)
tree3c55206f16d84257dbbfdfa011421c71262cb6b2
parentAdd YES colour model, generate the conversion matrices, and add more direct conversions (diff)
downloadlibcolour-3da92f1647526819021e5776cd3c488ba2474852.tar.gz
libcolour-3da92f1647526819021e5776cd3c488ba2474852.tar.bz2
libcolour-3da92f1647526819021e5776cd3c488ba2474852.tar.xz
Doc YES
Signed-off-by: Mattias Andrée <maandree@kth.se>
-rw-r--r--LIBCOLOUR_YES.763
-rw-r--r--Makefile3
-rw-r--r--README3
-rw-r--r--libcolour.7.in4
4 files changed, 72 insertions, 1 deletions
diff --git a/LIBCOLOUR_YES.7 b/LIBCOLOUR_YES.7
new file mode 100644
index 0000000..2c31d5d
--- /dev/null
+++ b/LIBCOLOUR_YES.7
@@ -0,0 +1,63 @@
+.TH LIBCOLOUR_YES 7 libcolour
+.SH NAME
+LIBCOLOUR_YES - YES
+.SH DESCRIPTION
+YES colours are presented with either of
+.nf
+
+ typedef struct libcolour_yes_f libcolour_yes_f_t;
+ typedef struct libcolour_yes_lf libcolour_yes_lf_t;
+ typedef struct libcolour_yes_llf libcolour_yes_llf_t;
+
+.fi
+These
+.BR struct s
+use
+.BR float ,
+.BR double ,
+and
+.BR long\ double ,
+respecitively, for the values stored in them,
+and are otherwise identical.
+.B struct libcolour_yes_f
+is defined as
+.nf
+
+ struct libcolour_yes_f {
+ enum libcolour_model \fImodel\fP;
+ float \fIY\fP;
+ float \fIE\fP;
+ float \fIS\fP;
+ };
+
+.fi
+.I .model
+shall be set to
+.BR LIBCOLOUR_YES .
+In
+.BR union\ libcolour_colour_f ,
+.BR union\ libcolour_colour_lf ,
+and
+.BR union\ libcolour_colour_llf ,
+.I .yes
+is used for YES colours.
+.P
+.IR .Y ,
+.IR .E ,
+and
+.I .S
+hold the Y (luma), E (e-factor), and
+S (s-factor) values, respectively.
+.P
+Y is 0 in black and 1 in white.
+.P
+YES is additive, since it is linearly isomorphic
+to CIE 1931 XYZ.
+.P
+This colour model was developed for computer
+vision, specifically facial analysis.
+.SH SEE ALSO
+.BR libcolour (7)
+.SH AUTHORS
+Mattias Andrée
+.RI < maandree@kth.se >
diff --git a/Makefile b/Makefile
index b7b78c3..db15bd9 100644
--- a/Makefile
+++ b/Makefile
@@ -35,7 +35,8 @@ MAN7 =\
LIBCOLOUR_YPBPR.7\
LIBCOLOUR_YCGCO.7\
LIBCOLOUR_CIE1960UCS.7\
- LIBCOLOUR_CIEUVW.7
+ LIBCOLOUR_CIEUVW.7\
+ LIBCOLOUR_YES.7
MAN3 =\
libcolour_convert.3\
diff --git a/README b/README
index f0e1455..14edd24 100644
--- a/README
+++ b/README
@@ -108,6 +108,9 @@ COLOUR MODELS
CIE 1964 (U*, V*, W*)
See LIBCOLOUR_CIEUVW(7).
+ YES
+ See LIBCOLOUR_YES(7).
+
ILLUMINANTS
libcolour provides a number of initialiser macros for standard
illuminants. The following macros expand to a
diff --git a/libcolour.7.in b/libcolour.7.in
index 57e2b40..ee8c2df 100644
--- a/libcolour.7.in
+++ b/libcolour.7.in
@@ -196,6 +196,10 @@ See
CIE 1964 (U*, V*, W*)
See
.BR LIBCOLOUR_CIEUVW (7).
+.TP
+YES
+See
+.BR LIBCOLOUR_YES (7).
.SH ILLUMINANTS
.B libcolour
provides a number of initialiser macros for standard