glXCreateGLXPixmap

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glXCreateGLXPixmap

Name

glXCreateGLXPixmap - Erzeugt eine GLXPixmap.


Delphi-Spezifikation

function glXCreateGLXPixmap(dpy: PDisplay; vis: PXVisualInfo; _pixmap: Pixmap): GLXPixmap;


Parameter

dpy Gibt die Verbindung zum X-Server an.
vis Gibt das Visual an, welches die Struktur des Renderbereiches bestimmt. Es ist ein Zeiger auf eine XVisualInfo-Struktur, keine Visual-ID oder ein Zeiger auf ein Visual.
_pixmap Gibt die X-Pixmap an, welche als linker Frontbuffer der GLXPixmap genutzt wird


Beschreibung

Die Funktion glXCreateGLXPixmap erzeugt eine GLXPixmap und gibt deren XID zurück. Jeder GLX-Renderkontext, der mit vis erzeugt wurde, kann genutzt werden, um in diese Pixmap zu rendern. Nutzen Sie glXMakeCurrent, um einen Renderbereich mit einem GLX-Renderkontext zu verknüpfen.

Die durch _pixmap angegebene X-Pixmap wird als linker Frontbuffer des resultierenden Off-Screen-Renderbereiches genutzt. Alle anderen Puffer, einschließlich der Farbpuffer außer dem linken Frontbuffer, werden ohne extern sichtbare Namen erzeugt. GLX-Pixmaps mit Doppelpufferung werden unterstützt. Jedoch wird glXSwapBuffers von diesen Pixmaps ignoriert.

Einige Implementierungen unterstützen möglicherweise keine GLX-Pixmaps mit direktem Renderkontext.


Hinweise

XVisualInfo ist im Header Xutil.h definiert. Diese Struktur enthält die Elemente visual, visualID, screen und depth.


Fehlermeldungen

BadAlloc wird generiert, wenn der X-Server die GLXPixmap nicht anlegen kann.

BadPixmap wird generiert, falls _pixmap keine gültige X-Pixmap ist.

BadMatch wird generiert, wenn die Tiefe von _pixmap nicht mit dem von X11-Kern zurückgelieferten Wert für vis übereinstimmt, oder falls _pixmap nicht für den selben Bildschirm erzeugt wurde wie vis.

BadValue wird generiert, wenn vis kein gültiger XVisualInfo-Zeiger ist (zum Beispiel wenn eine GLX-Implementierung dieses Visual nicht unterstützt).


Siehe auch

glXCreateContext, glXCreatePixmap, glXDestroyGLXPixmap, glXIsDirect, glXMakeCurrent