DTPMFILE(4)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

🎀 NAME 🎀

okay so bestie, welcome to dtpmfile(special file) — the manual page for the format of X Pixmap (XPM) format desktop icon files. Yes, that exact phrase. Sit down, hydrate, and let’s talk pixel lore. 💖

✨ SYNOPSIS ✨

Here’s the shape of it, no cap:

           /* XPM */
           static char * icon_name[] = {
           "width height num_colors chars_per_pixel [x_hot y_hot]",
           "char {key color}+",
           ...
           " pixels ",
           ...
           };

💖 DESCRIPTION 💖

Pixmap icons are multi-color images based on the XPM (X PixMap) format. A pixmap file is an ASCII file, which means it can be read and modified by hand — not just with color pixmap editors (like the Icon Editor). Obsessed, honestly. 🦋

The XPM format was designed specifically for small "icon" images. XPM files can be included directly in C source code, so the file data is in the form of a pixmap structure variable. A pixmap file can be broken down into three main components: generic pixmap information, pixmap colors, and the actual pixmap data. periodt.

🌸 generic pixmap information

The generic pixmap file contains this info:

  • pixmap name
  • pixmap width
  • pixmap height
  • number of colors used in pixmap
  • number of characters per pixel
  • x hot-spot and y hot-spot (optional)

🎨 pixmap colors

Each color used in the pixmap is defined by a string containing:

  • character(s) used to represent this color in pixmap data
  • symbolic name for this color
  • mono visual to use for this color (that is, black/white)
  • color visual by name ("red") or RGB value ("#9696c8c8afaf")
  • gray scale visuals (most CDE icons do not include gray scale data)

🖼️ actual pixmap data

The data itself is simply strings of symbols representing colors. There is one string per column of the pixmap, and this data will resemble the actual icon. iykyk. ✨

🫶 RETURN VALUE 🫶

None. That’s it. No dramatic return arc, bestie. 😭

🔥 EXAMPLES 🔥

The following is a pixmap that can be used to represent an executable file. The icon has a 3-D border around it and contains a lightning bolt. Icon main character energy, fr fr. ⚡

       static char ** execute = {
       "22 22 7 1",
       "R s iconGray1 m white c #e1e1e1e1e1e1",
       "B s iconGray3 m white c #afafafafafaf",
       "~ s iconColor6 m white c yellow",
       "Y s iconColor1 m black c black",
       "X s iconGray2 m white c #c8c8c8c8c8c8",
       "+ s iconGray7 m black c #4b4b4b4b4b4b",
       "@ s iconGray5 m black c #7d7d7d7d7d7d",
       "RRRRRRRRRRRRRRRRRRRBRR",
       "RRRRRRRRRRRRRRRR~~BRRY",
       "RRBBBBBBBBBBBBX~~YBBYY",
       "RRBBBBBBBBBBBB~~YBBBYY",
       "RRBBBBBBBBBB~~~YBBBBYY",
       "RRBBBBBBBBX~~~YBBBBBYY",
       "RRBBBBBBBB~~~YBBBBBBYY",
       "RRBBBBBBX~~~~~~~~XYBYY",
       "RRBBBBX~~~~~~~~XYYBBYY",
       "RRBBBBBYYYY~~~XYBBBBYY",
       "RRBBBBBBX~~~XYYBBBBBYY",
       "RRBBBBBX~~XYYBBBBBBBYY",
       "RRBBBX~~~YYYBBBBBBBBYY",
       "RRBB~~~~~~~~~~~XYBBBYY",
       "RRX~~~~~~~~~~X+YBBBBYY",
       "RRBYYYY~~~~X+YBBBBBBYY",
       "RRBBBBB~~B@YBBBBBBBBYY",
       "RRBBBB~X@YYBBBBBBBBBYY",
       "RRBBB~B+YBBBBBBBBBBBYY",
       "RRBB~+YBBBBBBBBBBBBBYY",
       "RRY~YYYYYYYYYYYYYYYYYY",
       "RYYYYYYYYYYYYYYYYYYYYY"};

💅 APPLICATION USAGE 💅

For a description of icon location, usage, design, etc. within the CDE, refer to dticonfile(4). That’s the lore drop. 👑

🌈 SEE ALSO 🌈

that’s the whole dtpmfile(special file) page, bestie. The footer has no extra source/version/date info to report — just that manual-name vibe. Stay slay, keep your pixels iconic, and don’t let the mono visual catch you lacking. 💅✨

📦 where this page comes from