NAME

target_updatehandler - Change the active callback for a VID connected to a frameserver.

SYNOPSIS

nil
target_updatehandler( vid, callback_function )

DESCRIPTION

Every frameserver can have one active Lua function as a callback. This callback receives events related to the associated frameserver. In some cases, one might want to update or replace the function associated with a specific frameserver connected VID , e.g. when adopting as part of a system collapse or fallback script.

NOTES

1: 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).

EXAMPLE

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

MISUSE