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

FreeBSD Manual Pages

  
 
  

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

NAME
       image_resize_storage - resize the dimensions of the image backing store

SYNOPSIS
       nil
       image_resize_storage( vid:tgt, int:neww,	int:newh )
       image_resize_storage(	vid:tgt,    int:neww,	int:newh,   int:vieww,
       int:viewh, int:viewx, int:viewy )

DESCRIPTION
       This function is	indended for testing streaming transfers and for  ren-
       dertargets  where  one  may  need  to permanently or temporarily	change
       backing storage dimensions in order to save memory or deal with render-
       target resize without rebuilding	attachment chains. The longer argument
       form with vieww , viewh , viewx	and viewy  redefines the window	 coor-
       dinate	    system	 range	     from	0,0,neww,newh	    to
       viewx,viewy,viewx+vieww,viewy+viewh. This can be	used together with de-
       fine_linktarget	in order to have  two  different  views	 of  the  same
       pipeline.

NOTES
       1      There  is	 no guarantee that the change can be performed as some
	      platforms	may impose alignment and padding requirements.

       2      The underlying code-path is similar to the resized event	for  a
	      frameserver,  but	 without  the event being emitted. No alert is
	      raised if	the change could not be	performed due to  video	 hard-
	      ware issues or memory constraints.

EXAMPLE
       function	image_resize_storage0()
	     local surf	= alloc_surface(640, 480);
	     local props = image_storage_properties(surf);
	     print(props.width,	props.height);
	     image_resize_storage(surf,	320, 240);
	     props = image_storage_properties(surf);
	     print(props.width,	props.height);
       end

SEE ALSO:
image				  April	2025	       image_resize_storage(3)

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

home | help