XCreateGlyphCursor man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

XCreateFontCursor(3X11)				       XCreateFontCursor(3X11)

NAME
       XCreateFontCursor,  XCreatePixmapCursor,	 XCreateGlyphCursor  -	create
       cursors

SYNOPSIS
       #include <X11/cursorfont.h>

       Cursor XCreateFontCursor(display, shape)
	       Display *display;
	       unsigned int shape;

       Cursor  XCreatePixmapCursor(display,  source,  mask,  foreground_color,
       background_color, x, y)
	       Display *display;
	       Pixmap source;
	       Pixmap mask;
	       XColor *foreground_color;
	       XColor *background_color;
	       unsigned int x, y;

       Cursor XCreateGlyphCursor(display, source_font, mask_font, source_char,
       mask_char, foreground_color, background_color)
	       Display *display;
	       Font source_font, mask_font;
	       unsigned int source_char, mask_char;
	       XColor *foreground_color;
	       XColor *background_color;

ARGUMENTS
       Specifies the RGB values for the background of the  source.   Specifies
       the connection to the X server.	Specifies the RGB values for the fore‐
       ground of the source.  Specifies the cursor's source bits  to  be  dis‐
       played or None.	Specifies the glyph character for the mask.  Specifies
       the font for the mask glyph or None.  Specifies the shape of  the  cur‐
       sor.   Specifies the shape of the source cursor.	 Specifies the charac‐
       ter glyph for the source.  Specifies the font  for  the	source	glyph.
       Specify the x and y coordinates, which indicate the hotspot relative to
       the source's origin.

DESCRIPTION
       X provides a set of standard cursor shapes in a special font named cur‐
       sor.   Applications are encouraged to use this interface for their cur‐
       sors because the font can be  customized	 for  the  individual  display
       type. The shape argument specifies which glyph of the standard fonts to
       use.

       The hotspot comes from the information stored in the cursor  font.  The
       initial	colors	of  a  cursor are a black foreground and a white back‐
       ground (see XRecolorCursor(3X11)).

       XCreateFontCursor can generate BadAlloc and BadValue errors.

       The XCreatePixmapCursor function creates a cursor and returns the  cur‐
       sor  ID	associated  with  it. The foreground and background RGB values
       must be specified using foreground_color and background_color, even  if
       the  X server only has a StaticGray or GrayScale screen. The foreground
       color is used for the pixels set to 1 in the source, and the background
       color  is used for the pixels set to 0. Both source and mask, if speci‐
       fied, must have depth one (or a BadMatch error results)	but  can  have
       any root. The mask argument defines the shape of the cursor. The pixels
       set to 1 in the mask define which source pixels are displayed, and  the
       pixels  set  to 0 define which pixels are ignored. If no mask is given,
       all pixels of the source are displayed. The mask, if present,  must  be
       the  same  size as the pixmap defined by the source argument, or a Bad‐
       Match error results. The hotspot must be a point within the source,  or
       a BadMatch error results.

       The  components	of  the	 cursor can be transformed arbitrarily to meet
       display limitations. The pixmaps can be freed immediately if no further
       explicit	 references  to them are to be made. Subsequent drawing in the
       source or mask pixmap has an undefined effect  on  the  cursor.	The  X
       server might or might not make a copy of the pixmap.

       XCreatePixmapCursor can generate BadAlloc and BadPixmap errors.

       The  XCreateGlyphCursor	function  is  similar  to  XCreatePixmapCursor
       except that the source and mask bitmaps are obtained from the specified
       font glyphs. The source_char must be a defined glyph in source_font, or
       a BadValue error results. If mask_font is given, mask_char  must	 be  a
       defined	glyph in mask_font, or a BadValue error results. The mask_font
       and  character  are  optional.  The  origins  of	 the  source_char  and
       mask_char  (if defined) glyphs are positioned coincidentally and define
       the hotspot. The source_char and	 mask_char  need  not  have  the  same
       bounding	 box  metrics, and there is no restriction on the placement of
       the hotspot relative to the bounding boxes. If no mask_char  is	given,
       all  pixels of the source are displayed. You can free the fonts immedi‐
       ately by calling XFreeFont if no further explicit  references  to  them
       are to be made.

       For  2-byte  matrix  fonts,  the 16-bit value should be formed with the
       byte1 member in the most significant byte and the byte2 member  in  the
       least significant byte.

       XCreateGlyphCursor can generate BadAlloc, BadFont, and BadValue errors.

DIAGNOSTICS
       The  server failed to allocate the requested resource or server memory.
       A value for a Font or GContext argument does not name a	defined	 Font.
       Some  argument  or pair of arguments has the correct type and range but
       fails to match in some other way required by the request.  A value  for
       a  Pixmap  argument does not name a defined Pixmap.  Some numeric value
       falls outside the range of values accepted by  the  request.  Unless  a
       specific	 range is specified for an argument, the full range defined by
       the argument's type is accepted.	 Any argument  defined	as  a  set  of
       alternatives can generate this error.

SEE ALSO
       XDefineCursor(3X11), XLoadFont(3X11), XRecolorCursor(3X11)

       Xlib -- C Language X Interface

						       XCreateFontCursor(3X11)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net