pfuGLXWinopen(3pf) OpenGL Performer 3.2.2 libpfutil Reference Pages
NAME
pfuOpenXDisplay, pfuGLXWinopen, pfuGetGLXWin, pfuGetGLXDisplayString,
pfuGLXAllocColormap, pfuGLXMapcolors, pfuGLMapcolors, pfuMapWinColors,
pfuMapPWinColors, pfuPrintWinFBConfig, pfuPrintPWinFBConfig,
pfuChooseFBConfig - Open X display, open GLX window, get GLX window
handle.
FUNCTION SPECIFICATION
#include <Performer/pfutil.h>
pfuXDisplay * pfuOpenXDisplay(int screen);
pfuGLXWindow * pfuGLXWinopen(pfPipe *pipe, pfPipeWindow* pipewin,
const char *name);
void pfuGetGLXWin(pfPipe *pipe, pfuGLXWindow *win);
const char * pfuGetGLXDisplayString(pfPipe *pipe);
int pfuGLXAllocColormap(pfuXDisplay *dsp, pfuXWindow win);
void pfuGLXMapcolors(pfuXDisplay *dsp, pfuXWindow win,
pfVec3 *colors, int loc, int num);
void pfuGLMapcolors(pfVec3 *colors, int loc, int num);
void pfuMapWinColors(pfWindow *win, pfVec3 *colors, int loc,
int num);
void pfuMapPWinColors(pfPipeWindow *pwin, pfVec3 *colors,
int loc, int num);
void pfuPrintWinFBConfig(pfWindow *win, FILE *file);
void pfuPrintPWinFBConfig(pfPipeWindow *pwin, FILE *file);
pfFBConfig pfuChooseFBConfig(Display *dsp, int screen,
int *constraints, void *arena);
typedef Window pfuXWindow;
typedef uint pfuXDisplay;
typedef struct _pfuGLXWindow
{
pfPipeWindow *pw;
pfuXDisplay *dsp;
pfuXWindow xWin;
pfuXWindow glWin;
pfuXWindow overWin;
} pfuGLXWindow;
Page 1
pfuGLXWinopen(3pf) OpenGL Performer 3.2.2 libpfutil Reference Pages
DESCRIPTION
pfuInitUtil should be called immediately after pfConfig when using these
routines to initialize shared memory used by the utility library.
pfuOpenXDisplay opens and returns a handle to a connection to the X
server on screen. If screen is 1, then the default display, or that
specified by the shell environment variable DISPLAY is used.
pfuOpenXDisplay returns NULL if the X display cannot be opened. These
routines are provided only for compatibility with previous OpenGL
Performer releases and new development should use the window system
utilities in libpr, such as pfOpenWSConnection and pfOpenScreen.
pfuGLXWinopen opens and returns a handle to a GLX window for pfPipe pipe,
using the existing pfPipeWindow pipewin or making a new pfPipeWindow for
pipe if pipewin is NULL. The window's title bar is set to name.
pfuGetGLXWin returns a handle in win to the GLX window for pfPipe pipe,
and returns NULL if no such window can be found.
pfuGetGLXDisplayString returns the name of the X Display stored for pipe.
pfuGLXAllocColormap allocates color map entries for the window specified
in win and returns the number of colors available. dsp is win's
connection to the X server.
pfuGLMapcolors replaces num IRIS GL color map entries. win, starting at
color map index loc. The colors array contains the color values to map,
normalized in the range [0, 1]. The red component is stored in
colors[i][0], the green component in colors[i][1], and the blue component
in colors[i][2]. This function is no longer supported.
pfuGLXMapcolors replaces num color map entries in the X window win,
starting at color map index loc. dsp is a valid X connection. The
colors array contains the color values to map, normalized in the range
[0, 1]. The red component is stored in colors[i][0], the green component
in colors[i][1], and the blue component in colors[i][2].
pfuMapWinColors replaces num color map entries in the pfWindow win,
starting at color map index loc. win can be a GLX, or OpenGL/X window.
The colors array contains the color values to map, normalized in the
range [0, 1]. The red component is stored in colors[i][0], the green
component in colors[i][1], and the blue component in colors[i][2].
pfuMapPWinColors is the analogous routine for pfPipeWindows.
pfuPrintWinFBConfig prints the framebuffer configuration of the pfWindow,
win, to the specified file file. If file is NULL, stderr is used.
pfuPrintPWinFBConfig prints the framebuffer configuration of the
pfPipeWindow, pwin, to the specified file file.
pfuChooseFBConfig is an OpenGL X framebuffer configuration chooser for
selecting X Visuals for OpenGL/X windows. This chooser limits
performance critical attributes: multisamples, size of depth buffer, RGB
Page 2
pfuGLXWinopen(3pf) OpenGL Performer 3.2.2 libpfutil Reference Pages
color, and stencil. If the provided pfWSConnection is NULL, the current
pfWSConnection libpr will be used. See the pfGetCurWSConnection
reference page for more information. If the provided screen is (-1), the
default screen of the pfWSConnection will be used.
NOTES
The libpfutil source code, object code and documentation are provided as
unsupported software. Routines are subject to change in future releases.
SEE ALSO
pfuInitUtil, pfMultipipe
Page 3
