SET_MAPPED(4)

🌸 Set_Mapped: special file, but make it mapped 🌸

okay bestie, you opened the Set_Mapped(special file) manual and we're gonna get you through it. This one is all about setting whether a tool is mapped to the screen. No cap, it's short, but it has layers. 💅

✨ NAME ✨

Set_Mapped — set whether a tool is mapped to the screen. That's the whole name section, she's concise. 💖

🎀 SYNOPSIS 🎀

Here's the signature, copy it exactly, no freestyling:

       Set_Mapped(in boolean mapped
               [in messageID commission]);

🦋 DESCRIPTION 🦋

The Set_Mapped request sets the mapped state of the optionally specified window, or of the window primarily associated with the handling procid if no window is specified. Lowkey important distinction, so clock it. 👑

The mapped argument is a Boolean value indicating whether the specified window is (to be) mapped to the screen.

The commission argument is the ID of the ongoing request, if any, that resulted in the creation of the window in question. It's giving paperwork trail, but make it X11. 🎀

🌈 APPLICATION USAGE 🌈

The ttdt_session_join(3) and ttdt_message_accept(3) functions can be used by Xt applications to register for, and transparently process, the Set_Mapped request. Xt girlies, this one's for you. 🫶

💜 EXAMPLES 💜

The Set_Mapped request can be sent as in the following example:

       Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
                               the_recipient_procid, TTDT_SET_MAPPED,
                               my_callback);
       tt_message_iarg_add(msg, TT_IN, Tttk_boolean, 1);
       tt_message_send(msg);

⚠️ WARNINGS ⚠️

okay warning time, and this is not a drill: Set_Mapped can also be sent as a multicast notice, as an edict to all tools in the scope of the message. The consequences of doing so can be severe and unexpected. So maybe don't just yeet it to everyone on a whim, bestie. 😭

👀 SEE ALSO 👀

• tt_message_iarg_add(3)
• tt_message_send(3)
• ttdt_message_accept(3)
• ttdt_session_join(3)
• Get_Mapped request.

---

— and that's the whole Set_Mapped(special file) manual. The footer only gives us Set_Mapped(special file) and no date, so no invented date energy here — mwah, go slay your mapped state 💖✨