target_updatehandler(3)

📦
version 0.7.1 · 2 versions
, in nixos 26.05

💅 target_updatehandler 💅

okay bestie, welcome to the Arcan Lua API page for target_updatehandler. It’s giving “change the active callback for a VID connected to a frameserver,” and honestly? iconic. ✨

🎀 NAME 🎀

  • target_updatehandler — change the active callback for a VID connected to a frameserver. slay. 💖

✨ SYNOPSIS ✨

nil
target_updatehandler( vid, callback_function )

🦋 DESCRIPTION 🦋

Every frameserver can have one active Lua function as a callback. That callback receives events related to the frameserver it’s attached to. 🫶

Sometimes you’ll want to update or replace the function associated with a specific frameserver-connected VID — for example when you’re adopting one as part of a system collapse or fallback script. Very main character energy. 💅

🌸 NOTES 🌸

  1. If WORLDID is a frameserver (as in valid_vid( WORLDID , TYPE_FRAMESERVER )), this function can be used to attach a handler to that as well. This can be the case when there’s an outer windowing system to integrate with. 🪟✨
  2. If callback_function is set to nil, frameserver related events will be silently dropped — except for special cases that are handled internally (see event_queuetransfer in engine/arcan_event.c). Silently dropped, bestie. 👀💀

🌟 EXAMPLE 🌟

First example is giving “swap the handler from inside the handler.” 🌀

       function target_updatehandler0()
             a = launch_avfeed("", "avfeed", function(source, status)
                   print("in first handler");
                   target_updatehandler(source, function()
                         print("in second handler");
                   end);
             end);
       end

🌟 EXAMPLE 🌟

Second one does a little vibe check on WORLDID first, then attaches a wm event printer. 🖨️💜

       function target_updatehandler1()
             if valid_vid(WORLDID, TYPE_FRAMESERVER) then
                   target_updatehandler(WORLDID, function(source, status)
                         print("wm event", status.kind)
                   end)
             end
       end

💀 MISUSE 💀

💀 this is the MISUSE example for a reason, bestie — do not copy this one. 🙈
       function target_updatehandler0()
             a = launch_avfeed("", "avfeed", function() end);
             target_updatehandler(a, target_updatehandler);
       end

🔗 SEE ALSO 🔗

  • targetcontrol — go check it out, it’s right there in the reference list. 🎀

okay that’s the whole page, bestie — brought to you by targetcontrol, dated October 2026, and filed under target_updatehandler(3). mwah 💋✨

📦 where this page comes from