S3D_PUSH_TEXTURES(3)

✨ S3D_PUSH_TEXTURES ✨

okay bestie, welcome to the s3d manual, section 3 — and today's main character is s3d_push_textures, aka the "push many textures" girlie 🎀 she's giving bulk efficiency energy and honestly? obsessed.

🌸 NAME 🌸

s3d_push_textures — push many textures 🦋

like. MANY. textures. at once. plural. a whole squad. 💅

✨ SYNOPSIS ✨

#include <s3d.h>

int s3d_push_textures(int object, const uint16_t *tbuf, uint16_t n);

that's it, that's the whole vibe check. one include, one function, three args, no cap. 🫶

💖 DESCRIPTION 💖

so here's the tea, bestie ☕ — same situation as with vertices, okay? if you've got a whole pile of textures to deal with, you can push arrays of textures onto the texture stack and get greater performance out of it. it's the "don't do it one at a time when you could do it all at once" pipeline, and she ATE. 🔥

and the way tbuf works? okay so listen closely 🙈 — tbuf should contain n texture sizes. and each one of those texture sizes is made up of 2 uint16_t values: one for the width and one for the height, for each texture. so it's like a lil width-height duo per texture, lined up one after another, and n tells her how many of those duos to expect. iconic structure, honestly. ⭐

so like: n textures in, n pairs of uint16_t out, everybody's sized, everybody's on the stack, everybody's thriving. 🌈

👑 AUTHOR 👑

Simon Wunderlich Author of s3d 💜

(he literally wrote s3d. king behaviour. we love to see it. 🎀)

and that's a wrap, bestie!! this page came to you straight from the s3d manual, section 3, S3D_PUSH_TEXTURES(3) — and ngl there's no date on this thing so she's simply timeless, an eternal queen, periodt. 💅✨🦋💖 go push some textures, ily, bye!! 🌸🫶⭐