From a049b183e27d3fb2fa85645a228289440ea3181c Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 10 Jun 2017 12:24:37 +0200 Subject: Add libcolour_convert.3 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- libcolour_convert.3 | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 libcolour_convert.3 diff --git a/libcolour_convert.3 b/libcolour_convert.3 new file mode 100644 index 0000000..58f133e --- /dev/null +++ b/libcolour_convert.3 @@ -0,0 +1,60 @@ +.TH LIBCOLOUR_CONVERT 3 libcolour +.SH NAME +libcolour_convert - Colour space and colour model conversion +.SH SYNOPSIS +.nf +#include + +int \fBlibcolour_convert_f\fP(const libcolour_colour_f_t *\fIfrom\fP, libcolour_colour_f_t *\fIto\fP); +int \fBlibcolour_convert_lf\fP(const libcolour_colour_lf_t *\fIfrom\fP, libcolour_colour_lf_t *\fIto\fP); +int \fBlibcolour_convert_llf\fP(const libcolour_colour_llf_t *\fIfrom\fP, libcolour_colour_llf_t *\fIto\fP); + +#define \fBlibcolour_convert\fP(\fIfrom\fP, \fIto\fP)\\ + (_Generic((\fIfrom\fP),\\ + libcolour_colour_f_t *: \fBlibcolour_convert_f\fP(\fIcolour\fP),\\ + libcolour_colour_lf_t *: \fBlibcolour_convert_lf\fP(\fIcolour\fP),\\ + libcolour_colour_llf_t *: \fBlibcolour_convert_llf\fP(\fIcolour\fP))) + /* list is incomplete */ +.fi +.SH DESCRIPTION +.B libcolour_convert +and its non-generic functions converts the colour +stored in +.I from +to the colour space specified in +.I to +and stores the new colour values in +.IR to . +Additionally, the the transfer function is applied +or unapplied if specified differently in +.I from +and +.IR to . +.SH RETURN VALUES +Upon successful completion, the functions returns 0. +Otherwise the function return -1 with +.I errno +set to indicate the error. +.SH ERRORS +.TP +.B EINVAL +.I from->model +or +.I to->model +does not refer to a recognised colour model. +.SH NOTES +.B libcolour_convert +cannot convert between +.BR float , +.BR double , +and +.BR long\ double , +.I from +and +.I to +most use the same floating-point type. +.SH SEE ALSO +.BR libcolour (7) +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > -- cgit v1.2.3-70-g09d2