📄 xcmsquerycolors.html
字号:
<HTML><HEAD><TITLE>Xlib Programming Manual: XcmsQueryColors</TITLE></HEAD><BODY><H1 ALIGN=center>XcmsQueryColors</H1><H2>Syntax</H2><!.IN "Color" "querying"><!.IN "XcmsQueryColors" "" "@DEF@"><CODE><PRE><B><A HREF="conversion-contexts-and-gamut-mapping.html#cmsStatus">Status</A></B> XcmsQueryColors(<B>display</B>, <B>colormap</B>, <B>colors_in_out</B>, <B>ncolors</B>, <B>result_format</B>) <A HREF="../display/opening.html#Display">Display</A> *<B>display</B>; <A HREF="./#colormap">Colormap</A> <B>colormap</B>; <A HREF="structures.html#XcmsColor">XcmsColor</A> <B>colors_in_out</B>[]; unsigned int <B>ncolors</B>; <A HREF="structures.html#XcmsColor">XcmsColorFormat</A> <B>result_format</B>;</PRE></CODE><H2>Arguments</H2><TABLE><TR><TD> <B>display</B><TD> Specifies the connection to the X server.<TR><TD> <B>colormap</B><TD> Specifies the colormap.<TR><TD> <B>colors_in_out</B><TD> Specifies an array of<A HREF="structures.html#XcmsColor">XcmsColor</A>structures, each pixel member indicating the color cell to query.The color specifications for the color cells are returned in these structures.<TR><TD> <B>ncolors</B><TD> Specifies the number of <A HREF="structures.html#XcmsColor">XcmsColor</A>structures in the color specification array.<TR><TD> <B>result_format</B><TD> Specifies the color format for the returned color specification.</TABLE><H2>Description</H2>The<B>XcmsQueryColors()</B>function obtains the RGB valuesfor pixel values in the pixel members of<A HREF="structures.html#XcmsColor">XcmsColor</A>structures and thenconverts the values to the target format asspecified by the result_format argument.If a pixel is not a valid index into the specified colormap, a<B>BadValue</B>error results.If more than one pixel is in error,the one that gets reported is arbitrary.<P><B>XcmsQueryColors()</B>can generate<B>BadColor</B>and<B>BadValue</B>errors.<H2>Diagnostics</H2><TABLE><TR><TD><B>BadColor</B><TD> A value for a Colormap argument does not name a defined Colormap.<TR><TD><B>BadValue</B><TD> 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.</TABLE><H2>See also</H2><B><A HREF="XcmsAllocColor.html">XcmsAllocColor()</A></B>,<B><A HREF="XcmsLookupColor.html">XcmsLookupColor()</A></B>,<B><A HREF="XcmsQueryColor.html">XcmsQueryColor()</A></B>,<B><A HREF="XcmsStoreColor.html">XcmsStoreColor()</A></B>,"<A HREF="modifying-and-querying-cells.html">Modifying and Querying Colormap Cells</A>".<HR><ADDRESS><A HREF="http://tronche.com/">Christophe Tronche</A>, <A HREF="mailto:ch.tronche@computer.org">ch.tronche@computer.org</A></ADDRESS></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -