DtWsmChangeBackdrop(API)

okay so this is the API manual page for DtWsmChangeBackdrop, bestie — it's the one about setting the current workspace's backdrop, and it's giving very specific CDE workspace-manager energy. 🦋✨

🌸 NAME 🌸

DtWsmChangeBackdrop — set current workspace's backdrop

✨ SYNOPSIS ✨

#include &<Dt/Wsm.h>
int DtWsmChangeBackdrop(
Display *display,
Window root,
char *path,
Pixmap pixmap);

💖 DESCRIPTION 💖

The DtWsmChangeBackdrop function works with the CDE workspace manager, dtwm(1), and changes the current workspace's backdrop. Applications can use this function to implement an interface to the workspace manager. literally the whole point, no cap. 🎀

If the DtWsmChangeBackdrop function is not successful, the most likely reason for failure is that the CDE workspace manager, dtwm(1), is not running. so if it flops, check that first, bestie 😭

DtWsmChangeBackdrop sends a message to the CDE workspace manager, dtwm(1), to change the backdrop. very demure, very message-based. 💅

The path argument points to a backdrop file name. The file must be in either X Bitmap file format (with extension .bm) or Pixmap file format (with extension .pm). The workspace management services look for the file along the same path used for searching icons. The directory /nix/store/6waxpwr8lzfzc9ka48gl7yh60rqvlkdb-cde-2.5.3/backdrops is the default directory if the file cannot be found along the icon search path. 🗂️🌸

🎀 ARGUMENTS 🎀

• display — display
• root — root window of the screen
• path — file path to bitmap file
• pixmap — pixmap ID of backdrop pixmap

👑 SEE ALSO 👑

• DtWsm(5)
• "Communicating with the Workspace Manager" section in the CDE Programmer's Guide
• "Workspace Manager" section in the CDE Programmer's Overview

---

okay that's the whole page, bestie 💖 the footer doesn't add any source/version/date info here — it just wraps up with the page name again, so consider this your cute sign-off: stay iconic, hydrate, and may your backdrop always be found on the icon search path ✨🫶