1XkbAddGeomColor(3)               XKB FUNCTIONS              XkbAddGeomColor(3)
2
3
4

NAME

6       XkbAddGeomColor  -  Add one color name to an existing keyboard geometry
7       description
8

SYNOPSIS

10       XkbColorPtr XkbAddGeomColor (XkbGeometryPtr geom, char *spec,  unsigned
11              int pixel);
12

ARGUMENTS

14       - geom geometry to be updated
15
16       - spec color to be added
17
18       - pixel
19              color to be added
20

DESCRIPTION

22       Xkb  provides  functions  to  add a single new element to the top-level
23       keyboard geometry. In each case the num_ * fields of the  corresponding
24       structure  is  incremented by 1. These functions do not change sz_* un‐
25       less there is no more room in the array. Some of these  functions  fill
26       in  the values of the element's structure from the arguments. For other
27       functions, you must explicitly write code to fill the structure's  ele‐
28       ments.
29
30       The  top-level geometry description includes a list of geometry proper‐
31       ties.  A geometry property  associates  an  arbitrary  string  with  an
32       equally  arbitrary  name. Programs that display images of keyboards can
33       use geometry properties as hints, but they are not interpreted by  Xkb.
34       No other geometry structures refer to geometry properties.
35
36       XkbAddGeomColor  adds  the specified color name and pixel to the speci‐
37       fied geometry geom.  The top-level geometry description includes a list
38       of  up  to  MaxColors (32) color names.  A color name is a string whose
39       interpretation is not specified by Xkb and neither is the pixel value's
40       interpretation.  All other geometry data structures refer to colors us‐
41       ing their indices in this global list or pointers  to  colors  in  this
42       list.   XkbAddGeomColor  returns NULL if any of the parameters is empty
43       or if it was not able to allocate space  for  the  color.  To  allocate
44       space  for  an arbitrary number of colors to a geometry, use the XkbAl‐
45       locGeomColors function.
46

STRUCTURES

48           typedef struct _XkbColor {
49               unsigned int    pixel;      /∗ color */
50               char *          spec;       /∗ color name */
51           } XkbColorRec,*XkbColorPtr;
52
53

SEE ALSO

55       XkbAllocGeomColors(3)
56
57
58
59
60X Version 11                     libX11 1.7.0               XkbAddGeomColor(3)
Impressum