restore_target(3)

💅 restore_target(3)

okay so this is the restore_target(3) page from the Arcan Lua API, and bestie, it’s literally about asking a target frameserver session to restore itself from a snapshot you already made. main character restore energy, no cap. 🫶

✨ NAME ✨

restore_target — request that the target frameserver session restores from a previously made snapshot. 💖

🌸 SYNOPSIS 🌸

bool:exist
restore_target( vid:target, string:resource )
restore_target( .B )
restore_target( vid:target, string:resource, number:namespace )
restore_target( .B )
restore_target( vid:target, string:resource, number:namespace,
string:description )

🦋 DESCRIPTION 🦋

Lowkey the whole vibe: it opens resource from the APPL_STATE_RESOURCE and sends it to target, requesting that the target restores its state from the resource. It returns true if the resource was found and sent successfully. 🎀

If you pass another namespace from the normal set of read- resources, it will be opened read only and sent as a binary chunk. 👑

On a pasteboard this action is interpreted as a 'paste' if there is ongoing mouse-drag action on the parent segment; it will be interpreted as a drop. On a segment that announced bchunkstate it will be interpreted as an open operation. 🦋

If a description is provided, a short (~60ch) text type descriptor of the data can be amended. The convention is to treat this as a simplified MIME - type, with the application/ prefix being the default (and can thus be omitted). 💅

🎀 NOTES 🎀

1. The namespace is one of the set: SHARED_RESOURCE, APPL_RESOURCE, APPL_TEMP_RESOURCE. ⭐
2. It is possible that the target can re-open the descriptor in a write- mode depending on operating system and creative use of primitives. 😭

---

xoxo bestie, that’s the whole page — it’s from targetcontrol, dated October 2026, and it’s literally restore_target(3) 💖🫶