cursor_setstorage(3)

💖 cursor_setstorage(3) 💖

okay bestie, this is the Arcan Lua API page for cursor_setstorage, and she is lowkey the cursor-storage queen. no cap, we’re keeping every tiny detail. 🖱️✨

✨ NAME ✨

cursor_setstorage — use the storage defined by one video object as an accelerated mouse cursor. literally that’s the vibe. 💅

📜 SYNOPSIS 📜

the synopsis is exactly this, no edits:

nil
cursor_setstorage( vid, txcos )

🌸 DESCRIPTION 🌸

okay so cursor_setstorage works like image_sharestorage, except the target destination is the accelerated overlay cursor render path — that’s the whole point, bestie. ✨

The optional txcos argument should (if present) be an integer indexed table with exactly 8 elements where each element (n) is 0 <= n <= 1 specifying [ul_x, ul_y, ur_x, ur_y, lr_x, lr_y, ll_x, ll_y]. yes, exactly eight, not seven, not nine, do not play with me. 🙈

This can be used as a cheaper way of animating cursors or packing many cursors in the same vid. queued, packed, slayed. 💖

⚠️ NOTES ⚠️

1. using cursor_setstorage( WORLDID ) will disable the accelerated cursor path. that’s the note, and it’s important, so read it twice. 😭

🎀 EXAMPLE 🎀

okay example time, copy-paste energy fr fr:

function cursor_setstorage0()
      curs = fill_surface(8, 8, 255, 0, 0);
      cursor_setstorage(curs);
      resize_cursor(16, 16);
      move_cursor(VRESW * 0.5, VRESH * 0.5);
end

🦋 SEE ALSO 🦋

• cursor_position(3)
• nudge_cursor(3)
• resize_cursor(3)
• move_cursor(3)

and that’s the whole page, bestie. source/version tag: image; date: October 2026; title: cursor_setstorage(3). stay slay 🫶💖