NAME

glXCreateGLXPixmap - create an off-screen GLX rendering area

C SPECIFICATION

GLXPixmap ggllXXCCrreeaatteeGGLLXXPPiixxmmaapp( Display _*_d_p_y,
                              XVisualInfo _*_v_i_s,
                              Pixmap _p_i_x_m_a_p )

delim $$

PARAMETERS

_d_p_y
Specifies the connection to the X server.
_v_i_s
Specifies the visual that defines the structure of the rendering area. It is a pointer to an XXVViissuuaallIInnffoo structure, not a visual ID or a pointer to a VViissuuaall.
_p_i_x_m_a_p
Specifies the X pixmap that will be used as the front left color buffer of the off-screen rendering area.

DESCRIPTION

ggllXXCCrreeaatteeGGLLXXPPiixxmmaapp creates an off-screen rendering area and returns its XID. Any GLX rendering context that was created with respect to _v_i_s can be used to render into this off-screen area. Use ggllXXMMaakkeeCCuurrrreenntt to associate the rendering area with a GLX rendering context.

The X pixmap identified by _p_i_x_m_a_p is used as the front left buffer of the resulting off-screen rendering area. All other buffers specified by _v_i_s, including color buffers other than the front left buffer, are created without externally visible names. GLX pixmaps with double-buffering are supported. However, ggllXXSSwwaappBBuuffffeerrss is ignored by these pixmaps.

Some implementations may not support GLX pixmaps with direct rendering contexts.

NOTES

XXVViissuuaallIInnffoo is defined in _X_u_t_i_l_._h_. It is a structure that includes _v_i_s_u_a_l, _v_i_s_u_a_l_I_D, _s_c_r_e_e_n, and _d_e_p_t_h elements.

ERRORS

BBaaddMMaattcchh is generated if the depth of _p_i_x_m_a_p does not match the depth value reported by core X11 for _v_i_s, or if _p_i_x_m_a_p was not created with respect to the same screen as _v_i_s.

BBaaddVVaalluuee is generated if _v_i_s is not a valid XVisualInfo pointer (for example, if a particular GLX implementation does not support this visual).

BBaaddPPiixxmmaapp is generated if _p_i_x_m_a_p is not a valid pixmap.

BBaaddAAlllloocc is generated if the server cannot allocate the GLX pixmap.

SEE ALSO

ggllXXCCrreeaatteeCCoonntteexxtt, ggllXXIIssDDiirreecctt, ggllXXMMaakkeeCCuurrrreenntt