findvis(1G) findvis(1G)
NAME
findvis - list OpenGL-capable Visuals meeting selection criteria
SYNOPSIS
findvis [-1] [-id] [-display <display>] [-help] <specification>...
DESCRIPTION
findvis describes OpenGL-capable X11 Visuals that meet user-specified
selection criteria.
The options are as follows:
-1 List only the first matching Visual, rather than all
matching Visuals.
-id List only the Visual ID of matching Visuals, rather than a
one-line description of the Visual. This is particularly
useful in shell scripts, for passing a Visual ID to a
program without Visual-selection ability.
-display X11-display-name
Use the specified X11 display, rather than the default
display given by the environment variable DISPLAY.
-help Print a usage summary.
The selection criteria consist of C expressions involving attributes of
Visuals, plus sort keys that affect the order in which the Visuals will
be listed. Several criteria may be passed as a single argument, provided
they are separated by commas.
Expressions are composed of decimal and hexadecimal constants in the
usual C notation, plus the following operators with the usual C priority:
|| && < <= > >= == != + - * / % ! ( )
and the following variables:
a Number of bits in the color buffer alpha channel.
accuma Number of bits in the accumulation buffer alpha channel.
accumb Number of bits in the accumulation buffer blue channel.
accumg Number of bits in the accumulation buffer green channel.
accumr Number of bits in the accumulation buffer red channel.
accumrgb Minimum of accumr, accumg, and accumb. (This is usually
a more useful summary of accumulation buffer depth than
the total number of bits.)
Page 1
findvis(1G) findvis(1G)
accumrgba Minimum of accumr, accumg, accumb, and accuma.
aux Number of auxiliary color buffers.
b Number of bits in the color buffer blue channel.
ci Number of bits in the color-index buffer.
db 1 if the pixel format is double-buffered, 0 if single-
buffered.
g Number of bits in the color buffer green channel.
id Under X11, the Visual id of the pixel format.
level Less than zero for underlay planes, equal to zero for
main planes, and greater than zero for overlay planes.
main 1 if the pixel format applies to the main planes, 0 if
to underlay or overlay planes.
mono 1 if the pixel format is monoscopic, 0 if stereoscopic.
ms Number of samples per pixel (for multisample
antialiasing).
overlay 1 if the pixel format applies to overlay planes, 0
otherwise.
r Number of bits in the color buffer red channel.
rgb Minimum of r, g, and b. (As with accumrgb, this is
usually a better summary of color buffer depth than the
total number of color bits.)
rgba Minimum of r, g, b, and a.
s Number of bits in the stencil buffer.
sb 1 if the pixel format is single-buffered, 0 if double-
buffered.
slow 1 if the pixel format has the SLOW caveat (usually
meaning it doesn't support hardware acceleration), 0
otherwise.
stereo 1 if the pixel format is stereoscopic, 0 if monoscopic.
underlay 1 if the pixel format applies to underlay planes, 0
otherwise.
Page 2
findvis(1G) findvis(1G)
z Number of bits in the depth (aka ``Z'') buffer.
The operators are applied with normal C syntax and semantics. Take care
when using operators (especially ``!'') in expressions, since they are
metacharacters for most shells.
Sort keys consist of the word min or max followed by one of the variables
described above. Visuals with the largest (max) or smallest (min) values
of the given variable will be listed first. Whenever a variable is
specified as a sort key, only Visuals for which the variable is nonzero
will be considered. A final sort key of min id is always applied, no
matter what other sort keys may have been specified, so that Visuals will
be listed in order of their id numbers when all other keys are equal.
EXAMPLES
findvis rgb overlay
Display all rgb overlay Visuals, if any exist.
findvis 'max ci'
Display all color-index Visuals, sorted with the deepest Visuals
first.
findvis -1 -id 'db, max rgb, max z'
Display the Visual ID of the double-buffered Visual with largest RGB
and depth buffers.
findvis 'r != g || g != b'
Display Visuals in which the color channels are not all the same
size.
findvis 'max rgb, accumrgb >= 2 * rgb'
Display RGB Visuals that support an accumulation buffer at least
twice as deep as the main color buffer.
findvis 'id == 0x2c'
Display the Visual with id 0x2c.
findvis 'rgb, r % 2 || g % 2 || b % 2'
Display RGB Visuals with at least one odd-sized color channel.
findvis rgba ms s z
Select multisampled RGBA pixel formats with stencil and depth
buffers. The selected pixel formats will be sorted in the default
order (smallest Visual id first).
DIAGNOSTICS
Exit status is 0 if any matching Visuals are found, 1 if no matching
Visuals are found, and 2 if the specification string is syntactically
incorrect or if some other exception condition occurs.
Page 3
findvis(1G) findvis(1G)
SEE ALSO
glxinfo(1)
Page 4