NAME

focus_target - Specify a frameserver the scheduler should try and bias

SYNOPSIS

nil
focus_target( vid:WORLDID )
focus_target( vid:fsrv )

DESCRIPTION

Some synchronisation strategies might rely on a focus target, some external process to bias in favor of. In such cases, the specific target has to be pointed out by the scripts themselves as the engine has no direct way of knowing which client has visual focus and so on. This function can be used to set such an object. Calling the function without any arguments or with WORLDID as argument will remove any existing bias focus. Should the frameserver expire, the bias will be removed implicitly.

NOTES

1

calling the function with a vid that is not tied to a frameserver is a terminal state transition.

EXAMPLE

function focus_target0()


      local vid =


            target_alloc("test", function(source, status)


            end);


      if (valid_vid(vid, TYPE_FRAMESERVER)) then


            focus_target(vid);


      end
end

SEE ALSO: