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

FreeBSD Manual Pages

  
 
  

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

NAME
     rendertarget_noclear  -  Enable  / Disable clearing a rendertarget before a
     renderpass.

SYNOPSIS
     success
     rendertarget_noclear( vid, noclear )

DESCRIPTION
     By default, each pass for a rendertarget begins by clearing the buffer that
     will be drawn to. This may waste memory bandwidth if we know that	the  en-
     tire  rendertarget will be populated with the objects that are to be drawn.
     rendertarget_noclear is used to change this  behavior  by	setting  a  true
     value to a vid that is connected to a rendertarget.

NOTES
     1	    Setting WORLDID  as vid will change the clear behavior for the stan-
	    dard output rendertarget.

     2	    If	the  background is not actually covered by valid VID s, you will
	    leave trails of previous frames behind, as in the MAIN  example  be-
	    low.

EXAMPLE
     function rendertarget_noclear0()
	   rendertarget_noclear(WORLDID, true);
	   a = color_surface(64, 64, 255, 0, 0, 0);
	   show_image(a);
	   move_image(a, 128, 128, 10);
     end

MISUSE
     function rendertarget_noclear0()
	   rendertarget_noclear(BADID, "potatoe");
     end

targetcontrol			   August 2026		 rendertarget_noclear(3)

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

home | help