1XkbFreeGeometry(3) XKB FUNCTIONS XkbFreeGeometry(3)
2
3
4
6 XkbFreeGeometry - Free an entire geometry
7
9 void XkbFreeGeometry (XkbGeometryPtr geom, unsigned int which, Bool
10 free_all);
11
13 - geom geometry to be freed
14
15 - which
16 mask of geometry components to be freed
17
18 - free_all
19 True => the entire geometry is freed
20
22 Xkb provides a number of functions to allocate and free subcomponents
23 of a keyboard geometry. Use these functions to create or modify key‐
24 board geometries. Note that these functions merely allocate space for
25 the new element(s), and it is up to you to fill in the values explic‐
26 itly in your code. These allocation functions increase sz_* but never
27 touch num_* (unless there is an allocation failure, in which case they
28 reset both sz_* and num_* to zero). These functions return Success if
29 they succeed, BadAlloc if they are not able to allocate space, or Bad‐
30 Value if a parameter is not as expected.
31
32 The values of which and free_all determine how much of the specified
33 geometry is freed. The valid values for which are:
34
35 #define XkbGeomPropertiesMask (1<<0)
36 #define XkbGeomColorsMask (1<<1)
37 #define XkbGeomShapesMask (1<<2)
38 #define XkbGeomSectionsMask (1<<3)
39 #define XkbGeomDoodadsMask (1<<4)
40 #define XkbGeomKeyAliasesMask (1<<5)
41 #define XkbGeomAllMask (0x3f)
42
43 If free_all is True, the entire geometry is freed regardless of the
44 value of which. Otherwise, the portions of the geometry specified by
45 which are freed.
46
48 BadAlloc Unable to allocate storage
49
50 BadValue An argument is out of range
51
52
53
54X Version 11 libX11 1.6.12 XkbFreeGeometry(3)