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