image_set_txcos_default(3)

📦
version 0.7.1 · 2 versions
, in nixos 26.05

🦋 image_set_txcos_default(3) — Arcan Lua API 🦋

okay so bestie, welcome to the glow-up era of your texture coordinates ✨ this one lives in the Arcan Lua API and it's literally the "undo" button for your vibes.

✨ NAME ✨

image_set_txcos_default — revert to the default set of texture mapping coordinates 🎀

🌸 SYNOPSIS 🌸

nil
image_set_txcos_default( vid, mirror )

💜 DESCRIPTION 💜

So here's the tea 🍓 — the engine, by default, manages texture coordinates for video objects. That's just the baseline, main character behaviour, no cap.

But in some rare instances 👀 the developer may want to hand-tune these in the pre-rendering stages rather than modifying the coordinates in a shader. Very DIY, very custom, we respect it.

And when you're done being artsy and want to revert back to the default behavior? That's exactly what this function is for, bestie. Iconic. 🫶

Now the important bit — if mirror is set to a non-zero integer, the mapping generate will be flipped along the Y axis 😭 to compensate for the arcan coordinate system having origo in the upper left corner, whileas Open GL uses the lower left. Yeah. Two different coordinate systems. It's giving enemies to lovers fr fr 💀

lowkey crucial: it's non-zero that flips it — zero (or nothing) keeps things unflipped 🌈

🧚 EXAMPLE 🧚

function image_set_txcos_default0()
      a = random_surface(64, 64);
      b = null_suface(32, 32);
      image_set_txcos(a, {0.1, 0.5, 0.2, 0.4, 0.8, 0.2, 0.6, 0.7});
      show_image({a, b});
      image_sharestorage(a, b);
      image_set_txcos_default(b);
end

like look at her go 👑 she sets some custom coords on a, shares the storage over to b, and then snaps b right back to the defaults. clean. periodt. 💅

🔥 SEE ALSO 🔥

and that's the whole vibe bestie 🌈 this page came from the image manual, dated October 2026, and it's image_set_txcos_default(3) all the way down 💖 go forth and flip your Y axis responsibly 🎀✨🦋

📦 where this page comes from