Dateikopf

Die Kopfzeile besteht aus einem C-Kommentar /* XPM */. Dieser dient als Magische Zahl, um XPM-Dateien erkennen zu können.

Deklarationszeile

Die nächste Zeile ist die sogenannte Deklarationszeile, welche eine Variablendeklaration in C darstellt. Der Variablenname kann dabei beliebig sein, er muss ein gültiger C-Bezeichner sein. Normalerweise wird hierfür der Name der Bilddatei verwendet:

static char* bildname[] = {

Werte-Zeile

Die Werte-Zeile enthält vier bzw. sechs Dezimalzahlen mit folgenden Bedeutungen:

1. Breite des Bildes (in Pixel)
2. Höhe des Bildes (in Pixel)
3. Anzahl der Farben im Bild
4. Anzahl der Zeichen pro Pixelwert
5. (X-Position des „Hotspots“)
6. (Y-Position des „Hotspots“)

Die letzten beiden Werte geben die Position eines so genannten „Hotspots“ an. Dies ist etwa bei Mauscursorn der Punkt, auf den der Mauspfeil „zeigt“. Bei normalen Bildern wird dieser Wert nicht benötigt und kann entfallen.

Besitzt die XPM-Datei Erweiterungen (engl. extensions), so folgt auf die letzte Zahl der Werte-Zeile das Wort XPMEXT.

Farbdefinitionen

Anschließend folgen mehrere Zeilen, die jeweils eine Farbe im Bild definieren. Die Anzahl dieser Farbdefinitionen geht aus dem dritten Wert der Wertezeile hervor.

Jede Farbdefinition besteht aus einem Zeichencode. Die Länge des Zeichencodes geht aus dem vierten Wert der Wertezeile hervor. Nach einem Leerzeichen folgen eine oder mehrere Farbdefinitionen, die dem Zeichencode eine Farbe zuordnen. Resultierend aus dem ursprünglichen Verwendungszweck von XPM als Dateiformat für Icons, können für verschiedene Darstellungsarten unterschiedliche Farbdefinitionen angegeben werden. Dies hat den Vorteil, dass die Darstellung für verschiedene Farbtiefen optimiert werden kann und nicht aus einer farbigen Darstellung eine Schwarzweißdarstellung errechnet zu werden braucht.

Folgende Darstellungsarten werden unterstützt:

c: Farbig

g4: Vier Graustufen

g: Mehr als vier Graustufen

m: Monochrom (Schwarzweiß)

s: Symbolisch (damit kann eine Farbe einen symbolischen Wert bekommen, etwa „Hintergrund“ oder „Vordergrund“. Die Auswertung dieser Symbolinformationen ist abhängig vom verwendeten Programm)

Auf diese Angabe folgt dann die eigentliche Farbdefinition. Diese kann aus einem symbolischen Namen bestehen (z. B. „white“, „red“), eine Farbe im RGB-Farbraum als hexadezimale Farbdefinition (#RRGGBB) oder im HSV-Farbraum (%HHSSVV). Soll eine Farbe als „transparent“ gekennzeichnet sein, so ist die Farbe auf None zu setzen.

Beispiel:

"A c red    m black g gray50 s foreground",
"B c yellow m white g gray80 s background",
"# c black  m black g gray10 s border",

Bilddaten

Nach den Farbdefinitionen folgen die Bilddaten. Diese sind zeilenweise von oben nach unten, in einer Zeile von links nach rechts abgespeichert. Jede Bildzeile wird in einer Textzeile in der XPM-Datei abgespeichert. Pro Bildpunkt wird – abhängig vom oben angegebenen Wert – ein oder mehrere Zeichen benutzt. Diese Notation hat zur Folge, dass sich einfache Bilder bereits im Quellcode erkennen lassen, siehe ASCII-Art.

Erweiterungen

Sofern in der Werte-Zeile das Vorhandensein von Erweiterungen angezeigt worden ist, folgen auf die Bilddaten Erweiterungs-Zeilen, die stets folgendes Format haben:

• Einzeilige Erweiterungsdaten:

"XPMEXT extension_name extension_value"

• Mehrzeilige Erweiterungsdaten:

"XPMEXT extension_name",

"data",

…

Es ist nicht spezifiziert, wie das Ende von mehrzeiligen Erweiterungsdaten gekennzeichnet werden soll.

Die XPM-Spezifikation empfiehlt zur Vermeidung von Namenskollisionen, die Namen der Erweiterung mit dem Firmennamen beginnen zu lassen. Sie lässt allerdings offen, wie dieser im Detail aussehen soll.

Das Ende des gesamten Erweiterungs-Blocks wird durch eine Zeile angezeigt, die nur den Inhalt XPMENDEXT hat.

Dateiende

Um die C-Deklaration abzuschließen, folgt am Dateiende eine Zeile mit der Zeichenfolge };.