XCreatePixmap
Inhaltsverzeichnis
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).
