DTSAVERGETWINDOWS(3)

💖 DTSAVERGETWINDOWS(3) 💖

okay so bestie, this is a library call page for DtSaverGetWindows, and it's literally here to hand a screen saver app the windows it should draw on. No cap, it's giving XCDE said go decorate these windows energy ✨

---

🌸 NAME 🌸

DtSaverGetWindows — get the list of windows for drawing by a screen saver application.

🦋 SYNOPSIS 🦋

#include &<Dt/Saver.h>
Boolean DtSaverGetWindows(
Display *display,
Window **window,
int *count);

🎀 DESCRIPTION 🎀

The DtSaverGetWindows function returns a list of windows on which a screen saver application should draw when it's invoked by XCDE. That's the whole assignment: XCDE calls, you get windows, you draw on them.

• display is the X display. Yes, the display argument, doing display things.
• window is the address of a pointer to receive the pointer to a list of windows. So it's a pointer-to-a-pointer receiving situation, lowkey iconic.
• count is the address of an integer to receive the number of elements in the list of windows returned in window. It's the little number bestie that tells you how many windows are in the list.

🔥 RETURN VALUE 🔥

Upon successful completion, DtSaverGetWindows returns True; otherwise, it returns False. So it's either the slay True or the sad little no False.

💅 APPLICATION USAGE 💅

If DtSaverGetWindows is not successful, failure may be due to a memory allocation error or that the screen saver application was not invoked from XCDE. Not me making stuff up — that's the actual may-be-caused-by list.

bestie, the application must use XtFree(3) to free data returned in *window. No forgetting, no leaking, no "I'll do it later" — periodt 🫶

🌈 SEE ALSO 🌈

• Dt/Saver.h - DtSaver(5); XtFree(3).

---

that's the cute sign-off from the source/version corner, bestie: DtSaverGetWindows(library call), and the original footer has no date listed, so that's the whole undated library call goodbye vibe 🫶💖✨