pacify_target(3)

💅 pacify_target(3) — sever that frameserver link, bestie 💅

okay so you're on the pacify_target page from the Arcan Lua API, and this function is literally about cutting a frameserver connection loose from a video object. no cap. it's giving "cleanup era" and honestly kind of iconic. ✨

---

✨ NAME ✨

• pacify_target — sever frameserver connection from a video object

🌸 SYNOPSIS 🌸

nil
pacify_target( vid:src )
pacify_target( vid:src, bool:mask )

🦋 DESCRIPTION 🦋

By default, frameservers get freed when the associated video object is deleted. This behavior can be altered with this function in two different ways, bestie.

The first way? Convert the frameserver-tied object into a normal one. In that case, the client side is terminated, the event loop handler is detached, and nothing frameserver-related is gonna keep working — those functions cease to work, periodt.

The second way? Set the mask argument to false (default is true). This emulates a client initiated termination, triggering the 'terminated' event handler. It's lowkey useful for tricking the rest of your scripts into thinking the client exited normally, even if it did not. sneaky but valid 💅

🎀 NOTES 🎀

1. calling pacify_target on a vid that is not associated with an active frameserver is a terminal state transition. that's the note, bestie — don't gloss over it.

🔥 EXAMPLE 🔥

here's the example — it's got launch_avfeed, a "resized" check, and then the pacify moment:

       function pacify_target0()
             a = launch_avfeed("", "avfeed", function(source, status)
                   if (status.kind == "resized") then
                         show_image(source);
                         resize_image(source, status.width, status.height);
                         pacify_target(source);
                   end
             end);
       end

💀 MISUSE 💀

here's the misuse example — it's right there to show you what not to do, not a cute lil recipe:

       function pacify_target0()
             a = null_surface(64, 64);
             pacify_target(a);
       end

👑 SEE ALSO 👑

• targetcontrol

---

mwah 💋 — source: targetcontrol, date: October 2026, page: pacify_target(3). bye bestie 🫶