man-pages/man3/XdbeGetVisualInfo.3.html
2021-03-31 01:06:50 +01:00

171 lines
4.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XdbeGetVisualInfo</TITLE>
</HEAD><BODY>
<H1>XdbeGetVisualInfo</H1>
Section: X FUNCTIONS (3)<BR>Updated: libXext 1.3.4<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
XdbeGetVisualInfo - Get dbe Visual Informations
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
#include &lt;<A HREF="file:///usr/include/X11/extensions/Xdbe.h">X11/extensions/Xdbe.h</A>&gt;
<P>
XdbeScreenVisualInfo *XdbeGetVisualInfo(
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Display&nbsp;&nbsp;*dpy,
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Drawable&nbsp;*screen_specifiers,
<BR>&nbsp;&nbsp;&nbsp;&nbsp;int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*num_screens)
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
This function returns information about which visuals support double
buffering. The argument
<I>num_screens</I>
specifies how many elements there are
in the
<I>screen_specifiers</I>
list. Each drawable in
<I>screen_specifiers</I>
designates a
screen for which the supported visuals are being requested. If
<I>num_screens</I>
is zero, information for all screens is requested. In this case, upon return
from this function,
<I>num_screens</I>
will be set to the number of screens that were
found. If an error occurs, this function returns NULL, else it returns a
pointer to a list of
<I>XdbeScreenVisualInfo</I>
structures of length
<I>num_screens.</I>
The nth
element in the returned list corresponds to the nth drawable in the
<I>screen_specifiers</I>
list, unless
<I>num_screens</I>
was passed in with the value zero,
in which case the nth element in the returned list corresponds to the nth screen
of the server, starting with screen zero. The
<I>XdbeScreenVisualInfo</I>
structure has the following fields:
<P>
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;count
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;XdbeVisualInfo&nbsp;*visinfo
<P>
<I>count</I>
specifies the number of items in
<I>visinfo.</I>
<I>visinfo</I>
specifies a list of visuals, depths, and performance hints for this screen.
<P>
The
<I>XdbeVisualInfo</I>
structure has the following fields:
<P>
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VisualID&nbsp;visual
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;depth
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;perflevel
<P>
<I>visual</I>
specifies one visual ID that supports double-buffering.
<I>depth</I>
specifies the depth of the visual.
<I>perflevel</I>
is a performance hint.
<P>
The only operation defined on a
<I>perflevel</I>
is comparison to a
<I>perflevel</I>
of another visual on the same screen. The visual having the higher
<I>perflevel</I>
is likely to have better double-buffering graphics performance than the visual
having the lower
<I>perflevel.</I>
Nothing can be deduced from the following: the magnitude of the difference
of two
<I>perflevels,</I>
a
<I>perflevel</I>
value in isolation, or comparing
<I>perflevels</I>
from different servers.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>ERRORS</H2>
<DL COMPACT>
<DT id="1">BadDrawable<DD>
One or more values passed in
<I>screen_specifiers</I>
is not a valid drawable.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
DBE,
<I>XdbeAllocateBackBufferName(),</I>
<I>XdbeBeginIdiom(),</I>
<I>XdbeDeallocateBackBufferName(),</I>
<I>XdbeEndIdiom(),</I>
<I>XdbeFreeVisualInfo(),</I>
<I>XdbeGetBackBufferAttributes(),</I>
<I>XdbeQueryExtension(),</I>
<I>XdbeSwapBuffers().</I>
<P>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="5"><A HREF="#lbAE">ERRORS</A><DD>
<DT id="6"><A HREF="#lbAF">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:00 GMT, March 31, 2021
</BODY>
</HTML>