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

FreeBSD Manual Pages

  
 
  

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

NAME
     copy_surface_properties  -  Copy key surface properties from one VID to an-
     other.

SYNOPSIS
     nil
     copy_surface_properties( srcvid, dstvid )

DESCRIPTION
     This function will first resolve the current surface properties of srcvid
     into  world  space  and then store the result in dstvid . This covers posi-
     tion, orientation, opacity and scale.

NOTES
     1	    The resolved properties will not be translated into the local  coor-
	    dinate space of dstvid , thus the results may be undesired if dstvid
	     has its dimensions linked relative to another object than worldid.

     2	    Scale  is  treated	differently due to its relation with the initial
	    width,height of the source. This is solved by  translating	the  re-
	    solved dimension into a scale factor.

     3	    The  rotation  transfer does not take any rotation origo offset into
	    account.

     4	    Using the same object for src and for dst is prohibited.

EXAMPLE
     function copy_surface_properties0()
	   a = fill_surface(64, 64, 255, 0, 0);
	   blend_image(a, 0.5);
	   move_image(a, 100, 100);
	   rotate_image(a, 300);
	   resize_image(a, 128, 128);
	   b = fill_surface(16, 16, 0, 255, 0);
	   copy_surface_properties(a, b);
	   move_image(a, 0, 0);
     end

MISUSE
     function copy_surface_properties0()
	   a = fill_surface(32, 32, 255, 0, 0);
	   copy_surface_properties(a, a);
     end

MISUSE
     function copy_surface_properties1()
	   copy_surface_properties(nil, 1);
     end

SEE ALSO:
     copy_image_transform(3)

image				   August 2026	      copy_surface_properties(3)

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

home | help