XCreatePixmap

Aus DGL Wiki
Wechseln zu: Navigation, Suche

XCreatePixmap

Name

XCreatePixmap - Erzeugt eine Pixmap.


Delphi-Spezifikation

function XCreatePixmap(dpy: PDisplay; d: Drawable; width, height, depth: Cardinal): Pixmap;


Parameter

dpy Gibt die Verbindung zum X-Server an
d Gibt an, auf welchem Bildschirm die Pixmap erstellt wird
width Gibt die Breite der Pixmap an
height Gibt die Höhe der Pixmap an
depth Gibt die Tiefe der Pixmap an


Beschreibung

Die Funktion XCreatePixmap erzeugt eine Pixmap mit der angegebenen Breite width, der Höhe height und Tiefe depth, und gibt dann die zugehörige Pixmap-ID zurück. Es ist erlaubt, ein InputOnly-Fenster als Argument für die Zeichenfläche d zu übergeben. Die Parameter width und height müssen beide von null verschieden sein, oder es wird ein BadValue-Fehler generiert. Für das Argument depth muss ein Wert übergeben werden, der vom Bildschirm der Zeichenfläche d unterstützt wird, oder es wird ein BadValue-Fehlerstatus generiert.

Der Server benutzt die angegebene Zeichenfläche d, um zu bestimmen, auf welchem Bildschirm die Pixmap erzeugt wird. Die Pixmap kann dann nur auf diesem Bildschirm und nur von Zeichenflächen mit der gleichen Tiefe verwendet werden. (Siehe XCopyPlane für Ausnahmen von dieser Regel.) Der anfängliche Inhalt der Pixmap ist nicht definiert.


Fehlermeldungen

BadAlloc wird generiert, wenn eine angeforderte Ressource oder der nötige Speicher nicht angelegt werden konnte.

BadDrawable wird generiert, falls d keine gültige Zeichenfläche bzw. kein gültiges Fenster angibt.

BadValue wird generiert, wenn width oder height den Wert null hat oder falls für depth ein nicht unterstützter Tiefenwert angegeben ist (sprich wenn ein numerischer Wert außerhalb des akzeptablen Bereiches liegt).


Siehe auch

XCopyArea, XFreePixmap