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 ob-
     ject into a normal one. In that case the client  side  is	terminated,  the
     event  loop  handler  is detached and nothing frameserver related 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,  trig-
     gering 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			   August 2026			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+15.1.quarterly>

home | help