image_surface_initial(3)

📦
version 0.7.1 · 2 versions
, in nixos 26.05

💖 image_surface_initial(3) 💖

okay bestie, welcome to the Arcan Lua API — this one's all about peeking at a surface's original self before anyone messed with it. 🫶

✨ NAME ✨

image_surface_initial — retrieves a table describing the initial storage state for the object you point at. literally the "before" pic. 📸

🌸 SYNOPSIS 🌸

proptbl
image_surface_initial( vid )

🦋 DESCRIPTION 🦋

so here's the vibe check 👑 — the system lowkey keeps two separate timelines for your object: the transformations applied after it was created</>, and its initial state</> at the moment of creation. these are NOT the same thing, and that's the whole point.

this function grabs the values hanging out in that initial state and hands them back to you as a property table. that's it. that's the function. slay. 💅

🎀 EXAMPLE 🎀

fr fr, here's how you'd actually use it — load an image, resize the poor thing, then compare where it started vs. where it's at now:

function image_surface_initial0()
      a = load_image("test.png");
      resize_image(a, 32, 32);
      iprop = image_surface_initial(a);
      cprop = image_surface_properties(a);
      print(string.format("initial_w: %d, inital_h: %d, current_w: %d, current_h: %d",
            iprop.width, iprop.height, cprop.width, cprop.height));
end

the way this eats 🔥 — image_surface_initial gives you the cute original width/height, and image_surface_properties gives you the current ones. past self vs. present self, iconic duality. ✨

⭐ SEE ALSO ⭐

💀 reminder: those two are your besties for this — one resolves the surface, one tells you what it looks like now. don't mix up your timelines, iykyk.

k bye bestie!! 💜 this page is from the image manual, Arcan Lua API, dated October 2026 — go forth and inspect your surfaces responsibly 🧚🌸

📦 where this page comes from