sage(3)

🌸 sage(3) 🌸

okay bestie, welcome to the Library Functions Manual page for sage — yes, the manual name is literally that, it's giving very official 💅

---

✨ NAME ✨

sage — the SDL library for OpenGL extensions. that's it, that's the whole vibe 🦋

---

✨ DESCRIPTION ✨

first things first, you gotta include it like this:

#include <sage/sage.h>

so Sage is a small C library that hands OpenGL extensions to apps using SDL. and when I say it's got the extensions, I mean it was automatically generated straight from the glext.h header file on the OpenGL website. no cap, the Sage source package even ships with the Perl scripts you need to regenerate new sources from updated glext.h files. iconic behavior fr fr 👑

on top of all that, Sage gives you a way to get at the standard GL and GLU headers in a cross platform way. so instead of gl/GL.h and gl/GLU.h (or whatever the equivalent is on other platforms), you should be using sage/GL.h and sage/GLU.h. periodt 💅

okay so how do you actually use it? listen up:

1. Once your OpenGL context has been created, your application must call sage_init first. that's the rule, bestie, no skipping 🙈
2. sage_init checks whether each extension it knows about actually exists, and then links up the appropriate function pointers.
3. The array sage_ext gets set to 1 for each extension that's found, and 0 otherwise.
4. Applications should check whether the extension exists in sage_ext before using it. like, vibe check your extension first, pls 🎀

after that, you can just use the extensions by their name as defined in the spec. slay ✨

---

💀 BUGS 💀

ngl, there are some things you need to know:

• Sage does not check to see if the OpenGL context is valid. it just doesn't. be careful 🫶
• On some systems, the standard Open GL header causes problems with sage — specifically namespace conflicts. not the cute kind of drama 😭
• Apparently some broken GL implementations may report that an extension exists but not actually provide it. Sage will not detect this. so the extension says it's coming to the function but it's not coming to the function 💀

---

👑 AUTHOR 👑

Simon Goodall (simon (at) simongoodall.co.uk) — the main character who made all this happen 🌟

---

🌈 SEE ALSO 🌈

• sage_init(3)

---

and that's the whole page, bestie 🧚💖 this one's dated September 22, 2005, it comes from the sage(3) manual page, and it lives under the Library Functions Manual section — mwah, go forth and link your function pointers 💅🌸