aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/libcoopgamma_get_gamma_info_recv.3
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/libcoopgamma_get_gamma_info_recv.3')
-rw-r--r--doc/man/libcoopgamma_get_gamma_info_recv.3150
1 files changed, 0 insertions, 150 deletions
diff --git a/doc/man/libcoopgamma_get_gamma_info_recv.3 b/doc/man/libcoopgamma_get_gamma_info_recv.3
deleted file mode 100644
index 1307fe5..0000000
--- a/doc/man/libcoopgamma_get_gamma_info_recv.3
+++ /dev/null
@@ -1,150 +0,0 @@
-.TH LIBCOOPGAMMA_GET_GAMMA_INFO_RECV 3 LIBCOOPGAMMA
-.SH "NAME"
-libcoopgamma_get_gamma_info_recv - Receive metainformation about a CRTC's gamma ramps
-.SH "SYNOPSIS"
-.nf
-#include <libcoopgamma.h>
-
-int libcoopgamma_get_gamma_info_recv(libcoopgamma_crtc_info_t *restrict \fIinfo\fP,
- libcoopgamma_context_t *restrict \fIctx\fP,
- libcoopgamma_async_context_t *restrict \fIasync\fP);
-.fi
-.P
-Link with
-.IR -lcoopgamma .
-.SH "DESCRIPTION"
-The
-.BR libcoopgamma_get_gamma_info_recv ()
-function parses the response for the requests
-sent using the
-.BR libcoopgamma_get_gamma_info_send ()
-function with the same
-.I ctx
-and
-.I async
-arguments. The
-.I async
-must have been selected by the last call to the
-.BR libcoopgamma_synchronise (3)
-function.
-.P
-The information about the CRTC's gamma ramps
-will be stored in
-.IR *info .
-In particular,
-.I info->cooperative
-will be set to nonzero (actually 1) if there is
-a coopgamma server running,
-.I info->supported
-will be set to
-.IR LIBCOOPGAMMA_NO ,
-.IR LIBCOOPGAMMA_MAYBE ,
-or
-.IR LIBCOOPGAMMA_YES ,
-which ever describes the state of gamma ramp
-support on the CRTC. Unless
-.I info->supported
-is
-.IR LIBCOOPGAMMA_NO ,
-the following will also be set:
-.TP
-.I info->red_size
-The number of stops on the red gamma ramp.
-.TP
-.I info->green_size
-The number of stops on the green gamma ramp.
-.TP
-.I info->blue_size
-The number of stops on the blue gamma ramp.
-.TP
-.I info->depth
-Describes the gamma ramp types used for the CRTC.
-.P
-The
-.BR libcoopgamma_get_gamma_info_recv ()
-will also store monitor's colourspace information in
-.IR *info .
-In particular,
-.I info->colourspace
-will be set to
-.IR LIBCOOPGAMMA_SRGB ,
-.IR LIBCOOPGAMMA_RGB ,
-.IR LIBCOOPGAMMA_NON_RGB ,
-.IR LIBCOOPGAMMA_GREY ,
-or
-.IR LIBCOOPGAMMA_UNKNOWN ,
-and
-.I info->have_gamut
-will be set to 1 or 0.
-.I info->have_gamut
-should be set to 0 unless
-.I info->colourspace
-is set to
-.I LIBCOOPGAMMA_SRGB
-or
-.IR LIBCOOPGAMMA_RGB ,
-and it should be set to 1 if
-.I info->colourspace
-is set to
-.I LIBCOOPGAMMA_SRGB ,
-however there are no guarantees that
-this is true. If
-.I info->have_gamut
-is non-zero, the following will also be set:
-.TP
-.I info->red_x
-The x-value (CIE xyY) of the monitor's
-red colour, multiplied by 1024.
-.TP
-.I info->red_y
-The y-value (CIE xyY) of the monitor's
-red colour, multiplied by 1024.
-.TP
-.I info->green_x
-The x-value (CIE xyY) of the monitor's
-green colour, multiplied by 1024.
-.TP
-.I info->green_y
-The y-value (CIE xyY) of the monitor's
-green colour, multiplied by 1024.
-.TP
-.I info->blue_x
-The x-value (CIE xyY) of the monitor's
-blue colour, multiplied by 1024.
-.TP
-.I info->blue_y
-The y-value (CIE xyY) of the monitor's
-blue colour, multiplied by 1024.
-.TP
-.I info->white_x
-The x-value (CIE xyY) of the monitor's
-default white point, multiplied by 1024.
-.TP
-.I info->white_y
-The y-value (CIE xyY) of the monitor's
-default white point, multiplied by 1024.
-.SH "RETURN VALUES"
-Upon successful completion, the
-.BR libcoopgamma_get_gamma_info_recv ()
-function returns 0. On error, -1 is returned and
-.I errno
-is set appropriately.
-.SH "ERRORS"
-The
-.BR libcoopgamma_get_gamma_info_recv ()
-function may fail for any reason specified for
-.BR malloc (3).
-The function may also fail for the following reasons:
-.TP
-.B EBADMSG
-The received message was corrupt.
-.SH "SEE ALSO"
-.BR libcoopgamma.h (0),
-.BR libcoopgamma_crtc_info_initialise (3),
-.BR libcoopgamma_async_context_destroy (3),
-.BR libcoopgamma_synchronise (3),
-.BR libcoopgamma_get_gamma_info_send (3),
-.BR libcoopgamma_get_gamma_info_sync (3),
-.BR libcoopgamma_get_crtcs_recv (3),
-.BR libcoopgamma_get_gamma_recv (3),
-.BR libcoopgamma_set_gamma_recv (3)