Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pacify_target(3)		 Arcan Lua API		      pacify_target(3)

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 are freed when	the associated video object is
       deleted.	This behavior can be altered through the use of	this  function
       in  two	different  ways. One of	them is	by converting the frameserver-
       tied object into	a normal one. In that case the client side  is	termi-
       nated,  the  event loop handler is detached and nothing frameserver re-
       lated functions will cease to work. The other way  is  by  setting  the
       mask    argument	to false (default is true). This will emulate a	client
       initiated termination, triggering the 'terminated' event	handler.  This
       can  be useful to trick the rest	of your	scripts	that the client	exited
       normally, even if it did	not.

NOTES
       1      calling pacify_target on a vid that is not  associated  with  an
	      active frameserver is a terminal state transition.

EXAMPLE
       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
       function	pacify_target0()
	     a = null_surface(64, 64);
	     pacify_target(a);
       end

SEE ALSO:
targetcontrol			  April	2025		      pacify_target(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pacify_target&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help