Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XkbGetNamedGeometry(3)		 XKB FUNCTIONS		XkbGetNamedGeometry(3)

NAME
       XkbGetNamedGeometry  -  Loads a keyboard	geometry description from this
       database	by name

SYNOPSIS

       Status XkbGetNamedGeometry (Display *dpy, XkbDescPtr xkb, Atom name);

ARGUMENTS
       dpy    connection to the	X server

       xkb    keyboard description into	which the geometry should be loaded

       name   name of the geometry to be loaded

DESCRIPTION
       It is also possible to load a keyboard geometry by name.	The  X	server
       maintains a database of keyboard	components (see	below).

       XkbGetNamedGeometry can return BadName if the name cannot be found.

       The X server maintains a	database of keyboard components, identified by
       component type.	The database contains all the information necessary to
       build  a	complete keyboard description for a particular device, as well
       as to assemble partial descriptions. Table 1 identifies	the  component
       types and the type of information they contain.

		  Table	1 Server Database Keyboard Components
       ------------------------------------------------------------------
       Component       Component Primary Contents   May	also contain
       Type
       ------------------------------------------------------------------
       Keymap	       Complete	keyboard descrip-
		       tion
		       Normally	assembled using	a
		       complete	  component  from
		       each of the other types

       Keycodes	       Symbolic	name for each key   Aliases   for   some
		       Minimum and maximum  legal   keys
		       keycodes			    Symbolic  names  for
						    indicators
						    Description	of indi-
						    cators    physically
						    present

       Types	       Key types		    Real modifier  bind-
						    ings   and	symbolic
						    names for some  vir-
						    tual modifiers

       Compatibility   Rules  used  to assign ac-   Maps for some  indi-
		       tions to	keysyms		    cators
						    Real  modifier bind-
						    ings  and	symbolic
						    names  for some vir-
						    tual modifiers

       Symbols	       Symbol  mapping	for  key-   Explicit actions and
		       board keys		    behaviors  for  some
		       Modifier	mapping		    keys
		       Symbolic	names for groups    Real modifier  bind-
						    ings   and	symbolic
						    names for some  vir-
						    tual modifiers

       Geometry	       Layout of the keyboard	    Aliases   for   some
						    keys; overrides key-
						    codes      component
						    aliases
						    Symbolic  names  for
						    some indicators
						    Description	of indi-
						    cators    physically
						    present

       While a keymap is a database entry for a	complete keyboard description,
       and  therefore  logically different from	the individual component data-
       base entries, the rules for processing keymap entries are identical  to
       those  for  the individual components.  In the discussion that follows,
       the term	component is used to refer to either individual	components  or
       a keymap.

       There may be multiple entries for each of the component types. An entry
       may  be	either	complete  or partial.  Partial entries describe	only a
       piece of	the corresponding keyboard component and are  designed	to  be
       combined	with other entries of the same type to form a complete entry.

       For  example,  a	partial	symbols	map might describe the differences be-
       tween a common ASCII keyboard and some national layout. Such a  partial
       map  is not useful on its own because it	does not include those symbols
       that are	the same on both the ASCII and national	layouts	(such as func-
       tion keys). On the other	hand, this partial map can be used to  config-
       ure any ASCII keyboard to use a national	layout.

       When  a	keyboard description is	built, the components are processed in
       the order in which they appear in Table 1; later	 definitions  override
       earlier ones.

DIAGNOSTICS
       BadName	      A	font or	color of the specified name does not exist.

X Version 11			 libX11	1.8.12		XkbGetNamedGeometry(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XkbGetNamedGeometry&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help