DTBMFILE(4)

🌸 dtbmfile — the special file page for X11 bitmap desktop icons 🌸

okay so this is the dtbmfile(special file) manual page, and it’s literally all about format of X11 bitmap format desktop icon files — bestie, we are in icon-file territory now. 🎀

💖 NAME 💖

format of X11 bitmap format desktop icon files — that’s the assignment, and yes, that’s the whole name. Icon file format main character energy. ✨

✨ SYNOPSIS ✨

the shape of this file is giving C preprocessor defines plus a byte array, and it looks exactly like this:

#define name_width width
#define name_height height
#define name_x_hot x
#define name_y_hot y
static unsigned char name_bits[] = {0xN,...}

🦋 DESCRIPTION 🦋

X Bitmap (XBM) files are used for monochrome icons in the CDE. XBM icons specify background and foreground color only — that’s the whole palette situation. They would be black and white on a black and white display. On a color display, they could be any two colors. And no, XBM files are not used exclusively for black and white icons, okay?

The CDE icon editor component can be used to create or modify a bitmap icon. A bitmap file is an ASCII file, but because the data is simply a binary representation of the icon, it is not realistic to edit this file by hand. X Bitmap files can be included directly in C source code, so the file data is in the form of a bitmap structure variable. The X version 11 bitmap file format is the only icon file format officially supported as part of the X Window System at this time. Periodt. 💅

💀 RETURN VALUE 💀

None. That’s it — no return value, no drama, just None. 💀

🌈 EXAMPLES 🌈

The following is an example of a bitmap file named julie.bm:

#define julie.bm_width 18
#define julie.bm_height 22
#define julie.bm_x_hot 0
#define julie.bm_y_hot 0
static char julie.bm_bits[] = {
   0xff, 0xff, 0x03, 0x81, 0xc3, 0x02,
   0xf1, 0x98, 0x03, 0x19, 0x18, 0x02,
   0x05, 0x59, 0x02, 0x07, 0xdb, 0x02,
   0x01, 0xdb, 0x02, 0x01, 0xdb, 0x02,
   0x01, 0xdb, 0x02, 0x01, 0xdf, 0x02,
   0x01, 0xff, 0x02, 0x01, 0xfe, 0x02,
   0x01, 0x7c, 0x02, 0x01, 0x38, 0x02,
   0x01, 0x38, 0x02, 0x01, 0x38, 0x02,
   0x01, 0x38, 0x02, 0x01, 0x3f, 0x02,
   0xe1, 0x33, 0x02, 0xb9, 0x31, 0x02,
   0xcf, 0x1c, 0x02, 0xff, 0xff, 0x03};

🎀 APPLICATION USAGE 🎀

For a description of icon location, usage, design, etc. within the CDE, refer to dticonfile(4) — go read that one too, bestie. 🫶

👑 SEE ALSO 👑

• X11WindowSystemdocumentation
• dtpmfile(4)
• dticonfile(4)
• dticon(1)

---

and that’s the whole page, bestie — footer energy is just dtbmfile(special file), so no extra source/version/date tea to spill 💖✨