aboutsummaryrefslogtreecommitdiffstats
path: root/man3/LIBAXL_REQUEST_FREE_COLORMAP.3
blob: 04534ba038877206c8ce7cbc797380d1eb86bda5 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.TH LIBAXL_REQUEST_FREE_COLORMAP 3 libaxl
.SH NAME
LIBAXL_REQUEST_FREE_COLORMAP - Delete reference to a colormap
.SH SYNOPSIS
.nf
#include <libaxl.h>

#define LIBAXL_REQUEST_FREE_COLORMAP 79
struct libaxl_request_free_colormap {
        uint8_t           \fIopcode\fP;
        uint8_t           \fI__pad\fP;
        uint16_t          \fI_request_length\fP;
        libaxl_colormap_t \fIcmap\fP;
};
.fi
.SH DESCRIPTION
The display server shall remove the association
between the resource ID, which is specified in
the
.I cmap
field, and the colormap.
.PP
The the colormap is installed for a screen, it
will be uninstalled.
.PP
If the colormap is defined as the colormap for a
window, the colormap for the window is changed to
.BR LIBAXL_NONE ,
and a
.I LIBAXL_EVENT_COLORMAP_NOTIFY
event is generated. (The protocol does not define
colors displayed for a window with
.I LIBAXL_NONE
as the colormap).
.PP
When no resource references the colormap, it will
be deallocated.
.PP
This request has no effect on a default colormap
for a screen.
.PP
The value of the
.I opcode
field shall be
.I LIBAXL_REQUEST_FREE_COLORMAP
to signify that the request is of the
request described in this document.
.PP
Other fields are filled in automatically by the
.BR libaxl_send_request (3)
function.
.SH ERRORS
.TP
.BR LIBAXL_ERROR_WINDOW (3)
The specified window ID does not exist.
.TP
.BR LIBAXL_ERROR_COLORMAP (3)
The specified colormap ID does not exist.
.SH REPLIES
None.
.SH SEE ALSO
.BR libaxl_send_request (3),
.RB LIBAXL_REQUEST_COPY_COLORMAP_AND_FREE (3),
.RB LIBAXL_REQUEST_CREATE_COLORMAP (3),
.RB LIBAXL_REQUEST_UNINSTALL_COLORMAP(3)