https://wiki.delphigl.com/index.php?action=history&feed=atom&title=glXCreateContext 2026-05-25T09:28:29Z Versionsgeschichte dieser Seite in DGL Wiki MediaWiki 1.27.4 https://wiki.delphigl.com/index.php?title=glXCreateContext&diff=22089&oldid=prev 2008-08-15T22:25:24Z

<p>Die Seite wurde neu angelegt: = glXCreateContext = == Name == &#039;&#039;&#039;glXCreateContext&#039;&#039;&#039; - Erzeugt einen neuen GLX-<a href="/index.php/Renderkontext" title="Renderkontext">Renderkontext</a>. == Delphi-Spezifikation == function &#039;&#039;&#039;glXCreateContext&#039;&#039;&#039;(&#039;&#039;...</p> <p><b>Neue Seite</b></p><div>= glXCreateContext =<br /> <br /> <br /> <br /> == Name ==<br /> '''glXCreateContext''' - Erzeugt einen neuen GLX-[[Renderkontext]].<br /> <br /> <br /> <br /> == Delphi-Spezifikation ==<br /> function '''glXCreateContext'''(''dpy'': PDisplay; ''vis'': PXVisualInfo; ''shareList'': GLXContext; ''direct'': Boolean): GLXContext;<br /> <br /> <br /> <br /> == Parameter ==<br /> <br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''dpy'' <br /> | Gibt die Verbindung zum X-Server an<br /> |-<br /> ! ''vis'' <br /> | Gibt ein Visual an, dass die für den Renderkontext verfügbaren Framebufferressourcen angibt. Dies ist ein Zeiger auf eine XVisualInfo-Struktur, keine Visual-ID und auch kein Zeiger auf ein Visual.<br /> |-<br /> ! ''shareList'' <br /> | Gibt den Kontext an, mit dem [[Displayliste]]n geteilt werden sollen. Ist dieser Wert '''nil''', so heißt dies, dass keine Displaylisten mit einem anderen Kontext geteilt werden.<br /> |-<br /> ! ''direct'' <br /> | Gibt an, ob das Rendern über eine direkte Verbindung zum Grafiksystem stattfinden soll, sofern möglich ('''True''') oder über den X-Server ('''False''')<br /> |}<br /> <br /> <br /> <br /> == Beschreibung ==<br /> Die Funktion '''glXCreateContext''' erzeugt einen GLX-[[Renderkontext]] und gibt dessen Handle zurück. Dieser Kontext kann genutzt werden, um sowohl in Fenster als auch in GLX-Pixmaps zu rendern. Falls '''glXCreateContext''' keinen Renderkontext erzeugen kann, wird '''nil''' zurückgegeben.<br /> <br /> Wenn ''direct'' den Wert '''True''' hat, dann wird ein direkter Renderkontext erzeugt, falls die Implementierung direktes Rendern unterstützt, die Verbindung zu einem lokalen X-Server führt und ein direkter Renderkontext verfügbar ist. (Eine Implementierung darf jedoch auch einen indirekten Renderkontext zurückgeben, wenn ''direct'' den Wert '''True''' hat.) Falls ''direct'' den Wert '''False''' hat, dann wird immer ein Renderkontext erzeugt, der über den X-Server rendert. Direktes Rendern bietet in einigen Implementierungen einen Geschwindigkeitsvorteil. Jedoch können direkte Renderkontexte nicht außerhalb eines einzelnen Prozesses geteilt werden und sie sind möglicherweise nicht in der Lage, in GLX-Pixmaps zu rendern.<br /> <br /> Falls ''shareList'' nicht den Wert '''nil''' hat, dann werden alle Displaylistenindizes und -definitionen zwischen dem Kontext ''shareList'' und dem neu erzeugten Kontext geteilt. Eine beliebige Anzahl von Kontexten kann einen einzelnen Displaylistenraum teilen. Jedoch müssen alle Renderkontexte, die einen einzelnen Displaylistenraum teilen, selbst im gleichen Adressraum existieren. Zwei Renderkontexte befinden sich im gleichen Adressraum, wenn sie beide nicht-direkt sind und den gleichen Server benutzen, oder falls beide direkt sind und zum gleichen Prozess gehören. Im nicht-direkten Fall ist es nicht notwendig, dass die aufrufenden Threads den gleichen Adressraum haben, sondern nur dass die zugehörigen Renderkontexte im gleichen Adressraum existieren.<br /> <br /> Wenn die GL-Version 1.1 oder höher ist, dann werden alle Texturobjekte außer dem Objekt 0 zwischen Kontexten, die die gleichen Displaylisten haben, geteilt.<br /> <br /> <br /> <br /> == Hinweise ==<br /> XVisualInfo ist im Header ''Xutil.h'' definiert, es handelt sich dabei um eine Struktur, die die Elemente ''visual'', ''visualID'', ''screen'' und ''depth'' enthält.<br /> <br /> Ein ''Prozess'' ist eine einzelne Ausführungsumgebung, welche in einem einzelnen Adressraum implementiert ist und aus einem oder mehreren Threads besteht.<br /> <br /> Ein ''Thread'' ist einer aus einer Menge von Unterprozessen, doe den gleichen Adressraum haben, aber getrennte Programmzähler, Stacks und andere damit in Verbindung stehende, globale Daten haben. Ein ''Thread'', welcher das einzige Element seiner Unterprozessgruppe ist, ist äquivalent zu einem ''Prozess''.<br /> <br /> Es ist ggf. nicht möglich, mit einem direkten Renderkontext in eine GLX-Pixmap zu rendern.<br /> <br /> <br /> <br /> == Fehlermeldungen ==<br /> '''nil''' wird zurückgegeben, wenn die Ausführung auf der Klientseite scheitert.<br /> <br /> '''BadAlloc''' wird generiert, falls der Server nicht genug Ressourcen hat, um einen neuen Kontext anzulegen.<br /> <br /> '''BadMatch''' wird generiert, falls der zu erzeugende Kontext nicht den gleichen Adressraum oder Bildschirm wie der durch ''shareList'' angegebene Kontext hat.<br /> <br /> '''BadValue''' wird generiert, wenn ''vis'' kein gültiges Visual ist (z.B. wenn eine bestimmte GLX-Implementierung dies nicht unterstützt).<br /> <br /> '''GLXBadContext''' wird generiert, falls ''shareList'' kein GLX-Kontext ist und nicht '''nil''' ist.<br /> <br /> <br /> <br /> == Siehe auch ==<br /> [[glXDestroyContext]], [[glXGetConfig]], [[glXIsDirect]], [[glXMakeCurrent]]<br /> <br /> [[Kategorie:GLX|CreateContext]]</div>

Thoronador