image_resize_storage(3)

hey bestie 💖 you're reading image_resize_storage(3) from the Arcan Lua API, and it's literally the page for resizing the dimensions of the image backing store. Group-chat recap time, but make it precise. ✨

---

🌸 NAME 🌸

image_resize_storage — resize the dimensions of the image backing store.

✨ SYNOPSIS ✨

It returns nil, and the signatures are:

nil
image_resize_storage( vid:tgt, int:neww, int:newh )
image_resize_storage( vid:tgt, int:neww, int:newh, int:vieww, int:viewh,
int:viewx, int:viewy )

🦋 DESCRIPTION 🦋

So this function is intended for testing streaming transfers and for rendertargets where you may need to permanently or temporarily change backing storage dimensions — both to save memory and to deal with rendertarget resize without rebuilding attachment chains. Iconic use case, honestly. 💅

The longer argument form, with vieww, viewh, viewx, and viewy, redefines the window coordinate system range from 0,0,neww,newh to viewx,viewy,viewx+vieww,viewy+viewh. Literally that. This can be used together with define_linktarget in order to have two different views of the same pipeline. Two views, one pipeline — main character energy. 🫶

🎀 NOTES 🎀

1. There is no guarantee that the change can be performed, because some platforms may impose alignment and padding requirements. Vibe check your platform, bestie. 😭
2. The underlying code-path is similar to the resized event for a frameserver, but without the event being emitted. No alert is raised if the change could not be performed due to video hardware issues or memory constraints. Silent-fail energy — not the cute kind. 💀

🌈 EXAMPLE 🌈

No cap, here's the example exactly as it is:

function image_resize_storage0()
      local surf = alloc_surface(640, 480);
      local props = image_storage_properties(surf);
      print(props.width, props.height);
      image_resize_storage(surf, 320, 240);
      props = image_storage_properties(surf);
      print(props.width, props.height);
end

🫶 SEE ALSO: 🫶

• image

---

mwah 💋 this page is from the image source/version, dated October 2026, and it's image_resize_storage(3) signing off — slay responsibly! 💅✨