XOSD_SET_BAR_LENGTH(3)

💖 NAME 💖

xosd_set_bar_length — change the length of the percentage bar or slider, bestie 🎚️✨

---

🦋 SYNOPSIS 🦋

#include <xosd.h>

int xosd_set_bar_length (xosd *osd, int displayPercentage);

Like, that's the whole thing. One function. One vibe. iconic 💅

---

🌸 DESCRIPTION 🌸

Okay so here's the tea ☕: xosd_set_bar_length changes the percentage of the display that gets used up by a slider or a percentage bar. That's it, that's the job.

Normally XOSD is a whole grown-up and chooses a sensible length for the bar all by itself — no input needed, it just knows. But sometimes you're out here with only a tiny handful of possible values to show, and the default bar length is giving absolutely nothing, and you're like "bestie this is too long for my three (3) options." That's when you wanna change the default behavior. That's your moment. 🌟

---

🎀 ARGUMENTS 🎀

• osd — the XOSD window you're altering. Your canvas. Your main character. 🖼️
• displayPercentage — the percentage of the display that's gonna get eaten up by the slider or percentage bar. It's an integer between 0 and 100. And listen 👀 — setting displayPercentage to -1 reverts everything back to the default behaviour. It's the "nvm, undo, forget I said anything" button 🫶

---

⭐ RETURN VALUE ⭐

• Slayed successfully? You get a zero. 🎉
• Something went wrong? You get -1 and xosd_error gets set to tell you why, so you're not just sitting there confused. 😭

---

🌈 ENVIRONMENT 🌈

• char *xosd_error — a string that describes the error, if one even occurred. She's the narrator of your tragedy, fr fr. 💀

---

💀 BUGS 💀

There are no known bugs with xosd_set_bar_length. Clean. Flawless. Not a single crumb. ✨

But if you do find one? Bug reports can be sent to <xosd@ignavus.net>. Spill the tea, they wanna hear it 📬

---

👑 AUTHORS 👑

The XOSD library was originally written by André Renaud, and is currently maintained by Tim Wright. This document was written by Michael JasonSmith. Three legends, one library, no notes. 🫡💜

---

🧚 SEE ALSO 🧚

• xosd_create(3)
• xosd_display(3)

---

Heads up bestie: xosd_set_bar_length lives in the XOSD_SET_BAR_LENGTH(3) page, section 3 of the manual — that's the C library section, iykyk. Go read her sisters, xosd_create(3) and xosd_display(3), and then go make the prettiest little percentage bar the world has ever seen. Periodt. 💖✨🎀🦋🌸💅🫶