1XkbComputeShapeTop(3) XKB FUNCTIONS XkbComputeShapeTop(3)
2
3
4
6 XkbComputeShapeTop - Determines the bounding box of the top surface of
7 a shape
8
10 Bool XkbComputeShapeTop (XkbShapePtr shape, XkbBoundsPtr bounds_rtrn);
11
13 - shape
14 shape to be examined
15
16 - bounds_rtrn
17 backfilled with the bounding box for the shape
18
20 Xkb provides a number of convenience functions to help use a keyboard
21 geometry. These include functions to return the bounding box of a
22 shape's top surface and to update the bounding box of a shape row or
23 section.
24
25 A shape is made up of a number of outlines. Each outline is a polygon
26 made up of a number of points. The bounding box of a shape is a rectan‐
27 gle that contains all the outlines of that shape.
28
29 XkbComputeShapeTop returns a BoundsRec that contains two x and y coor‐
30 dinates. These coordinates describe the corners of a rectangle that
31 contains the outline that describes the top surface of the shape. The
32 top surface is defined to be the approximating outline if the approx
33 field of shape is not NULL. If approx is NULL, the top surface is
34 defined as the last outline in the shape's array of outlines. XkbCom‐
35 puteShapeTop returns False if shape is NULL or if there are no outlines
36 for the shape; otherwise, it returns True.
37
39 typedef struct _XkbBounds {
40 short x1,y1; /∗ upper left corner of the bounds, in mm/10 */
41 short x2,y2; /∗ lower right corner of the bounds, in mm/10 */
42 } XkbBoundsRec, *XkbBoundsPtr;
43
44
45
46
47X Version 11 libX11 1.6.7 XkbComputeShapeTop(3)