1991-2006 Silicon Graphics, Inc.
glXCreateWindow 3G
glXCreateWindow create an on-screen rendering area

## C Specification

GLXWindow `glXCreateWindow` Display * dpy GLXFBConfig config Window win const int * attrib_list

## Parameters

dpy

  Specifies the connection to the X server.

config

  Specifies a GLXFBConfig structure with the desired attributes for the window.

win

  Specifies the X window to be used as the rendering area.

attrib_list

  Currently unused. This must be set to `NULL` or be an empty list (i.e., one in which the first element is `None`).

## Description

`glXCreateWindow` creates an on-screen rendering area from an existing X window that was created with a visual matching config. The XID of the GLXWindow is returned. Any GLX rendering context that was created with respect to config can be used to render into this window. Use glXMakeContextCurrent to associate the rendering area with a GLX rendering context.

## Notes

`glXCreateWindow` is available only if the GLX version is 1.3 or greater.

If the GLX version is 1.1 or 1.0, the GL version must be 1.0. If the GLX version is 1.2, then the GL version must be 1.1. If the GLX version is 1.3, then the GL version must be 1.2.

## Errors

`BadMatch` is generated if win was not created with a visual that corresponds to config.

`BadMatch` is generated if config does not support rendering to windows (i.e., `GLX_DRAWABLE_TYPE` does not contain `GLX_WINDOW_BIT`).

`BadWindow` is generated if win is not a valid pixmap XID.

`BadAlloc` is generated if there is already a GLXFBConfig associated with win.

`BadAlloc` is generated if the X server cannot allocate a new GLX window.

`GLXBadFBConfig` is generated if config is not a valid GLXFBConfig.

## See Also

glXChooseFBConfig, glXDestroyPixmap, glXMakeContextCurrent

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.