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
       another.

SYNOPSIS
       nil
       copy_surface_properties(	srcvid,	dstvid )

DESCRIPTION
       This function will first	resolve	the current surface properties of  sr-
       cvid   into world space and then	store the result in dstvid . This cov-
       ers position, orientation, opacity and scale.

NOTES
       1      The resolved properties will not be translated  into  the	 local
	      coordinate  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 ini-
	      tial width,height	of the source. This is solved  by  translating
	      the resolved 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				  April	2025	    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+14.3.quarterly>

home | help