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

FreeBSD Manual Pages

  
 
  

home | help
XcupStoreColors(3)		  X FUNCTIONS		    XcupStoreColors(3)

NAME
       XcupStoreColors - initialize shareable colormap entries at specific lo-
       cations

SYNOPSIS
       cc [ flag ... ] file ...	-lXext [ library ... ]
       #include	<X11/extensions/Xcup.h>

       Status XcupStoreColors(Display *display,	Colormap colormap,
	      XColor *colors_in_out, int ncolors);

ARGUMENTS
       display	 Specifies the connection to the X server

       colormap	 Specifies the colormap

       colors_in_out
		 Specifies and returns the values actually used	 in  the  col-
		 ormap

       ncolors	 Specifies the number of items in colors_in_out

DESCRIPTION
       The  XcupStoreColors function changes the colormap entries of the pixel
       values in the pixel members of the XColor structures. The colormap  en-
       tries are allocated as if an AllocColor has been	used instead, i.e. the
       colors are read-only (shareable).  XcupStoreColors returns  the	number
       of colors that were successfully	allocated in the colormap.

       A  Value	 error	is  generated if a pixel is not	a valid	index into the
       colormap. A BadMatch error is generated if the colormap does not	belong
       to a GrayScale, PseudoColor, or DirectColor visual.

       Applications which allocate many	colors in a screen's default colormap,
       e.g.  a color-cube or a gray-ramp, should allocate them with XCupStore-
       Colors.	By using XCupStoreColors the colors will be allocated sharable
       (read-only) and any other application which allocates  the  same	 color
       will share that color cell.

SEE ALSO
       XcupQueryVersion(3Xext),	XcupGetReservedColormapEntries(3Xext),
       Colormap	Utilization Policy and Extension

X Version 11			 libXext 1.3.3		    XcupStoreColors(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XcupStoreColors&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help