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

NAME

6       XkbFreeGeometry - Free an entire geometry
7

SYNOPSIS

9       void  XkbFreeGeometry  (XkbGeometryPtr  geom,  unsigned int which, Bool
10              free_all);
11

ARGUMENTS

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

DESCRIPTION

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

DIAGNOSTICS

48       BadAlloc       Unable to allocate storage
49
50       BadValue       An argument is out of range
51
52
53
54X Version 11                    libX11 1.7.3.1              XkbFreeGeometry(3)