glXImportContextEXT

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glXImportContextEXT

Name

glXImportContextEXT - Importiert den indirekten Renderkontext eines anderen Prozesses.


Delphi-Spezifikation

function glXImportContextEXT(dpy: PDisplay; contextID: GLXContextID): GLXContext;


Parameter

dpy Gibt die Verbindung zum X-Server an
Parameter2 Gibt einen GLX-Renderkontext an


Beschreibung

Die Funktion glXImportContextEXT erzeugt einen GLXContext mit der gegebenen XID eines existierenden GLXContext. Die Funktion kann an Stelle von glXCreateContext genutzt werden, um den sich indirekten Renderkontext eines anderen Prozesses zu teilen.

Nur die serverseitigen Kontextinformationen können zwischen X-Klienten geteilt werden; klientseitige Zustände, wie die Pixelspeichermodi, können nicht geteilt werden. Daher muss glXImportContextEXT Speicher allokieren, um die klientseitigen Informationen zu speichern. Dieser Speicher wird durch einen Aufruf von glXFreeContextEXT freigegeben.

Der Funktionsaufruf erzeugt keine neue XID. Er macht vielmehr nur ein existierendes Objekt für den importierenden Klienten verfügbar. Wie jede XID verschwindet diese, wenn der erzeugende Klient seine Verbindung beendet oder die ID explizit gelöscht wird. Zu beachten ist, dass dies passiert, wenn die XID verschwindet. Das Objekt verschwindet, wenn die XID verschwindet UND der Kontext nicht aktueller Kontext irgendeines Threads ist.

Wenn sich contextID auf einen direkten Renderkontext bezieht, dann wird kein Fehler erzeugt, aber glXImportContextEXT gibt nil zurück.


Hinweise

glXImportContextEXT ist Bestandteil der Erweiterung EXT_import_context und gehört nicht zu den GLX-Kernbefehlen. Falls EXT_import_context in der von glXQueryExtensionsString zurückgelieferten Zeichenkette enthalten ist, dann wird die Erweiterung EXT_import_context unterstützt.


Fehlermeldungen

GLXBadContext wird generiert, wenn sich contextID auf keinen gültigen Kontext bezieht.


Zugehörige Wertrückgaben

glXQueryExtensionsString zur Abfrage der Verfügbarkeit der Erweiterung EXT_import_context


Siehe auch

glXCreateContext, glXFreeContextEXT, glXGetContextIDEXT, glXQueryExtensionsString, glXQueryVersion