dtk_create_string(3) [debian man page]

DTK_CREATE_STRING(3)						Draw Toolkit manual					      DTK_CREATE_STRING(3)

NAME

       dtk_create_string - Creates or modify a shape to display a string

SYNOPSIS

       #include <drawtk.h>

       dtk_hshape dtk_create_string(dtk_hshape shp, const char *text,
				    float size, float x, float y,
				    unsigned int alignment,
				    const float *color, dtk_hfont font);

DESCRIPTION

       dtk_create_string()  creates  a text specified by text at location (x,y) with a font size of size using a previously loaded font referenced
       by font argument (see dtk_load_font(3)).

       The position (x,y) is interpreted according to the combination of flags controlling the vertical and horizontal alignment  defined  in  the
       alignment argument:

	* DTK_BOTTOM,  DTK_VMID  and DTK_TOP make the value y to be interpreted as respectively the bottom, the middle and the top of the bounding
	  box of the shape.

	* DTK_LEFT, DTK_HMID and DTK_RIGHT make the value x to be interpreted as respectively the left, the middle and the right of  the  bounding
	  box of the shape.

       shp and color has the same usage and meaning than in other shape creation functions (see dtk_create_shape(3)):

	* shp  can be used to modify a previously created shape. If it is non-null, the handle will be used to modify the shape referenced by shp:
	  no new shape is created and the returned value is ensured to be shp in case of success, NULL otherwise. If shp  is  NULL,  the  function
	  will attempt to create a new shape.

	* color should point to a 4 float array containing a normalized RGBA value (i.e. each component is between 0.0 and 1.0).

RETURN VALUE

       In  case  of  success  the  function returns the handle to the newly created or modified shape. If the shp argument is non-null, the handle
       returned is the same value. In case of error, NULL is returned.

SEE ALSO

       dtk_load_font(3), dtk_create_shape(3)

EPFL
								       2010						      DTK_CREATE_STRING(3)

XkbComputeShapeBounds(3)					   XKB FUNCTIONS					  XkbComputeShapeBounds(3)

NAME

       XkbComputeShapeBounds - Updates the bounding box of a shape

SYNOPSIS

       Bool XkbComputeShapeBounds ( shape )
	     XkbShapePtr shape;

ARGUMENTS

       - shape
	      shape to be examined

DESCRIPTION

       Xkb  provides  a  number  of convenience functions to help use a keyboard geometry. These include functions to return the bounding box of a
       shape's top surface and to update the bounding box of a shape row or section.

       A shape is made up of a number of outlines. Each outline is a polygon made up of a number of points. The bounding box of a shape is a  rec-
       tangle that contains all the outlines of that shape.

       A  ShapeRec  contains  a BoundsRec that describes the bounds of the shape. If you add or delete an outline to or from a shape, the bounding
       box must be updated.

       XkbComputeShapeBounds updates the BoundsRec contained in the shape by examining all the outlines of the shape and setting the BoundsRec	to
       the  minimum  x and minimum y, and maximum x and maximum y values found in those outlines.  XkbComputeShapeBounds returns False if shape is
       NULL or if there are no outlines for the shape; otherwise, it returns True.

       If you add or delete a key to or from a row, or if you update the shape of one of the keys in that row, you may need to update the bounding
       box of that row. To update the bounding box of a row, use XkbComputeRowBounds.

STRUCTURES

       typedef struct _XkbShape {
	   Atom 	  name; 	/* shape's name */
	   unsigned short num_outlines; /* number of outlines for the shape */
	   unsigned short sz_outlines;	/* size of the outlines array */
	   XkbOutlinePtr  outlines;	/* array of outlines for the shape */
	   XkbOutlinePtr  approx;	/* pointer into the array to the approximating outline */
	   XkbOutlinePtr  primary;	/* pointer into the array to the primary outline */
	   XkbBoundsRec   bounds;	/* bounding box for the shape; encompasses all outlines */
       } XkbShapeRec, *XkbShapePtr;

       typedef struct _XkbBounds {
	   short x1,y1;    /* upper left corner of the bounds, in mm/10 */
	   short x2,y2;    /* lower right corner of the bounds, in mm/10 */
       } XkbBoundsRec, *XkbBoundsPtr;

SEE ALSO

       XkbComputeRowBounds(3)

X Version 11							   libX11 1.2.1 					  XkbComputeShapeBounds(3)